Agentes declarativos do Microsoft 365 Copilot

Os agentes declarativos fornecem uma experiência de conversação direcionada a objetivos que é alimentada pelo Microsoft 365 Copilot. Você define a finalidade, as instruções, o conhecimento e as ações apoiadas do agente para lidar com um cenário de negócios. Um plug-in pode incluir ou fazer referência a um agente com outros recursos com suporte, como habilidades, conectores do Copilot ou ferramentas baseadas em MCP.

Escolha um agente declarativo quando os usuários precisarem de uma experiência de conversação dedicada com comportamento e recursos adaptados a um resultado específico. Você não precisa criar um agente quando uma experiência existente da Microsoft ou um agente aprovado puder usar as habilidades, conectores ou ferramentas selecionadas.

Observação

Para obter informações sobre as duas abordagens para criar agentes para o Microsoft 365 Copilot, consulte Agentes para o Microsoft 365 Copilot.

Decida se você precisa de um agente declarativo

Considere um agente declarativo quando a solução exigir:

  • Uma experiência de conversação nomeada para um público e um resultado definidos.
  • Instruções e restrições que se aplicam consistentemente em todas as conversas.
  • Fontes de conhecimento selecionadas para fundamentação.
  • Ações, habilidades, conectores ou recursos baseados em MCP selecionados para o cenário.
  • Iniciadores de conversa e metadados que ajudam os usuários a entender o que o agente faz.

Por exemplo, um agente de suporte ao funcionário pode usar conhecimento organizacional aprovado para responder a perguntas comuns. Um agente de suporte ao cliente pode combinar instruções e conhecimento com um recurso externo que recupera as informações atuais do pedido.

Um diagrama que mostra dois cenários de agentes declarativos mencionados no artigo.

Um agente pode não ser o componente certo quando:

  • Os usuários já trabalham em uma experiência compatível que pode usar o recurso necessário diretamente.
  • Um agente aprovado existente atende ao resultado e pode ser configurado ou estendido.
  • A solução requer controle total da orquestração, modelo, hospedagem ou interface do usuário. Nesse caso, compare os agentes de mecanismo declarativos e personalizados.

Para obter orientações detalhadas sobre ajuste e limitação, consulte Arquitetura do agente declarativo.

Entenda com o que o agente contribui

Um agente declarativo é definido por uma configuração que descreve:

  • Identidade e comportamento: o nome, finalidade, instruções, iniciadores de conversa, restrições e representação visual do agente.
  • Conhecimento: As fontes de informação aprovadas que fundamentam as respostas.
  • Recursos: As ações, habilidades, conectores ou ferramentas que o agente pode usar.
  • Metadados de host e distribuição: as informações necessárias para exibir o agente em experiências da Microsoft com suporte.

Os usuários se envolvem com agentes declarativos no Microsoft 365 Copilot e aplicativos do Microsoft 365 com suporte.

Capturas de tela que mostram agentes declarativos em execução no Microsoft 365 Copilot.

Decida se deseja compilar ou reutilizar

Antes de criar um agente:

  • Revise os agentes que já estão aprovados para os usuários e experiências de destino.
  • Determine se um agente existente pode ser reutilizado, copiado, configurado ou estendido.
  • Confirme quem é o proprietário das instruções, conhecimento, conexões e suporte do agente.
  • Identifique as lacunas que exigem um novo agente.

Se você reutilizar um agente, confirme se seu proprietário suporta os usuários, dados, recursos, escopo de compartilhamento e ciclo de vida pretendidos.

Dependências do agente de registro

Ao decidir se deseja criar ou reutilizar um agente, observe:

  • Usuários-alvo, resultado e experiências da Microsoft.
  • Instruções, fontes de conhecimento e requisitos de conversação.
  • Habilidades, conectores, ações necessários ou recursos baseados em MCP.
  • Identidade, permissões, consentimento e limites de dados.
  • Requisitos de disponibilidade, idioma, licenciamento e ambiente.
  • Proprietário, contato de suporte e medidas de sucesso.

Depois de decidir criar ou reutilizar um agente, escolha as ferramentas de desenvolvimento.

Suporte à nuvem nacional

O suporte do agente declarativo para locatários do Microsoft 365 Government varia de acordo com a nuvem:

  • Government Community Cloud (GCC): o suporte completo do agente declarativo está disponível.
  • Government Community Cloud High (GCCH): há suporte para agentes de código profissional criados com o Microsoft 365 Agents Toolkit. O Agent Builder agora também está disponível no GCCH.
  • Departamento de Defesa (DoD): Suporte limitado - há suporte apenas para agentes de código profissional criados com o Microsoft 365 Agents Toolkit. O Agent Builder não está disponível para agentes declarativos no DoD.

Conteúdo relacionado

  • Última atualização em