Troubleshooting AWS Bedrock Agent Action Group Creation Failure with Claude 3.5 Sonnet - Tool Name Validation Error

Symptoms

Action group creation fails with a tool name validation error when using Claude 3.5 Sonnet.

Environment

AWS Bedrock environment with access to Claude 3.5 Sonnet.

Most Likely Causes

The tool name provided during the action group creation does not meet the required naming conventions or is already in use.

What to Check First

1. Verify the tool name format against AWS Bedrock naming conventions.
2. Check if the tool name is already in use within the AWS account.

Fix Steps

1. Check the tool name format and uniqueness.

   Ensure the tool name adheres to AWS Bedrock naming conventions and is not already in use.

   Safe to run: read-only

   aws bedrock list-tools --region <your-region>

2. Create a new action group with a valid tool name.

   Use a unique tool name that follows the naming conventions to create the action group.

   Safe to run: read-only

   aws bedrock create-action-group --name <unique-tool-name> --region <your-region> --tool-name <valid-tool-name>

Validation

• Confirm that the action group appears in the list of action groups using 'aws bedrock list-action-groups --region <your-region>'.
• Test the functionality of the newly created action group.

Logs to Check

• CloudTrail logs for any denied actions related to tool name validation.
• AWS Bedrock service logs for specific error messages during action group creation.

Rollback and Escalation

• Delete the action group if it was created with a problematic tool name.

Escalate When

• If the issue persists after verifying tool name format and uniqueness, escalate to AWS support with detailed error logs.

Edge Cases

• If the tool name contains special characters or spaces, it may trigger validation errors.

Notes from the Field

• Ensure that all team members are aware of the naming conventions to avoid future issues.
• Document any specific tool names that have caused validation errors for reference.