Struct UseAwsTool 

pub struct UseAwsTool { /* private fields */ }

Tool for making AWS API calls using SigV4 signing.

This tool provides a universal interface to AWS services, allowing agents to invoke any AWS API operation dynamically. It supports:

• All AWS services accessible via JSON-based APIs
• Multiple credential sources (environment, profiles, IAM roles, SSO)
• SigV4 request signing for authentication
• Automatic region-specific endpoint resolution
• Extensible service target prefix configuration

Construction

This tool requires async initialization due to AWS credential loading. Use UseAwsTool::new().await or UseAwsTool::builder()...build().await.

Note: Unlike other tools in this crate, UseAwsTool does not implement Default because it requires async credential loading. Attempting to use an uninitialized tool will result in credential errors.

Safety

Operations that match mutative prefixes (Create, Delete, Update, etc.) will include a warning in the output. The calling application should implement appropriate confirmation mechanisms.

Implementations

impl UseAwsTool

pub async fn new() -> Result<Self, ToolError>

Create a new UseAwsTool with default configuration.

This loads credentials from the default AWS credential chain:

1. Environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
2. Shared credentials file (~/.aws/credentials)
3. IAM instance profile (on EC2)
4. Container credentials (in ECS/Fargate)
5. SSO credentials (if configured)

Errors

Returns an error if no AWS credentials are found.

pub fn builder() -> UseAwsToolBuilder

Create a builder for custom configuration.

Trait Implementations

impl Tool for UseAwsTool

type Input = UseAwsInput

The input type for this tool. Must implement Deserialize and JsonSchema.

fn name(&self) -> &str

The name of the tool (e.g., “read_file”, “calculator”)

fn description(&self) -> &str

A description of what the tool does

async fn execute(&self, input: Self::Input) -> Result<ToolResult, ToolError>

Execute the tool with typed input

fn format_output_plain(&self, result: &ToolResult) -> String

Format tool output as plain text.

fn format_output_ansi(&self, result: &ToolResult) -> String

Format tool output with ANSI colors.

fn format_output_markdown(&self, result: &ToolResult) -> String

Format tool output as Markdown.

fn input_schema(&self) -> Value

Get the JSON schema for this tool’s input.

fn format_input_plain(&self, params: &Value) -> String

Format tool input as plain text (for JIRA, logs, copy/paste).

fn format_input_ansi(&self, params: &Value) -> String

Format tool input with ANSI colors (for terminal display).

fn format_input_markdown(&self, params: &Value) -> String

Format tool input as Markdown (for docs, GitHub, rendered UIs).