

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar colaboração multiagente
<a name="create-multi-agent-collaboration"></a>

A criação de uma colaboração multiagente compreende as seguintes etapas:

1. Crie e implante agentes colaboradores. Você deve configurar cada agente colaborador para implementar uma tarefa específica dentro do fluxo de trabalho de colaboração multiagente. 

1. Crie um agente supervisor ou atribua a um agente existente o perfil de supervisor. Ao criar um agente supervisor ou identificar um agente existente como agente supervisor, você também pode especificar como deseja que o agente supervisor manipule as informações de vários agentes colaboradores.

   É possível atribuir ao agente supervisor a tarefa de coordenar as respostas dos agentes colaboradores ou atribuir ao agente supervisor a tarefa de encaminhar as informações ao agente colaborador apropriado para enviar a resposta final. Atribuir ao agente supervisor a tarefa de encaminhar as informações reduz a latência. 

1. Associe a versão do alias dos agentes colaboradores ao agente supervisor.
**nota**  
No momento, é possível associar no máximo dez agentes colaboradores a um agente supervisor.

1. Prepare e teste sua equipe de colaboração multiagente.

1. Implemente e invoque o agente supervisor.

Você pode criar colaboração multiagente no console do Amazon Bedrock, usando as APIs, usando a AWS CLI ou usando o SDK. AWS Para saber como criar uma colaboração multiagente, escolha a guia correspondente do método de sua preferência e siga as etapas:.

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

**Etapa 1: criar agentes colaboradores**
+ Siga as instruções para [Criar e configurar um agente](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html). Você deve configurar cada agente colaborador para realizar uma tarefa específica.

**Etapa 2: criar um agente supervisor ou atribuir o perfil de supervisor a um agente existente**

1. Se você estiver criando um agente supervisor, siga as instruções em [Criar e configurar o agente manualmente](agents-create.md) e prossiga para a próxima etapa.

   Se você já tiver um agente configurado e quiser atribuir o perfil de supervisor ao agente, prossiga para a próxima etapa.

1. Se você ainda não estiver no Construtor de agentes, faça o seguinte:

   1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

   1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.

   1. Escolha **Editar no Construtor de agentes**.

   1. No **Construtor de agentes**, role para baixo até a seção de **Multi-agent colaboração** e escolha **Editar**.

1. Na página de **Multi-agent colaboração**, na seção **Status da colaboração**, ative a **Multi-agent colaboração**. Isso identificará o agente como um agente supervisor.

1. Na seção **Configuração de colaboração**, escolha como você deseja que o agente supervisor manipule as informações de vários agentes colaboradores para coordenar uma resposta final.

   1. Se você quiser que o agente supervisor coordene as respostas dos agentes colaboradores, selecione **Supervisor**.

   1. Se você quiser que o agente supervisor encaminhe as informações ao agente colaborador apropriado para enviar a resposta final, selecione **Supervisor com roteamento**.

   1. Prossiga para as próximas etapas para adicionar agentes colaboradores.

**Etapa 3: adicionar agentes colaboradores**

1. Expanda a seção **Agente colaborador** e forneça detalhes do agente colaborador que você criou para colaboração multiagente.

   1. Em **Agente colaborador**, selecione um agente colaborador e **Alias do agente** no menu suspenso. Você pode escolher **Visualizar** para ver os detalhes do agente colaborador.

   1. Em **Nome do colaborador**, insira um nome alternativo para o agente colaborador. Esse nome não substituirá o nome original desse agente.

   1. Em **Instruções da colaboração**, insira os detalhes de quando esse colaborador deve ser usado pelo agente supervisor. 

   1. (Opcional) Ative **Habilitar o histórico de conversas** se quiser que o agente supervisor compartilhe o contexto de conversas anteriores com esse agente colaborador. Se essa opção estiver ativada, o supervisor incluirá o histórico completo da sessão atual, inclusive o texto inserido pelo usuário e a resposta do agente supervisor em cada turno da conversa.

1. Escolha **Adicionar colaborador** para adicionar esse agente colaborador à sua equipe de colaboração multiagente. Para adicionar mais agentes colaboradores, repita a Etapa 1 até adicionar todos os seus agentes colaboradores. 

1. Ao concluir a adição dos agentes colaboradores, selecione uma das seguintes opções:
   + Para continuar na **Multi-agent colaboração**, escolha **Salvar** e continue com a próxima etapa para preparar e testar sua equipe de colaboração com vários agentes.
   + Para retornar à página **Detalhes do agente**, escolha **Salvar e sair**.

**Etapa 4: preparar e testar uma colaboração multiagente**
+ Siga as instruções para [preparar e testar](agents-test.md) sua equipe de colaboração multiagente. 

**Etapa 5: implantar uma colaboração multiagente**
+ [Implemente](agents-deploy.md) a colaboração multiagente configurando o agente supervisor para fazer uma solicitação `InvokeAgent`.

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

Conclua as etapas abaixo para criar uma equipe de colaboração multiagente.

**Etapa 1: criar agentes colaboradores**
+ Siga as instruções para [Criar e configurar um agente](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html). Você deve configurar cada agente colaborador para realizar uma tarefa específica.

**Etapa 2: criar um agente supervisor ou atribuir o perfil de supervisor a um agente existente**
+ Para criar um agente supervisor, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

  Para atribuir um perfil de supervisor a um agente existente, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Como todos os campos serão substituídos, inclua os campos que deseja atualizar e aqueles que deseja manter iguais.

  Você deve incluir no mínimo os seguintes campos:  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  Os seguintes campos são opcionais:  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  A resposta exibe um objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) que contém detalhes sobre o agente supervisor recém-criado. Se o agente não for criado, o objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) apresentará uma lista de `failureReasons` na resposta e uma lista de `recommendedActions` para você solucionar o problema.

**Etapa 3: adicionar agentes colaboradores**
+ Para associar informações ao agente supervisor, envie uma solicitação `AssociateAgentCollaborator` com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

  Você deve incluir no mínimo os seguintes campos:  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/create-multi-agent-collaboration.html)

**Etapa 4: preparar e testar sua equipe de colaboração multiagente**
+ Siga as instruções para [preparar e testar](agents-test.md) sua equipe de colaboração multiagente. 

**Etapa 4: implantar sua equipe de colaboração multiagente**
+ [Implemente](agents-deploy.md) a colaboração multiagente configurando o agente supervisor para fazer uma solicitação `InvokeAgent`.

------