Manage your agent - Amazon Bedrock

Manage your agent

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

To edit the agent configuration
  1. Choose an agent in the Agents section.

  2. Select Edit in the Agent overview section.

  3. Edit the existing fields as necessary.

  4. Select Save changes. A green success banner appears at the top.

    Note

    If you change the foundation model, all the prompt templates will be set to default for that model. For more information, see Advanced prompts.

You might want to try different foundation models for your agent or change the instructions for the agent. These changes apply only to the working draft.

To change the foundation model that your agent uses or the instructions to the agent.
  1. Choose an agent in the Agents section.

  2. Select View in the Working draft section or choose the working draft.

  3. In the Model details section, select Edit

  4. Edit the fields as necessary. You can configure advanced points in this section. For more information about advanced prompts, see Advanced prompts.

  5. Select Save to remain in the same window. A green success banner appears at the top.

  6. Test the updated agent in the right panel and make changes as necessary.

  7. Select Save and exit to return to the working draft page.

Manage the action groups of an agent

After creating an agent, you can add more action groups or edit them. Adding and editing take place within the working draft. To carry out these operations, choose an agent from the Agents section and then choose the Working draft in the Working Draft section.

To add an action group
  1. Select Add in the Action groups section.

  2. Fill out the action group details

  3. To define the schema for the action group with the in-line OpenAPI schema editor, carry out the following actions. For more information about API schemas for your action group, see Action group OpenAPI schemas.

    1. Choose Define with in-line OpenAPI schema editor under Select API schema. A sample schema appears that you can edit.

    2. Select the format for the schema by using the dropdown menu next to Format.

    3. To import an existing schema from S3 to edit, select Import schema, provide the S3 URI, and select Import.

    4. To restore the schema to the original sample schema, select Reset and then confirm the message that appears by selecting Reset again.

  4. Select Add. A green success banner appears if there are no issues. If there are issues validating the schema, a red banner appears. The following issues are identified by the validation process.

    • Scroll through the schema to see the lines where an error or warning about formatting exists. An X indicates a formatting error, while an exclamation mark indicates a warning about formatting.

    • Select View details in the red banner to see a list of errors about the content of the API schema.

  5. Select Prepare to apply the changes that you have made to the agent before testing it.

To edit an action group
  1. Do one of the following:

    • Choose the radio button next to the action group to edit and select Edit.

    • Select an action group to see its details. Choose Edit at the top.

  2. Edit the existing fields as necessary.

  3. To define the schema for the action group with the in-line OpenAPI schema editor, carry out the following actions.

    1. Choose Define with in-line OpenAPI schema editor under Select API schema. A sample schema appears that you can edit.

    2. Select the format for the schema by using the dropdown menu next to Format.

    3. To import an existing schema from S3 to edit, select Import schema, provide the S3 URI, and select Import.

    4. To restore the schema to the original sample schema, select Reset and then confirm the message that appears by selecting Reset again.

  4. Select Save to remain in the same window. A green success banner appears if there are no issues.

  5. If there are issues validating the schema, a red banner appears. Scroll through the schema to see the lines where an error or warning exists. Select the gear icon or View details at the top of the page to see a list of errors.

  6. Test the updated agent in the right panel and make changes as necessary.

  7. Select Save and exit to return to the working draft page.

  8. Select Prepare to apply the changes that you have made to the agent before testing it.

To delete an action group
  1. In the Amazon Bedrock console, select Agents from the left navigation pane.

  2. Select the working draft from the Working draft section.

  3. In the Action groups section, select the radio button next to the action group to delete.

  4. A modal appears warning you about the consequences of deletion. Enter delete in the input box to confirm the message and select Delete to confirm.

  5. A blue banner appears to inform you that the action group is being deleted. When deletion is complete, a green success banner appears.

  6. Select Prepare to apply the changes that you have made to the agent before testing it.

Manage the knowledge bases of an agent

After creating an agent, you can add more knowledge bases or edit them. Adding and editing take place within the working draft. To carry out these operations, choose an agent from the Agents section and then choose the Working draft in the Working Draft section.

To add a knowledge base
  1. Select Add in the Knowledge bases section.

  2. Choose a knowledge base that you have created and provide instructions for how the agent should interact with it.

  3. Select Add. A green success banner appears at the top.

  4. Select Prepare to apply the changes that you have made to the agent before testing it.

To edit a knowledge base
  1. Select a knowledge base.

  2. In the knowledge base details page, select Edit

  3. Edit the existing fields as necessary.

  4. Select Save to remain in the same window. A green success banner appears if there are no issues and a red banner appears if there are errors in the edit.

  5. Test the updated agent in the right panel and make changes as necessary.

  6. Select Save and exit to return to the working draft page.

  7. Select Prepare to apply the changes that you have made to the agent before testing it.

To delete a knowledge base
  1. Select the radio button next to the knowledge base to delete.

  2. Select Delete.

  3. Select Prepare to apply the changes that you have made to the agent before testing it.

Delete an agent

To delete an agent
  1. In the Amazon Bedrock console, select Agents from the left navigation pane.

  2. Select the radio button next to the agent to delete.

  3. A modal appears warning you about the consequences of deletion. Enter delete in the input box and select Delete to confirm.

  4. A blue banner appears to inform you that the agent is being deleted. When deletion is complete, a green success banner appears.