Architettura dell'agente dichiarativo

Gli agenti dichiarativi vengono eseguiti nell'infrastruttura di modelli linguistici e orchestrazione gestita di Microsoft 365 Copilot. È possibile configurare le istruzioni, le origini delle informazioni e le funzionalità supportate dell'agente anziché implementare e ospitare il proprio runtime conversazionale.

Un agente può usare le origini dati di Microsoft 365, le funzionalità predefinite come l'interprete di codice, le competenze personalizzate (anteprima) e le azioni fornite dai server MCP o dalle API REST. Può anche delegare attività agli agenti connessi. La disponibilità dipende dallo strumento di creazione, dalla versione del manifesto, dall'esperienza di destinazione, dalle licenze e dai criteri dell'organizzazione.

Usare questo articolo per comprendere il confine tra la piattaforma gestita e i componenti configurati o utilizzati. Per un confronto con un'architettura che offre il controllo sull'orchestrazione e sull'hosting di modelli, vedere Confronto tra agenti del motore dichiarativo e personalizzato.

Componenti dell'architettura

Microsoft 365 Copilot fornisce il runtime che interpreta le richieste degli utenti, recupera il contesto pertinente, seleziona le funzionalità e genera risposte. La configurazione e i servizi esterni determinano cosa può usare l'agente per completare un'attività.

Diagramma dell'architettura di un agente dichiarativo.

Componente Piattaforma gestita Responsabilità dello sviluppatore
Client Ospita conversazioni nelle esperienze di Microsoft 365 supportate. Scegli le esperienze di destinazione e verifica le interazioni supportate, il contesto del documento e i formati di risposta.
Infrastruttura Ospita l'orchestrazione Copilot e il runtime del modello. Configurare l'agente e ospitare eventuali API esterne, server MCP o altri servizi usati.
Catalogo e distribuzione Fornisce esperienze supportate di acquisizione, pubblicazione e amministrazione. Selezionare il pacchetto e la route di distribuzione supportati, mantenere le versioni e collaborare con gli amministratori all'accesso e alla distribuzione.
Sicurezza e conformità Applica le protezioni dell'identità, dell'accesso ai dati e della piattaforma di Microsoft 365. Configurare le autorizzazioni e l'autenticazione, valutare i flussi di dati e applicare l'autorizzazione e la protezione dei dati nei servizi esterni.
Agente di orchestrazione e modello linguistico Seleziona e richiama le funzionalità e genera risposte. Scrivi istruzioni e descrizioni degli strumenti, configura le impostazioni di comportamento supportate e valuta il comportamento risultante. L'agente di orchestrazione gestito non viene sostituito con codice di runtime personalizzato.
Conoscenze e capacità Recupera le conoscenze supportate ed esegue le funzionalità predefinite abilitate. Seleziona le origini e le funzionalità pertinenti, verifica l'accesso degli utenti e verifica la qualità del recupero.
Chiamata dello strumento Richiama le azioni MCP o API configurate tramite l'integrazione supportata. Definire gli input e gli output degli strumenti, configurare l'autenticazione e le conferme e implementare un comportamento del servizio affidabile.

Le impostazioni di configurazione supportate influenzano il runtime gestito; non ti danno il pieno controllo sulla sua implementazione. Ad esempio, il manifesto supporta una modalità di risposta predefinita, che gli utenti possono ignorare. Segui lo schema manifesto selezionato e lo strumento di creazione per le impostazioni disponibili.

Nota

Il contenuto recuperato e le risposte dello strumento possono contenere istruzioni non attendibili. Le protezioni della piattaforma non sostituiscono i controlli di autorizzazione nei servizi o la valutazione del comportamento dell'agente. Pianificare i requisiti di dati, privacy e sicurezza applicabili.

Flusso di dati dell'agente dichiarativo

Il flusso concettuale seguente descrive come un agente usa la configurazione e le funzionalità. Non è una sequenza di esecuzione fissa o una garanzia del numero di recuperi o chiamate di strumenti che si verificano.

  1. Ricevi una richiesta. L'utente invia una richiesta in un'esperienza supportata. La cronologia delle conversazioni e il contesto dell'app disponibile possono contribuire alla richiesta.
  2. Seleziona il contesto e le funzionalità pertinenti. Copilot usa le istruzioni dell'agente, la configurazione delle informazioni e le descrizioni degli strumenti per determinare come rispondere alla richiesta.
  3. Recuperare informazioni o richiamare azioni. Copilot recupera le conoscenze disponibili o chiama una funzionalità abilitata. Le azioni esterne usano il comportamento di autenticazione e conferma configurato. I servizi esterni applicano le proprie autorizzazioni e regole aziendali.
  4. Genera una risposta. Copilot usa il contesto disponibile e i risultati delle funzionalità per rispondere. A seconda dell'attività, l'interazione può includere ulteriori chiamate, richieste di input dell'utente o delega a un agente connesso.

Gli agenti dichiarativi possono concatenare chiamate API, utilizzare l'output di una chiamata come input di un'altra chiamata e combinare la conoscenza di SharePoint o l'interprete del codice con le azioni API. Per modelli ed esempi supportati, vedi Concatenamento delle chiamate di funzione nei plug-in API.

Le istruzioni guidano il comportamento del modello; Non sostituiscono la logica dell'applicazione che deve applicare una transazione, un ordine di esecuzione esatto o una procedura di ripristino. Implementa questi requisiti in un'API o in un servizio di flusso di lavoro o valuta un'architettura di motore personalizzata quando è necessario essere proprietari dell'orchestrazione.

Progettazione per limiti specifici della funzionalità

Controlla i limiti nelle linee guida per ogni funzionalità e integrazione. Il limite di caratteri di un campo manifesto, il limite di configurazione dell'origine conoscenza e il limite del contesto di runtime descrivono vincoli diversi.

Area Considerazioni sulla progettazione Indicazioni
Configurazione dell'agente Usare le proprietà e le funzionalità supportate dalla versione dello schema selezionata e dallo strumento di creazione. Informazioni di riferimento sul manifesto dell'agente dichiarativo
Recupero delle informazioni Selezionare le origini pertinenti e seguire i requisiti specifici dell'origine in base ai file, all'ambito, all'accesso e all'indicizzazione. Una risposta non include necessariamente ogni elemento in una fonte. Origini delle conoscenze e ottimizzazione del recupero del contenuto
Definizioni di strumenti e payload Mantieni gli strumenti focalizzati e gli input e gli output pertinenti. Gli input e gli output dei plug-in di grandi dimensioni possono essere troncati e i limiti di contesto effettivi possono cambiare con i modelli e il sovraccarico del sistema. Limitazioni dei plug-in MCP e API
Contesto del documento Seguire le interazioni con i documenti e i formati di contenuto supportati dall'app host anziché presumere che tutto il contenuto del documento sia rappresentato in modo identico. Interagire con i documenti
Comportamento e latenza del servizio Testa i tempi di risposta, gli errori di autenticazione, gli errori di servizio e i limiti delle API esterne o dei server MCP. Integrare e testare i componenti

Per set di dati di grandi dimensioni, progettare API per filtrare, aggregare o restituire il sottoinsieme pertinente anziché inviare tutti i record in una conversazione. Quando uno scenario richiede il contenuto del documento, testare l'esperienza host supportata: gli agenti dichiarativi possono accedere all'intero documento aperto in Word e PowerPoint, in base alle considerazioni sul formato del documento.

Vantaggi e limitazioni

I vantaggi principali e le limitazioni principali degli agenti dichiarativi consentono di determinare quando questa architettura è appropriata per casi d'uso specifici.

Vantaggi principali

Gli agenti dichiarativi offrono vantaggi significativi per le organizzazioni che vogliono implementare soluzioni di intelligenza artificiale all'interno di ambienti Microsoft 365 esistenti:

  • Runtime conversazionale gestito: Microsoft ospita l'agente di orchestrazione e l'infrastruttura del modello, quindi non è necessario implementare tale runtime.
  • Accesso alle funzionalità Microsoft: gli agenti possono usare le fonti di conoscenza supportate e le funzionalità integrate insieme a strumenti esterni.
  • Personalizzazione basata sulla configurazione: istruzioni, funzionalità e azioni consentono di personalizzare l'esperienza senza richiedere un motore di conversazione personalizzato. Le integrazioni esterne possono comunque richiedere codice e hosting.

Limitazioni principali

L'approccio dichiarativo introduce anche vincoli che potrebbero limitare determinati casi d'uso:

  • Orchestrazione gestita: influenzi il comportamento attraverso la configurazione supportata piuttosto che controllare ogni decisione di runtime. Valutare attività rappresentative invece di trattare le istruzioni come un motore di flusso di lavoro deterministico.
  • Dipendenze tra piattaforma e host: le funzionalità, la presentazione delle risposte, le licenze e l'amministrazione dipendono dall'esperienza di Microsoft 365 selezionata. Conferma il supporto in ogni host di destinazione.
  • Vincoli di contesto e recupero: il recupero delle conoscenze e i risultati dello strumento devono adattarsi al contesto disponibile. Grandi fonti o payload non garantiscono una copertura completa in una risposta.
  • Considerazioni sul contenuto Web dinamico: la ricerca Web con ambito usa il contenuto indicizzato di Bing anziché eseguire direttamente query sull'origine dati sottostante. I contenuti generati dinamicamente possono essere incompleti o obsoleti. Usa un'integrazione API supportata quando l'attività richiede l'accesso diretto a dati attuali e strutturati. Consultate Ricerca Web, radicamento e contenuti dinamici.
  • Valutazione continua: gli aggiornamenti della piattaforma e del modello possono modificare il comportamento. Testare le istruzioni, il recupero e l'uso dello strumento man mano che l'agente e le sue dipendenze evolvono.

Allineamento dei casi d'uso

Scegli l'architettura in base al controllo richiesto dalla soluzione, non semplicemente in base al fatto che l'attività abbia più passaggi.

Scenari ottimali

Gli agenti dichiarativi sono ottimali per:

  • Recupero delle informazioni: agenti che devono principalmente cercare e riepilogare informazioni da Microsoft 365 o da fonti esterne.
  • Azioni assistite: agenti che combinano conoscenze e azioni API o MCP supportate per aiutare gli utenti a completare un'attività.
  • Assistenza e analisi dei documenti: agenti che lavorano con il contesto dei documenti supportato o usano funzionalità come l'interprete di codice.
  • Miglioramento della produttività: attività che traggono vantaggio da un'esperienza di conversazione gestita all'interno di Microsoft 365.

Scenari non adatti

Prendi in considerazione un agente motore personalizzato o un flusso di lavoro implementato separatamente quando i requisiti includono:

  • Controllo runtime personalizzato: è necessario implementare la propria orchestrazione, l'hosting di modelli o l'interfaccia utente anziché usare il runtime Copilot gestito.
  • Processi aziendali durevoli: il sistema deve applicare l'ordine di esecuzione esatto, i limiti della transazione, i tentativi o il ripristino indipendentemente da una conversazione.
  • Elaborazione di dati su larga scala: l'attività richiede l'elaborazione esaustiva di un set di dati piuttosto che il recupero o l'analisi del contesto conversazionale pertinente. Eseguire tale elaborazione in un servizio ed esporre il risultato appropriato all'agente.
  • Accesso diretto a origini dinamiche: l'attività richiede risultati aggiornati e ordinati da un'origine che non è adeguatamente rappresentata nella ricerca Web. Fornire un'API supportata o un'integrazione MCP anziché basarsi solo sulla ricerca Web con ambito.

Questi requisiti non sempre escludono un agente dichiarativo come interfaccia di conversazione. Un servizio può essere proprietario del processo aziendale mentre l'agente raccoglie input, richiama un'azione supportata e presenta il risultato.