Panoramica dell'agente di orchestrazione di Microsoft 365 Copilot

L'agente di orchestrazione di Microsoft 365 Copilot coordina il modello linguistico, il contesto disponibile e le funzionalità usate per rispondere a una richiesta dell'utente. Per gli agenti dichiarativi, queste funzionalità possono includere il recupero delle informazioni, le funzionalità predefinite e le azioni fornite dai plug-in MCP o API.

Questo articolo si concentra su come la configurazione dell'agente influenza la selezione e la chiamata delle azioni. L'utente fornisce istruzioni, definizioni di strumenti e servizi esterni. Microsoft gestisce il runtime conversazionale. Per una più ampia ripartizione delle responsabilità, vedere Architettura dichiarativa dell'agente.

Agente di orchestrazione Copilot

L'agente di orchestrazione usa la configurazione dell'agente e il contesto disponibile per determinare se rispondere direttamente, recuperare la conoscenza o richiamare uno strumento. Non tutte le richieste richiedono un'azione esterna.

Diagramma concettuale che collega agenti, orchestrazione IA, modelli linguistici, dati organizzativi e infrastruttura.

Ad esempio, un utente potrebbe chiedere: "Quali ticket mi sono stati assegnati in questo momento?" Un agente con un'azione di ticketing appropriata può recuperare le informazioni correnti dal servizio di ticketing anziché basarsi sulla conoscenza del modello.

Il diagramma seguente illustra un'interazione azione-API. Si tratta di una visualizzazione concettuale, non di una sequenza di esecuzione fissa o di una garanzia che ogni richiesta usi Microsoft Graph o un'API esterna.

Esempio concettuale di una query di ticket che avanza attraverso controlli della piattaforma, selezione degli strumenti, esecuzione di API, analisi dei risultati e una risposta.

  1. Interpretare la richiesta. Copilot usa la richiesta, le istruzioni dell'agente, la cronologia delle conversazioni e il contesto dell'app disponibile per identificare l'attività dell'utente. I controlli di sicurezza e dei criteri della piattaforma possono influire sull'opportunità e sulla modalità di procedere della richiesta.
  2. Selezionare le funzionalità pertinenti. Copilot determina se le conoscenze o gli strumenti configurati possono essere utili. Per un'azione esterna, le descrizioni di plug-in e strumenti aiutano a identificare un'operazione appropriata.
  3. Determina gli input e richiama lo strumento. Copilot esegue il mapping delle informazioni disponibili ai parametri dello strumento. Le istruzioni dovrebbero guidarlo a chiedere informazioni richieste mancanti piuttosto che inventare valori. Le chiamate esterne usano il comportamento di autenticazione e conferma configurato.
  4. Interpreta il risultato. Copilot usa i dati restituiti o l'errore per determinare il passaggio successivo. L'interazione può includere un'altra chiamata, una richiesta di chiarimenti o una risposta all'utente.
  5. Rispondere all'utente. Copilot genera una risposta usando il contesto e i risultati disponibili. La risposta deve riflettere ciò che il servizio ha effettivamente restituito o modificato.

Gli agenti dichiarativi supportano il concatenamento delle chiamate di funzione, incluso il passaggio dell'output di una chiamata API a un'altra e la combinazione di azioni API con la conoscenza di SharePoint o l'interprete del codice. Progetta e testa le interazioni richieste piuttosto che assumere un numero fisso di chiamate sempre completate in un turno. Segui le attuali limitazioni dei plug-in e i limiti dei tuoi servizi esterni.

Le protezioni della piattaforma e le conferme degli utenti non sostituiscono i controlli delle autorizzazioni o delle regole aziendali nel servizio esterno. Se il flusso di lavoro richiede un ordine esatto di esecuzione, transazioni o ripristino, implementare tali requisiti nel servizio anziché basarsi sulle istruzioni del modello.

In che modo l'agente di orchestrazione di Copilot abbina le azioni alle query degli utenti

La selezione del plug-in e la chiamata dei singoli strumenti sono decisioni diverse. La descrizione di un plug-in aiuta Copilot a identificare il servizio o il dominio pertinente. Gli strumenti disponibili da tale plug-in descrivono quindi le operazioni che Copilot può richiamare e gli input necessari.

Quando la selezione del plugin utilizza la corrispondenza semantica, la corrispondenza si basa sulla descrizione del plugin, non sulle descrizioni delle singole funzioni. Un plugin abbinato rende disponibili le sue funzioni o strumenti; Non è una lista fissa di cinque funzioni. Per il comportamento di selezione corrente e i vincoli di contesto, vedere Limitazioni dei plug-in MCP e API.

Fornisci descrizioni utili per ogni livello:

Configurazione Cosa descrivere
Descrizione del plug-in Scopo del servizio, attività utente supportate e dominio. Rendi la descrizione abbastanza specifica da distinguerla dagli altri plugin.
Definizione di funzione o utensile Scopo dell'operazione, quando usarla e se recupera o modifica i dati. Per i plug-in API, mappa il nome della funzione all'OpenAPI operationId.
Parametri Input, tipi, formati ed esempi significativi richiesti. Distinguere gli identificatori dai nomi visualizzati e rendere chiaro il comportamento facoltativo.
Risultati ed errori I dati restituiti, il significato di un'operazione completata e il modo in cui sono rappresentati gli errori. Mantenere i payload pertinenti all'attività.

Per i plug-in API, seguire Creare descrizioni OpenAPI efficaci. Per i plug-in MCP, controlla se le definizioni degli strumenti vengono individuate dinamicamente o aggiunte nel manifesto del plug-in. Con l'individuazione dinamica, le modifiche alle definizioni degli strumenti del server possono influire sulla selezione senza ripubblicare l'agente.

Migliorare e valutare la selezione delle azioni

Le descrizioni e le istruzioni influenzano la selezione. Non garantiscono che venga richiamato uno strumento specifico per ogni formulazione di una richiesta.

  • Chiarisci le operazioni sovrapposte. Se più strumenti sembrano adatti, spiega i loro diversi scopi e gli input richiesti. Distinguere le operazioni di lettura dalle operazioni che modificano i dati.
  • Collegare le attività agli strumenti nelle istruzioni. Spiegare quando usare gli strumenti configurati, come raccogliere le informazioni mancanti e come usare i risultati precedenti nelle richieste di completamento. Consulta le Istruzioni per gli agenti con plug-in API.
  • Mantieni focalizzati gli strumenti disponibili. Esporre le operazioni necessarie per le attività dell'agente. Più definizioni di strumenti e payload più grandi consumano il contesto e possono ridurre la qualità della risposta.
  • Testa le selezioni e i risultati effettivi. Includere prompt parafrasati, richieste ambigue, input mancanti, attività in più passaggi, conferme annullate ed errori di servizio. Controlla le operazioni e i parametri ricevuti dal servizio, non solo la formulazione finale.
  • Ripetere i test quando cambiano le definizioni. Riesegui casi rappresentativi dopo le modifiche alle descrizioni dei plug-in, alle definizioni degli strumenti, alle istruzioni o alla piattaforma. Includere gli aggiornamenti del server MCP quando si usa l'individuazione dinamica.

Importante

Una risposta conversazionale mancante o incompleta non stabilisce se un'operazione esterna è stata completata. Controllare il risultato del servizio prima di ripetere un'operazione che modifica i dati e progettare il servizio per gestire le richieste ripetute in modo sicuro.

Per raccomandazioni di progettazione più ampie, vedere Procedure consigliate per gli agenti dichiarativi. Per i test case e le asserzioni ripetibili, vedere Panoramica della valutazione degli agenti.