Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.