创建多代理协作 - Amazon Bedrock

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

创建多代理协作

注意

Amazon Bedrock 的多代理协作功能处于预览版,可能会发生变化。

创建多代理协作包括以下步骤:

  1. 创建和部署协作者代理。确保将每个协作者代理配置为在多代理协作工作流程中实施特定任务。

  2. 创建新的主管代理或为现有代理分配主管的角色。在创建新的主管代理或将现有代理标识为主管代理时,您还可以指定您希望主管代理如何处理多个合作者代理之间的信息。

    您可以将协调协作代理响应的任务分配给主管代理,也可以为主管代理分配将信息传递给相应的协作者代理以发送最终响应的任务。为主管代理分配路由信息的任务可以减少延迟。

  3. 将协作者代理的别名版本与主管代理相关联。

    注意

    此时,您最多可以将 10 个合作者代理与主管代理关联。

  4. 准备并测试您的多代理协作团队。

  5. 部署和调用主管代理。

您可以在 Amazon Bedrock 控制台中使用、使用 CL AWS I 或使用软件开发工具包创建多代理协作。 APIs AWS 要了解如何创建多代理协作,请选择首选方法的选项卡,然后按照以下步骤操作:。

Console
步骤 1:创建协作者代理
步骤 2:创建新的主管代理或为现有代理分配主管角色
  1. 如果您要创建新的主管代理,请按照说明进行操作,手动创建和配置代理然后继续下一步。

    如果您已经配置了代理并希望为该代理分配主管角色,请继续下一步。

  2. 如果您尚未进入代理生成器,请执行以下操作:

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

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

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

    4. 代理生成器中,向下滚动到多代理协作部分,然后选择编辑

  3. 多代理协作页面的协作状态部分,打开多代理协作。这会将代理标识为主管代理。

  4. 协作配置部分,选择您希望主管代理如何处理多个协作者代理之间的信息,以协调最终响应。

    1. 如果您希望主管代理协调合作者代理的回复,请选择主管

    2. 如果您希望主管代理将信息路由到相应的协作者代理以发送最终响应,请选择带路由的主管

    3. 继续执行后续步骤以添加合作者代理。

步骤 3:添加合作者代理
  1. 展开代理协作者部分,并提供您为多代理协作创建的协作者代理的详细信息。

    1. 对于合作者代理,请从下拉列表中选择合作者代理和代理别名。您可以选择 “查看” 以查看协作者代理的详细信息。

    2. 合作者姓名中,输入合作者代理的备用名。此名称不会取代该代理的原始名称。

    3. 协作说明中,输入主管代理何时应使用该协作者的详细信息。

    4. (可选)如果您希望主管代理与该合作者代理共享以前对话的背景,请启用 “启用对话历史记录”。如果开启此功能,主管将包括当前会话的完整历史记录,包括用户输入的文本和主管代理对对话每回合的回应。

  2. 选择 “添加合作者”,将此合作者代理添加到您的 multi-agent-collaboration团队中。要添加更多合作者代理,请重复步骤 1,直到添加完所有合作者代理。

  3. 添加完合作者代理后,请选择以下选项之一:

    • 要保持多代理协作,请选择 “保存”,然后继续下一步,准备和测试您的多代理协作团队。

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

第 4 步:准备和测试多代理协作
步骤 5:部署多代理协作
  • 通过设置主管代理InvokeAgent发出请求来@@ 部署多代理协作。

API

完成以下步骤以创建多代理协作团队,

步骤 1:创建协作者代理
步骤 2:创建新的主管代理或为现有代理分配主管角色
  • 要创建新的主管代理,请发送 CreateAgent使用 Amazon Bedrock 代理构建时终端节点请求(有关请求和响应格式以及字段详情,请参阅链接)。

    要为现有代理分配主管角色,请发送 UpdateAgentAmazon Bedrock 构建时终端节点的代理请求。由于所有字段都将被覆盖,您既要包含要更新的字段,也要包含要保持不变的字段。

    您必须至少包含以下字段:

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

    为代理分配主管角色。

    指定SUPERVISOR是否希望主管代理协调协作者代理的响应并输出响应。

    指定SUPERVISOR_ROUTER是否希望主管代理将信息路由到相应的协作者代理以发送最终响应。

    默认情况下,此字段设置为DISABLED

    以下字段是可选字段:

    字段 应用场景
    description 描述代理的用途
    空闲会话秒 TTLIn 代理结束会话并删除所有存储信息的持续时间。
    customerEncryptionKeyArn 用于加密代理资源的 KMS 密钥的 ARN
    tags 标签与代理关联。
    promptOverrideConfiguration 自定义在编排的每个步骤向 FM 发送的提示
    guardrailConfiguration 为代理添加防护机制。指定防护机制的 ID 或 ARN 以及要使用的版本。
    clientToken 用于确保 API 请求仅完成一次。有关更多信息,请参阅确保幂等性

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

步骤 3:添加合作者代理
  • 要将协作者代理与主管代理关联,请使用适用于 A mazon Bedrock 的代理构建时终端节点发送AssociateAgentCollaborator请求(请求和响应格式以及字段详情参见链接)。

    您必须至少包含以下字段:

    字段 应用场景
    合作者姓名 为合作者代理指定备用名称。此名称将仅出现在协作说明中,不会取代原始代理名称。
    代理描述符 指定代理的别名 Arn。
    协作指令 提供指示以告诉合作者代理该怎么做。
    relayConversationHistory

    设置TO_COLLABORATOR为,指定主管代理将与该协作者代理共享先前对话的上下文。

    有效值:TO_COLLABORATOR | DISABLED

第 4 步:准备并测试您的多代理协作者团队
第 4 步:部署您的多代理协作团队
  • 通过设置主管代理来InvokeAgent提出请求,部署您的多代理协作团队。