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

# 创建多代理协作
<a name="create-multi-agent-collaboration"></a>

创建多代理协作的过程包括以下步骤：

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

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

   您可以向主管代理分配来自合作代理的响应的协调任务，也可以向主管代理分配任务，将信息路由到合适的合作代理以发送最终响应。向主管代理分配路由信息的任务后，即可减少延迟。

1. 将合作代理的别名版本与主管代理相关联。
**注意**  
目前，您最多可将 10 个合作代理与主管代理相关联。

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

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

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

------
#### [ Console ]

**步骤 1：创建合作代理**
+ 按照说明[创建和配置代理](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html)。确保将每个合作代理配置为执行特定任务。

**步骤 2：创建新的主管代理或向现有代理分配主管角色**

1. 如果您要创建新的主管代理，请按照说明来[手动创建和配置代理](agents-create.md)，然后继续下一步。

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

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

   1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，打开 Amazon Bedrock 控制台，网址为[https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)。

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

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

   1. 在**代理生成器**中，向下滚动到**Multi-agent 协作**部分，然后选择**编辑**。

1. 在**Multi-agent 协作**页面的**协作状态**部分，打开**Multi-agent 协作**。这会将代理标识为主管代理。

1. 在**协作配置**部分，选择您希望主管代理如何在多个合作代理之间处理信息来协调最终的响应。

   1. 如果您希望主管代理协调来自合作代理的响应，请选择**主管**。

   1. 如果您希望主管代理将信息路由到相应的合作代理，由合作代理发送最终响应，请选择**有路由功能的主管**。

   1. 继续执行后续步骤来添加合作代理。

**步骤 3：添加合作代理**

1. 展开**代理合作者**部分，提供您为多代理协作创建的合作代理的详细信息。

   1. 对于**合作代理**，请从下拉列表中选择合作代理和**代理别名**。您可以选择**查看**来查看合作代理的详细信息。

   1. 在**合作者姓名**中，输入合作代理的备用名。此名称不会取代该代理的原始名称。

   1. 在**协作说明**中，输入主管代理应在什么时候使用该合作者的详细信息。

   1. （可选）如果您希望主管代理与该合作代理共享以前对话的上下文，请开启**启用对话历史记录**。如果开启此功能，主管将包括当前会话的完整历史记录，包括每一轮对话中用户输入的文本和主管代理的响应。

1. 选择**添加合作者**，将此合作代理添加到您的多代理协作团队中。要添加更多合作代理，请重复步骤 1，直到添加完所有合作代理。

1. 添加完合作代理后，选择以下选项之一：
   + 要保持**Multi-agent 协作，请**选择 “**保存**” 并继续下一步，准备和测试您的多代理协作团队。
   + 要返回**代理详细信息**页面，请选择**保存并退出**。

**步骤 4：准备并测试多代理协作**
+ 按照说明，[准备并测试](agents-test.md)多代理协作团队。

**步骤 5：部署多代理协作**
+ 通过设置主管代理 `InvokeAgent` 发出请求，来[部署](agents-deploy.md)多代理协作。

------
#### [ API ]

要创建多代理协作团队，请完成以下步骤：

**步骤 1：创建合作代理**
+ 按照说明[创建和配置代理](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html)。确保将每个合作代理配置为执行特定任务。

**步骤 2：创建新的主管代理或向现有代理分配主管角色**
+ 要创建新主管代理，请使用 [Amazon Bedrock 代理构建时端点](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)发送 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) 请求（有关请求和响应格式以及字段详细信息，请参阅链接）。

  要向现有代理分配主管角色，请使用 [Amazon Bedrock 代理构建时端点](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)发送 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html) 请求。由于所有字段都将被覆盖，您既要包含要更新的字段，也要包含要保持不变的字段。

  您至少必须添加以下字段：  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  以下字段是可选字段：  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  响应会返回一个 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) 对象，其中包含新创建的主管代理的详细信息。如果代理创建失败，响应中的 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) 对象会返回一个 `failureReasons` 列表和一个 `recommendedActions` 列表，供您进行故障排除。

**步骤 3：添加合作代理**
+ 要将合作代理与主管代理关联，请使用 [Amazon Bedrock 代理构建时端点](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)发送 `AssociateAgentCollaborator` 请求（有关请求和响应格式以及字段详细信息，请参阅链接）。

  您至少必须添加以下字段：  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/create-multi-agent-collaboration.html)

**步骤 4：准备并测试您的多代理协作团队**
+ 按照说明，[准备并测试](agents-test.md)多代理协作团队。

**步骤 5：部署多代理协作团队**
+ 通过将主管代理设置为发出 `InvokeAgent` 请求，来[部署](agents-deploy.md)多代理协作团队。

------