Crie colaboração com vários agentes

Etapa 1: criar agentes colaboradores

• Siga as instruções para criar e configurar um agente. Certifique-se de configurar cada agente colaborador para realizar uma tarefa específica.

Etapa 2: Criar um novo agente supervisor ou atribuir a função de supervisor a um agente existente

1. Se você estiver criando um novo agente supervisor, siga as instruções Criar e configurar o agente manualmente e continue com a próxima etapa.

   Se você já tiver um agente configurado e quiser atribuir a função de supervisor ao agente, continue com a próxima etapa.

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

   1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

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

   3. Escolha Editar no Construtor de agentes.

   4. No Construtor de agentes, role para baixo até a seção Colaboração multiagente e escolha Editar.

3. Na página Colaboração multiagente, na seção Status da colaboração, ative Colaboração multiagente. Isso identificará o agente como um agente supervisor.

4. 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.

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

   3. Continue com 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 com vários agentes.

   1. Para agente colaborador, selecione um agente colaborador e um alias de agente no menu suspenso. Você pode escolher Exibir para ver os detalhes do agente colaborador.

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

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

   4. (Opcional) Ative o histórico de conversas se quiser que o agente supervisor compartilhe o contexto de conversas anteriores com esse agente colaborador. Se isso estiver ativado, o supervisor incluirá o histórico completo da sessão atual, incluindo o texto inserido pelo usuário e a resposta do agente supervisor em cada turno da conversa.

2. Escolha Adicionar colaborador para adicionar esse agente colaborador à sua multi-agent-collaboration equipe. Para adicionar mais agentes colaboradores, repita a etapa 1 até adicionar todos os seus agentes colaboradores.

3. Ao terminar de adicionar agentes colaboradores, selecione uma das seguintes opções:

   • Para permanecer na colaboração com vários agentes, 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 sua equipe de colaboração multiagente.

Etapa 5: implantar uma colaboração com vários agentes

• Implemente a colaboração entre vários agentes configurando o agente supervisor para fazer uma InvokeAgent solicitação.

Etapa 1: criar agentes colaboradores

• Siga as instruções para criar e configurar um agente. Certifique-se de configurar cada agente colaborador para realizar uma tarefa específica.

Etapa 2: Criar um novo agente supervisor ou atribuir a função de supervisor a um agente existente

• Para criar um novo agente supervisor, envie um CreateAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

  Para atribuir uma função de supervisor a um agente existente, envie um UpdateAgentsolicitação com um endpoint de tempo de construção do Agents for Amazon Bedrock. Como todos os campos serão substituídos, inclua os campos que deseja atualizar e aqueles que deseja manter iguais.

  Você deve incluir minimamente os seguintes campos:

  Campo	Caso de uso
  agentResourceRoleArn	Especificar um ARN do perfil de serviço com permissões para chamar operações de API no agente.
  foundationModel	Especificar um modelo de base (FM) com o qual o agente orquestrar.
  instruction	Fornecer instruções para informar ao agente o que fazer. Usada no espaço reservado $instructions$ no modelo de prompt de orquestração.
  Colaboração de agentes	Para atribuir a função de supervisor ao agente. Especifique SUPERVISOR se você deseja que o agente supervisor coordene as respostas dos agentes colaboradores e produza a resposta. Especifique SUPERVISOR_ROUTER se você deseja que o agente supervisor encaminhe as informações para o agente colaborador apropriado para enviar a resposta final. Por padrão, esse campo é definido comoDISABLED.

  Os seguintes campos são opcionais:

  Campo	Caso de uso
  description	Descreve o que o agente faz.
  Segundos da sessão ociosa TTLIn	Tempo após o qual o agente encerra a sessão e exclui todas as informações armazenadas.
  customerEncryptionKeyArn	ARN de uma chave do KMS para criptografar recursos do agente.
  tags	Para associar tags ao agente.
  promptOverrideConfiguration	Para personalizar os prompts enviados ao FM em cada etapa da orquestração.
  guardrailConfiguration	Para adicionar uma barreira de proteção ao agente. Especifique o ID ou o ARN da barreira de proteção e a versão a ser usada.
  clientToken	Para garantir que a solicitação de API seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.

  A resposta retorna um CreateAgentobjeto que contém detalhes sobre seu agente supervisor recém-criado. Se seu agente não for criado, o CreateAgentO objeto na resposta retorna uma lista de failureReasons e uma lista de recommendedActions para você solucionar o problema.

Etapa 3: adicionar agentes colaboradores

• Para associar agentes colaboradores ao agente supervisor, envie uma AssociateAgentCollaborator solicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

  Você deve incluir minimamente os seguintes campos:

  Campo	Caso de uso
  Nome do colaborador	Para especificar um nome alternativo para o agente colaborador. Esse nome aparecerá somente nas instruções de colaboração e não substituirá o nome original do agente.
  Descritor do agente	Para especificar o alias do agente Arn.
  Instrução de colaboração	Fornecer instruções para dizer ao agente colaborador o que fazer.
  relayConversationHistory	Defina como TO_COLLABORATOR para especificar que o agente supervisor compartilhará o contexto de conversas anteriores com esse agente colaborador. Valores válidos: TO_COLLABORATOR | DISABLED.

Etapa 4: Preparar e testar sua equipe de colaboradores multiagentes

• Siga as instruções para preparar e testar sua equipe de colaboração multiagente.

Etapa 4: implantar sua equipe de colaboração com vários agentes

• Implante sua equipe de colaboração multiagente configurando seu agente supervisor para fazer uma InvokeAgent solicitação.