手动创建和配置代理 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

手动创建和配置代理

要使用 Amazon Bedrock 创建代理，您需要设置以下组件：

  • 代理的配置，用于定义代理的用途，并指明代理用来生成提示和响应的基础模型（FM）。

  • 至少以下配置之一：

    • 操作组，定义代理要执行的操作。

    • 数据来源知识库，通过支持搜索和查询来增强代理的生成式功能。

您可以创建只有名称的最低配置的代理。要准备代理以便进行测试或部署，您必须至少配置以下组件：

配置 描述
代理资源角色 有权ARN在代理上调用API操作的服务角色的
基础模型（FM） 供代理调用以执行编排的 FM
说明 描述代理应该做什么以及应该如何与用户交互的自然语言

您还应为代理配置至少一个操作组或知识库。如果您准备的代理没有操作组或知识库，它将仅根据 FM、指令和基本提示模板返回响应。

要了解如何创建代理，请选择首选方法的选项卡，然后按照以下步骤操作：

Console
创建代理

  1. AWS Management Console 使用具有 Amazon Bedrock 权限的IAM角色登录，然后通过以下网址打开 Amazon Bedrock 控制台。https://console.aws.amazon.com/bedrock/

  2. 从左侧导航窗格中选择代理。

  3. 在代理部分，选择创建代理。

  4. （可选）更改自动生成的代理名称，并为其提供可选的描述。

  5. 选择创建。代理已经创建，您将进入新创建的代理的代理生成器，在其中配置代理。

  6. 您可以继续执行以下步骤来配置代理，也可以稍后返回代理生成器。

配置代理

  1. 如果您尚未进入代理生成器，请执行以下操作：

    1. AWS Management Console 使用具有 Amazon Bedrock 权限的IAM角色登录，然后通过以下网址打开 Amazon Bedrock 控制台。https://console.aws.amazon.com/bedrock/

    2. 从左侧导航窗格中选择代理。然后，在代理部分选择一个代理。

    3. 选择在代理生成器中编辑。

  2. 在代理详细信息部分，您可以设置以下配置：

    1. 编辑代理名称或代理描述。

    2. 对于代理资源角色，选择以下选项之一：

      • 创建和使用新服务角色 – 让 Amazon Bedrock 代表您创建服务角色并设置所需的权限。

      • 使用现有服务角色 – 使用您之前设置的自定义角色。

    3. 对于选择模型，选择一个 FM 供代理在编排期间调用。

      默认情况下，系统会显示针对代理进行了优化的模型。要查看 Amazon Bedrock 代理支持的所有模型，请清除已优化的 Bedrock 代理。

      您可以使用任意基础模型创建代理。目前，提供的模型中有一些已经过优化，其提示/解析器经过微调，可与代理架构集成。随着时间的推移，我们计划对所有提供的模型进行优化。

    4. 在对代理的指令中，输入详细信息以告知代理应该做什么以及应该如何与用户交互。这些指令将取代编排提示模板中的 $instructions$ 占位符。下面是一个指令示例：

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. 如果展开其他设置，您可以修改以下配置：

      • 代码解释器：（可选）选择是否启用代理来处理涉及编写、运行、测试代码和排查代码故障排除的任务。有关详细信息，请参阅 使用代码解释生成、运行和测试代码。

      • 用户输入：（可选）选择是否允许代理在信息不足时向用户请求更多信息。有关详细信息，请参阅将代理配置为向用户请求信息。

      • KMS密钥选择-（可选）默认情况下，AWS使用AWS托管密钥加密代理资源。要使用您自己的客户管理的密钥加密您的代理，请在KMS密钥选择部分中选择自定义加密设置（高级）。要创建新密钥，请选择创建AWSKMS密钥，然后刷新此窗口。要使用现有密钥，请为 “选择密钥” 选择一个AWSKMS密钥。

      • 空闲会话超时：默认情况下，如果用户在与 Amazon Bedrock 代理的会话中 30 分钟未回应，代理将不再维护对话历史记录。对话历史记录既可用于恢复交互，也可用于根据对话的上下文来增强回应。要更改默认时间长度，请在会话超时字段中输入一个数字，然后选择一个时间单位。

    6. 在IAM权限部分，对于代理资源角色，选择一个服务角色。要让 Amazon Bedrock 代表您创建服务角色，请选择创建和使用新服务角色。要使用您之前创建的自定义角色，请选择使用现有服务角色。

      注意

      Amazon Bedrock 为您创建的服务角色不具备使用预览版功能的权限。要使用这些功能，请为服务角色附加正确的权限。

    7. （可选）默认情况下， AWS 使用加密代理资源。 AWS 托管式密钥要使用您自己的客户管理的密钥加密您的代理，请在KMS密钥选择部分中选择自定义加密设置（高级）。要创建新密钥，请选择创建 AWS KMS 密钥，然后刷新此窗口。要使用现有密钥，请为 “选择密钥” 选择一个 AWS KMS 密钥。

    8. （可选）要将标签与此代理关联，请在标签 - 可选部分选择添加新标签，并提供键值对。

    9. 完成代理配置设置后，选择下一步。

  3. 在操作组部分，您可以选择添加为代理添加操作组。有关设置操作组的更多信息，请参阅 使用操作组定义代理要执行的操作。要了解如何将操作组添加到代理，请参阅 在 Amazon Bedrock 中向代理添加操作组。

  4. 在知识库部分，您可以选择添加，将知识组与代理关联。有关设置知识库的更多信息，请参阅 使用 Amazon Bedrock 知识库检索数据并生成 AI 响应。要了解如何将知识库与代理关联，请参阅 利用知识库来增强代理的响应生成能力。

  5. 在防护机制详细信息部分，您可以选择编辑将防护机制与代理关联，以阻止和筛选有害内容。从选择防护机制下的下拉菜单中选择要使用的防护机制，然后在防护机制版本下选择要使用的版本。您可以选择查看来查看防护机制设置。有关更多信息，请参阅 使用 Amazon Bedrock 防护机制阻止模型中的有害内容。

  6. 在 “编排策略” 部分，您可以选择 “编辑” 来自定义代理的编排。有关可用于代理的编排策略的更多信息，请参阅自定义代理编排策略。

  7. 在 “多代理协作” 部分中，您可以选择 “编辑” 来创建多代理协作团队。有关多代理协作的更多信息，请参阅与 Amazon Bedrock Agents 使用多代理协作 。

  8. 完成代理配置后，选择以下选项之一：

    • 要留在代理生成器中，请选择保存。然后，您可以准备代理，以便在测试窗口中使用更新后的配置对其进行测试。要了解如何测试代理，请参阅 测试代理行为并进行问题排查。

    • 要返回代理详细信息页面，请选择保存并退出。

API

要创建代理，请发送 CreateAgent使用 Amazon Bedrock 代理构建时终端节点请求（有关请求和响应格式以及字段详情，请参阅链接）。

参阅代码示例

要准备代理并对其进行测试或部署，以便对其进行测试或部署，您必须至少包含以下字段（如果您愿意，可以跳过这些配置，稍后再通过发送 UpdateAgent请求）：

字段 应用场景
agentResourceRoleArn 指定具有ARN调用代理API操作权限的服务角色
foundationModel 指定代理执行编排时使用的基础模型（FM）
instruction 提供指令告诉代理该做什么。在编排提示模板的 $instructions$ 占位符中使用。

以下字段是可选字段：

字段 应用场景
description 描述代理的用途
idleSessionTTLInSeconds 代理结束会话并删除所有存储信息的持续时间。
customerEncryptionKeyArn ARN加密代理资源的密KMS钥
tags 将标签与代理关联。
promptOverrideConfiguration 自定义在编排的每个步骤向 FM 发送的提示。
guardrailConfiguration 为代理添加防护机制。指定护栏ARN的 ID 或，以及要使用的版本。
clientToken 确保API请求只完成一次。有关更多信息，请参阅确保幂等性。
cachingState 启用对代理输入的即时缓存。有关更多信息，请参阅 提示缓存以加快模型推断速度。

响应返回一个 CreateAgent对象，其中包含有关您新创建的代理的详细信息。如果您的代理创建失败，CreateAgent响应中的对象会返回一个列表failureReasons和一个列表recommendedActions供您进行故障排除。