Visão geral do orquestrador do Microsoft 365 Copilot

O orquestrador do Microsoft 365 Copilot coordena o modelo de linguagem, o contexto disponível e os recursos que ele usa para responder a uma solicitação do usuário. Para agentes declarativos, esses recursos podem incluir recuperação de conhecimento, recursos internos e ações fornecidas por plug-ins MCP ou API.

Este artigo se concentra em como a configuração do seu agente influencia a seleção e a invocação da ação. Você fornece instruções, definições de ferramentas e serviços externos; A Microsoft gerencia o runtime de conversa. Para uma divisão mais ampla de responsabilidades, consulte Arquitetura do agente declarativo.

Orquestrador do Copilot

O orquestrador usa a configuração do agente e o contexto disponível para determinar se deve responder diretamente, recuperar conhecimento ou invocar uma ferramenta. Nem toda solicitação requer uma ação externa.

Diagrama conceitual conectando agentes, orquestração de IA, modelos de linguagem, dados organizacionais e infraestrutura.

Por exemplo, um usuário pode perguntar: "Quais tíquetes estão atribuídos a mim agora?" Um agente com uma ação de emissão de tíquetes apropriada pode recuperar informações atuais do serviço de emissão de tíquetes em vez de confiar no conhecimento do modelo.

O diagrama a seguir ilustra uma interação API-ação. É uma visão conceitual, não uma sequência de execução fixa ou uma garantia de que cada solicitação usa o Microsoft Graph ou uma API externa.

Exemplo conceitual de uma consulta de ticket progredindo por verificações de plataforma, seleção de ferramentas, execução de API, análise de resultados e uma resposta.

  1. Interprete a solicitação. O Copilot usa o prompt, as instruções do agente, o histórico de conversas e o contexto do aplicativo disponível para identificar a tarefa do usuário. As verificações de política e segurança da plataforma podem afetar se e como a solicitação prossegue.
  2. Selecione as funcionalidades relevantes. O Copilot determina se o conhecimento ou as ferramentas configuradas podem ajudar. Para uma ação externa, as descrições de plug-in e ferramenta ajudam a identificar uma operação apropriada.
  3. Determine as entradas e invoque a ferramenta. O Copilot mapeia as informações disponíveis para os parâmetros da ferramenta. As instruções devem orientá-lo a solicitar informações necessárias ausentes, em vez de inventar valores. As chamadas externas usam o comportamento de autenticação e confirmação configurado.
  4. Interprete o resultado. O Copilot usa os dados retornados ou o erro para determinar a próxima etapa. A interação pode incluir outra chamada, um pedido de esclarecimento ou uma resposta ao usuário.
  5. Responder ao usuário. O Copilot gera uma resposta usando o contexto e os resultados disponíveis. A resposta deve refletir o que o serviço realmente retornou ou alterou.

Os agentes declarativos dão suporte a chamadas de função de encadeamento, incluindo passar a saída de uma chamada de API para outra e combinar ações de API com conhecimento do SharePoint ou interpretador de código. Projete e teste as interações necessárias, em vez de supor um número fixo de chamadas, sempre concluídas em um turno. Siga as limitações atuais do plugin e os limites de seus serviços externos.

As proteções de plataforma e as confirmações de usuário não substituem as verificações de autorização ou de regras de negócios no serviço externo. Se o fluxo de trabalho exigir ordem de execução, transações ou recuperação exatas, implemente esses requisitos no serviço em vez de depender de instruções de modelo.

Como o orquestrador do Copilot faz a correspondência entre ações e consultas do usuário

A seleção de plug-ins e a invocação de ferramentas individuais são decisões diferentes. A descrição de um plug-in ajuda o Copilot a identificar o serviço ou domínio relevante. As ferramentas disponíveis nesse plug-in descrevem as operações que o Copilot pode invocar e as entradas necessárias.

Quando a seleção de plug-ins usa correspondência semântica, a correspondência é baseada na descrição do plug-in, não nas descrições de funções individuais. Um plug-in correspondente disponibiliza suas funções ou ferramentas; Não é uma lista fixa de cinco funções. Para o comportamento de seleção atual e as restrições de contexto, consulte as limitações do plug-in MCP e da API.

Forneça descrições úteis em cada nível:

Configuração O que descrever
Descrição do plug-in A finalidade do serviço, as tarefas de usuário com suporte e o domínio. Torne a descrição específica o suficiente para distingui-la de outros plugins.
Definição de função ou ferramenta A finalidade da operação, quando usá-la e se ela recupera ou altera dados. Para plug-ins de API, mapeie o nome da função para o OpenAPI operationId.
Parâmetros Entradas, tipos, formatos e exemplos significativos necessários. Distinguir identificadores de nomes de exibição e deixar claro o comportamento opcional.
Resultados e erros Os dados retornados, o que significa uma operação bem-sucedida e como as falhas são representadas. Mantenha as cargas úteis relevantes para a tarefa.

Para plug-ins de API, siga Criar descrições efetivas de OpenAPI. Para plug-ins MCP, marque se as definições de ferramenta são descobertas dinamicamente ou fixadas no manifesto do plug-in. Com a descoberta dinâmica, as alterações nas definições de ferramenta do servidor podem afetar a seleção sem a republicação do agente.

Melhorar e avaliar a seleção de ações

Descrições e instruções influenciam a seleção. Eles não garantem que uma ferramenta específica seja invocada para cada frase de uma solicitação.

  • Esclarecer operações sobrepostas. Se várias ferramentas parecerem adequadas, explique suas diferentes finalidades e entradas necessárias. Distinguir operações de leitura de operações que alteram dados.
  • Conecte tarefas a ferramentas nas instruções. Explique quando usar as ferramentas configuradas, como coletar informações ausentes e como usar resultados anteriores em solicitações de acompanhamento. Consulte Instruções para agentes com plug-ins de API.
  • Mantenha as ferramentas disponíveis focadas. Exponha as operações necessárias para as tarefas do agente. Mais definições de ferramentas e cargas maiores consomem contexto e podem reduzir a qualidade da resposta.
  • Teste as seleções e os resultados reais. Inclui prompts parafraseados, solicitações ambíguas, entradas ausentes, tarefas de várias etapas, confirmações canceladas e falhas de serviço. Verifique as operações e os parâmetros que o serviço recebeu, não apenas o texto final.
  • Repita os testes quando as definições forem alteradas. Execute novamente os casos representativos após as alterações nas descrições do plug-in, nas definições de ferramentas, nas instruções ou na plataforma. Inclua atualizações do servidor MCP ao usar a descoberta dinâmica.

Importante

Uma resposta conversacional ausente ou incompleta não estabelece se uma operação externa foi concluída. Verifique o resultado do serviço antes de repetir uma operação que altera dados e projete o serviço para lidar com solicitações repetidas com segurança.

Para obter recomendações de design mais amplas, consulte Práticas recomendadas do agente declarativo. Para casos de teste e afirmações repetíveis, consulte Visão geral da avaliação do agente.