Conecte-se a outros agentes a partir de um agente declarativo

Quando os usuários interagem com um agente declarativo no Microsoft 365 Copilot Chat, ele pode se conectar a outros agentes para recuperar informações extras ou realizar ações. Você declara essas conexões no manifesto do agente listando os IDs do título do worker_agents agente na propriedade. Em tempo de execução, o Copilot Chat atua como o agente que medeia a interação — os usuários veem a troca de agente para agente, mas não precisam selecionar os agentes conectados.

Quando um usuário interage com um agente declarativo, o agente pode delegar parte da tarefa a um agente conectado. O Microsoft 365 Copilot avalia os agentes conectados declarados no manifesto e seleciona um com base na tarefa atual e no nome, na descrição e nos prompts de exemplo do agente conectado. O Copilot envia uma solicitação de texto para o agente conectado selecionado, recebe uma resposta de texto e incorpora essa resposta à interação contínua do agente declarativo com o usuário.

Quando usar agentes conectados

Use agentes conectados para dividir ou combinar agentes entre funções ou equipes de desenvolvimento.

Expandir além do que um agente pode realizar

Os modelos de linguagem grande (LLMs) têm uma janela de contexto útil limitada e um conjunto de recursos. A confiabilidade de um único agente LLM começa a cair à medida que mais documentos são recuperados ou ferramentas são habilitadas. Se um agente tiver qualidade inferior depois de adicionar mais conhecimento ou funcionalidades, divida algumas dessas capacidades em outro agente e conecte-se a ele. O agente existente envia apenas as informações sobre a tarefa que o agente conectado precisa para atingir sua parte. O agente conectado funciona em sua própria janela de contexto, livre de outros documentos ou recursos que estão na conversa do usuário.

Integre-se a agentes desenvolvidos externamente

Os agentes declarativos podem facilitar o trabalho com outras equipes de desenvolvimento. Cada equipe de desenvolvimento pode se concentrar nos recursos e na qualidade de seu agente, usando agentes conectados para integração com outros agentes. Assim como nos microsserviços, cada agente pode ser desenvolvido sem afetar outros agentes. Ao contrário dos microsserviços, os agentes podem continuar a interagir uns com os outros mesmo quando suas interfaces mudam.

Compartilhar recursos do agente em vários cenários

Um agente pode funcionar bem com um conjunto de documentos e ações, mas ainda assim ser difícil para os usuários. Considere um agente que entenda as tabelas e os dados de um banco de dados relacional de clientes e vendas. Esse agente pode ser útil para os supervisores de loja gerenciarem o estoque e para os analistas de negócios se reportarem aos executivos. Se esse agente pudesse ser conectado a um agente adaptado aos supervisores da loja com iniciadores de conversa e instruções, e também a um agente adaptado aos analistas de negócios. Ambos os tipos de usuários podem obter mais valor ao usar agentes adaptados ao seu cenário.

Habilitando agentes conectados

Você deve registrar os agentes conectados no registro de agentes do Microsoft Agent 365. Conecte-se a outros agentes incluindo as IDs dos títulos dos agentes no manifesto do agente declarativo existente. O outro agente deve ser um agente declarativo ou ter um agente de Agent2Agent registrado card.

Primeiro, obtenha o ID do título do agente para se conectar. A ID do título de um agente é uma sequência de uma única letra, um sublinhado e um GUID. Para um agente declarativo, localize-o na saída do comando Provisionar no Microsoft 365 Agents Toolkit ou no modo de desenvolvedor. Para um Registro de Agente do Microsoft 365, é propriedade id do objeto agentRegistration.

Adicione a ID do título à propriedade worker_agents como o id. A worker_agents propriedade foi adicionada no esquema de agente declarativo versão 1.6.

Autenticação e autorização

A conexão a um agente declarativo depende da autenticação existente do usuário para o Microsoft 365 Copilot, pois o agente declarativo é executado no Microsoft 365 Copilot Chat. Para agentes externos registrados no Microsoft Agent 365, o registro do agente deve declarar como o Microsoft 365 Copilot se autentica para o agente externo. Em vez de incorporar a configuração de autenticação diretamente no registro do agente, o registro faz referência a um registro de autenticação existente por meio do authorization objeto no agentRegistration. Essa separação permite que a configuração de autenticação seja gerenciada independentemente das definições do agente. O design espelha o dos manifestos de plug-in de API.

Sintaxe

{
  "type": "None | OAuthPluginVault",
  "referenceId": "{string}"
}

A type propriedade especifica o esquema de autenticação usado pelo agente externo. OAuthPluginVaultusa um registro de SSO do Microsoft Entra. É referenceId o Microsoft Entra SSO registration ID valor gerado no portal do desenvolvedor do Teams. Consulte Usar o portal do desenvolvedor do Teams para obter mais detalhes.

A possibilidade de um usuário usar o agente conectado é determinada separadamente da autenticação. Os usuários devem ter acesso ao agente conectado, seja adquirindo-o eles mesmos ou por meio da implantação do administrador. Os administradores devem instalar agentes externos registrados no Microsoft Agent 365 para o usuário.

Práticas recomendadas

Os agentes declarativos escolhem a quais agentes se conectar com base nos prompts , , e de exemplo do namedescriptionagente conectado. Para um agente declarativo, os prompts de exemplo são o campo no conversation_starters manifestotext. Para um agentRegistration, é a examples propriedade do AgentSkill objeto no agent card. A descrição do agente deve descrever tanto para humanos quanto para agentes o que o agente pode fazer. Por exemplo, considere esta descrição para um agente que trabalha com dados estruturados sobre vendas de videogames.

A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.

Os prompts de exemplo devem informar aos usuários e agentes os tipos de prompts que o agente pode manipular. Como os usuários podem usar termos diferentes para o mesmo conceito, considere variar o fraseado dos iniciadores de conversa. Por exemplo, ao trabalhar com casos legais, bons iniciadores de conversa também podem usar os termos "assunto", "caso", "cliente" e "problema". Somente o text campo de um iniciador de conversa é usado por agentes conectados.

Limitações

• O agente ativo envia texto somente para um agente conectado. Os agentes declarativos retornam texto ou Cartões Adaptativos. Os agentes com cartões de agente Agent2Agent retornam texto, binários de imagem Base64 e binários de arquivo Base64.

• Embora o usuário seja solicitado a confirmar chamadas de plug-in de API do agente conectado, todos os cartões adaptativos são enviados para o agente ativo. O usuário não vê o card adaptável nem pode usar uma caixa de diálogo. No entanto, o agente ativo processa o conteúdo de dados do adaptive card.

Conteúdo relacionado

• Criar agentes com o Visual Studio Code
• Testar e depurar agentes no Copilot Studio