Adicionar um agente conectado a um agente (GitHub Copilot)

Use agentes ligados para permitir que o seu agente principal delegue tarefas específicas a agentes especializados. Este artigo mostra-lhe como adicionar outro agente publicado do Copilot Studio como agente ligado e verificar se a delegação funciona como esperado.

Note

A estrutura usada para construir este agente utiliza faturação baseada no uso. Usar, construir, testar e avaliar agentes podem consumir Créditos Copilot. Saiba mais em Visão Geral da faturação baseada no uso.

Adicionam-se todos os agentes ligados a partir do mesmo diálogo Adicionar um agente ligado. Esta orientação aplica-se independentemente de o agente estar construído no Copilot Studio, alojado no Microsoft Foundry ou acedido através do protocolo Agent2Agent (A2A). Este artigo aborda como ligar um agente da Copilot Studio. Para ligar um agente Microsoft Foundry em vez disso, consulte Adicionar um agente Microsoft Foundry como agente conectado. Para ligar um agente remoto através do protocolo A2A, veja Adicionar um agente A2A como agente conectado. Para ligar um agente construído com o SDK de Agentes do Microsoft 365, consulte Adicionar um agente SDK de Agentes do Microsoft 365 como agente ligado.

Prerequisites

  • Um agente criado com o GitHub Copilot harness para ser o agente principal. Consulte Criar um agente (pré-visualização).
  • Pelo menos outro agente alimentado pelo harness GitHub Copilot no mesmo ambiente. O outro agente deve estar publicado e configurado como disponível para ser ligado.
  • O criador do agente principal tem de ser o proprietário do agente conectado ou ter esse agente partilhado com ele.

Note

O acesso a um agente pai não concede automaticamente acesso aos seus agentes ligados. Partilhe cada agente ligado separadamente com cada utilizador ou grupo pretendido.

Adicione um agente do Copilot Studio

  1. Inicia sessão no Copilot Studio.

  2. Escolha e abra o agente que pretende usar como agente principal.

  3. Na barra de navegação do agente, selecione o separador Build .

  4. No painel de componentes, selecione Agentes ligados para abrir o diálogo Adicionar um agente ligado.

  5. Na janela de diálogo Adicionar um agente conectado, navegue ou pesquise os agentes disponíveis do Copilot Studio e selecione o agente que pretende conectar.

  6. Reveja as capacidades do agente e, em seguida, adicione uma descrição clara de quando o agente ligado deve ser utilizado.

  7. Selecione Conectar.

  8. Confirme que o agente ligado aparece no painel de componentes.

Como o orquestrador encaminha para os agentes conectados

Após adicionar um agente conectado, o ambiente de execução de orquestração determina automaticamente quando delegar-lhe. A decisão de encaminhamento baseia-se em:

  • Nome e descrição do agente ligado
  • A mensagem do utilizador e o contexto da conversa
  • Instruções do agente principal

Tip

Escreva uma descrição clara e específica para cada agente ligado, para que o orquestrador possa determinar com precisão quando encaminhar pedidos para ele. Evite descrições sobrepostas entre agentes ligados.

Delegação de teste

Após adicionar um agente ligado:

  1. Na barra de navegação do agente, selecione o separador Pré-visualização.

  2. Envie uma mensagem que corresponda ao domínio do agente ligado.

  3. Verifique se a resposta vem do agente ligado e é apropriada.

  4. Envie uma mensagem fora do domínio do agente ligado para confirmar que o seu agente principal trata disso.