Criar colaboração multiagente

Etapa 1: criar agentes colaboradores

• Siga as instruções para Criar e configurar um agente. 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 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.

2. 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 do Amazon Bedrock. Em seguida, 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 de vários agentes e escolha Editar.

3. Na página Colaboração de vários agentes, na seção Status da colaboração, ative Colaboração de vários agentes. 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 ao agente colaborador apropriado para enviar a resposta final, selecione Supervisor com roteamento.

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

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

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

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

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

3. Ao concluir a adição dos agentes colaboradores, selecione uma das seguintes opções:

   • Para permanecer na colaboração multiagente, escolha Salvar e prossiga para a próxima etapa para preparar e testar sua equipe de colaboração multiagente.

   • 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 multiagente

• Implemente a colaboração multiagente configurando o agente supervisor para fazer uma solicitação InvokeAgent.

Etapa 1: criar agentes colaboradores

• Siga as instruções para Criar e configurar um agente. 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 CreateAgent com um endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock.

  Para atribuir um perfil de supervisor a um agente existente, envie uma solicitação UpdateAgent com um endpoint de tempo de compilação do recurso Agentes para 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 no mínimo 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.
  agentCollaboration	Para atribuir um perfil de supervisor ao agente. Especifique SUPERVISOR se você deseja que o agente supervisor coordene as respostas dos agentes colaboradores e gere a resposta. Especifique SUPERVISOR_ROUTER, se você quiser que o agente supervisor encaminhe as informações ao agente colaborador apropriado para enviar a resposta final. Por padrão, esse campo é definido como DISABLED.

  Os seguintes campos são opcionais:

  Campo	Caso de uso
  description	Descreve o que o agente faz.
  idleSessionTTLInSeconds	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 exibe um objeto CreateAgent que contém detalhes sobre o agente supervisor recém-criado. Se o agente não for criado, o objeto CreateAgent 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.

  Você deve incluir no mínimo os seguintes campos:

  Campo	Caso de uso
  collaboratorName	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.
  agentDescriptor	Para especificar o ARN do alias do agente.
  collaborationInstruction	Para fornecer instruções e informar 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 colaboração multiagente

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

Etapa 4: implantar sua equipe de colaboração multiagente

• Implemente a colaboração multiagente configurando o agente supervisor para fazer uma solicitação InvokeAgent.