Modify an agent

Focus mode

Modify an agent - Amazon Bedrock

After you create an agent, you can update its configuration as required. The configuration applies to the working draft.

To learn how to modify an agent, choose the tab for your preferred method, and then follow the steps:

Console

To edit an agent's configuration or its components

Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.
Select Agents from the left navigation pane. Then, choose an agent in the Agents section.
Choose Edit in Agent Builder
Edit the existing information in the Agent details section, or choose Add, Edit, or Delete in any of the other subsections and modify as necessary. To edit an action group or knowledge base, select it in the respective section. For more information about the components of the agent that you can edit, see Create and configure agent manually.

Note
If you change the foundation model, any prompt templates that you modified will be set to default for that model.
When you're done editing the information, choose Save to remain in the same window or Save and exit to return to the agent details page. A success banner appears at the top. To apply the new configurations to your agent, select Prepare in the test window.

To edit the tags associated with an agent

Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.
Select Agents from the left navigation pane. Then, choose an agent in the Agents section.
Choose an agent in the Agents section.
In the Tags section, choose Manage tags.
To add a tag, choose Add new tag. Then enter a Key and optionally enter a Value. To remove a tag, choose Remove. For more information, see Tagging Amazon Bedrock resources.
When you're done editing tags, choose Submit.

API

To modify an agent, send an UpdateAgent request with an Agents for Amazon Bedrock build-time endpoint. Because all fields will be overwritten, include both fields that you want to update as well as fields that you want to keep the same. For more information about required and optional fields, see Create and configure agent manually.

To apply the changes to the working draft, send a PrepareAgent request with an Agents for Amazon Bedrock build-time endpoint. Include the agentId in the request. The changes apply to the DRAFT version, which the TSTALIASID alias points to.

To add tags to an agent, send a TagResource request with an Agents for Amazon Bedrock build-time endpoint and include the Amazon Resource Name (ARN) of the agent. The request body contains a tags field, which is an object containing a key-value pair that you specify for each tag.

To remove tags from an agent, send an UntagResource request with an Agents for Amazon Bedrock build-time endpoint and include the Amazon Resource Name (ARN) of the agent. The tagKeys request parameter is a list containing the keys for the tags that you want to remove.

(Optional) To enable prompt caching, add the promptCachingState object to the promptOverrideConfiguration, and set the cachingState field to ENABLED. For more information about prompt caching, see Prompt caching for faster model inference.

Note

Amazon Bedrock prompt caching is currently only available to a select number of customers. To learn more about participating in the preview, see Amazon Bedrock prompt caching.

anchor anchor

To edit an agent's configuration or its components

Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.
Select Agents from the left navigation pane. Then, choose an agent in the Agents section.
Choose Edit in Agent Builder
Edit the existing information in the Agent details section, or choose Add, Edit, or Delete in any of the other subsections and modify as necessary. To edit an action group or knowledge base, select it in the respective section. For more information about the components of the agent that you can edit, see Create and configure agent manually.

Note
If you change the foundation model, any prompt templates that you modified will be set to default for that model.
When you're done editing the information, choose Save to remain in the same window or Save and exit to return to the agent details page. A success banner appears at the top. To apply the new configurations to your agent, select Prepare in the test window.

To edit the tags associated with an agent

Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.
Select Agents from the left navigation pane. Then, choose an agent in the Agents section.
Choose an agent in the Agents section.
In the Tags section, choose Manage tags.
To add a tag, choose Add new tag. Then enter a Key and optionally enter a Value. To remove a tag, choose Remove. For more information, see Tagging Amazon Bedrock resources.
When you're done editing tags, choose Submit.