Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Gli agenti dichiarativi personalizzano Microsoft 365 Copilot per scenari aziendali specifici tramite istruzioni, origini di conoscenza e funzionalità supportate. Usa queste procedure per mantenere concentrato un agente, configurare le sue azioni in modo sicuro e valutarne il comportamento man mano che si evolve.
Inizia con un gruppo di destinatari definito, un'attività utente e un risultato previsto. Per il limite tra il runtime gestito e i servizi gestiti, vedere Architettura dell'agente dichiarativo.
Nota
Questo articolo illustra gli agenti dichiarativi che usano il runtime gestito di Copilot. Se si sta creando un agente motore personalizzato che recupera i dati di grounding di Microsoft 365, seguire le procedure consigliate, le autorizzazioni e le limitazioni dell'API di recupero. Questa guida è separata dalla configurazione delle origini di conoscenza di un agente dichiarativo.
Componenti dell'agente dichiarativo
Scegliere ogni componente per supportare le attività previste dell'agente. Seguire i limiti dello strumento di creazione selezionato e dello schema del manifesto.
| Componente | Procedura consigliata |
|---|---|
| Name | Usare un nome distinto che trasmetta lo scopo dell'agente. Agent Builder consente fino a 30 caratteri; Il manifesto dell'agente dichiarativo consente fino a 100 persone. |
| Descrizione | Riepiloga le attività e il dominio in poche frasi precise, entro il limite di 1.000 caratteri. Mantieni istruzioni dettagliate sul comportamento nel campo delle istruzioni. |
| Istruzioni | Definisci lo scopo dell'agente, le attività supportate, l'origine e l'uso degli strumenti, il formato di output e il comportamento di errore entro il limite di 8.000 caratteri. |
| Fonti di conoscenza | Aggiungere fonti pertinenti per le domande previste. Confermare l'ambito, l'aggiornamento, le autorizzazioni e le licenze supportate. |
| Funzionalità predefinite | Abilita funzionalità come l'interprete di codice o il generatore di immagini solo quando supportano le attività previste. |
| Competenze personalizzate (anteprima) | Usa le competenze per istruzioni di attività, risorse o script modulari. Fai riferimento alle competenze configurate a un livello elevato anziché duplicare le istruzioni dettagliate. |
| Azioni | Usa plug-in MCP o API per le interazioni supportate con i servizi esterni. Descrivi lo scopo, gli input, gli output e le condizioni di errore di ogni strumento. |
| Argomenti per rompere il ghiaccio | Fornisci prompt rappresentativi che dimostrino le attività supportate. Non è richiesto un numero minimo. Testa ogni richiesta e segui i limiti dello strumento selezionato. |
Procedure consigliate per le istruzioni dell'agente
Usare le istruzioni per definire il modo in cui l'agente deve affrontare le attività previste:
- Indica il risultato e i confini. Descrivere ciò che l'agente aiuta gli utenti a realizzare, le informazioni necessarie e il modo in cui deve rispondere alle richieste non supportate.
- Rendere esplicito l'uso di sorgenti e strumenti. Identificare l'origine, la funzionalità o l'azione configurata applicata a ogni attività. Chiedi input mancanti invece di tirare a indovinare.
- Separare i passaggi dalla presentazione. Usa passaggi delle attività chiari dove l'ordine è importante e specifica il tono, la struttura e il livello di dettaglio previsti per le risposte.
- Pianificare informazioni mancanti ed errori. Descrivere come gestire le origini non disponibili, i risultati incompleti, l'accesso negato e le azioni non riuscite senza rivendicare l'esito positivo.
- Tieni le istruzioni separate dalla conoscenza. Non inserire istruzioni comportamentali in documenti di SharePoint o altre fonti di conoscenza per aggirare i limiti di istruzioni. Il contenuto recuperato non è un contenuto di istruzioni creato dal creatore attendibile.
Per modelli dettagliati, esempi e indicazioni sulle modifiche al modello, vedere Scrivere istruzioni efficaci. Per le attività che combinano la conoscenza con le chiamate API, consulta Scrivere istruzioni per gli agenti con i plug-in API.
Scegliere le fonti di conoscenza appropriate
Selezionare le origini dati in base alle domande a cui l'agente deve rispondere:
- Preferisci la pertinenza rispetto alla quantità. Definire l'ambito delle origini per i file, i siti, le chat o altri contenuti necessari per l'attività. Per SharePoint e file incorporati, seguire Ottimizza recupero contenuto.
- Abbinare il recupero ai requisiti di freschezza. Rivedi regolarmente il contenuto e la proprietà dell'origine. La ricerca Web con ambito usa il contenuto indicizzato di Bing, non una query diretta dei dati sottostanti. Per i dati strutturati correnti, valutare invece un'API supportata o un'azione MCP. Consultate Ricerca Web, radicamento e contenuti dinamici.
- Conferma l'accesso prima di condividere. Esegui il test con utenti che rappresentano i destinatari e le autorizzazioni previsti. Esamina il comportamento della condivisione di file incorporati separatamente dall'accesso ai file originali.
- Verificare il supporto per le funzionalità e le licenze. Le origini e le opzioni di definizione dell'ambito variano in base allo strumento di creazione e alla configurazione del tenant. Seguire la matrice di supporto delle fonti di conoscenza e le indicazioni per le licenze.
- Valuta il grounding, non solo la fluidità delle risposte. Verifica le domande con le risposte note e verifica che le risposte e le citazioni corrispondano alle fonti previste. Includere domande le cui risposte non sono disponibili.
L'aggiunta di origini non impedisce di per sé all'agente di usare la conoscenza del modello predefinita. Quando lo scenario richiede risposte basate sulla sorgente, impostare behavior_overrides.special_instructions.discourage_model_knowledge e true rafforzare l'uso previsto della fonte nelle istruzioni. Questo controllo non garantisce che le risposte usino solo origini configurate. Continuare a valutare l'attribuzione della fonte e il comportamento quando mancano le prove. Vedere Risposte di base alle origini delle conoscenze configurate e il riferimento alle istruzioni speciali.
Progetta azioni sicure
Usare le azioni per le interazioni supportate con i servizi esterni e distinguerle dalle origini delle informazioni. Un connettore Copilot usato per la messa a terra non è intercambiabile con un'API o uno strumento MCP che modifica i dati esterni.
- Descrivere le operazioni in modo preciso. Spiegare quando è necessario usare uno strumento, i parametri richiesti, i risultati e gli errori previsti. Per le API REST, seguire le indicazioni per i documenti OpenAPI.
- Configurare le conferme per l'integrazione. Per i plug-in API, utilizzare l'estensione
x-openai-isConsequentialOpenAPI , notisConsequential, e contrassegnare le operazioni con effetti collaterali come consequenziali. Per gli strumenti MCP, utilizzarereadOnlyHintsolo per gli strumenti di sola lettura. Segui le richieste di conferma per i plug-in MCP e API per le impostazioni e il comportamento supportati. - Imporre l'accesso al servizio. Usa il metodo di autenticazione supportato e convalida l'autorizzazione e gli input nel servizio esterno. Le istruzioni e le richieste di conferma non sostituiscono tali controlli.
- Progettazione per errori e richieste ripetute. Verificare conferme negate, autenticazione scaduta, input non validi ed errori di servizio. Per le operazioni che modificano i dati, assicurarsi che i tentativi non ripetano inavvertitamente la modifica.
Usa i dati del piano, la privacy e la sicurezza per identificare i flussi di dati, le autorizzazioni e i requisiti di supervisione umana per ogni azione.
Eseguire test e iterazioni
Definire il comportamento previsto prima di modificare l'agente e mantenere un set ripetibile di test case. Per un feedback tempestivo, usare l'esperienza di test dello strumento di creazione e quindi convalidare l'agente distribuito negli host previsti.
| Area di test | Elementi da verificare |
|---|---|
| Attività supportate | Spunti di conversazione, formulazioni realistiche dell'utente e domande di follow-up producono i risultati desiderati. |
| Informazioni mancanti o non supportate | L'agente chiede gli input necessari, spiega le prove non disponibili e non inventa fatti o afferma che le azioni non andate a buon fine sono state completate. |
| Grounding e autorizzazioni | Le risposte e le citazioni corrispondono alle fonti previste. Testare gli utenti con accessi diversi e verificare che le informazioni con restrizioni non siano esposte. |
| Azioni ed errori | Controllare il risultato esterno effettivo e la risposta. Conferme di test, annullamenti, errori di autenticazione, errori di servizio e richieste ripetute. |
| Esperienza host | Testare ogni app supportata in cui si intende eseguire la distribuzione. Controlla il contesto del documento, la presentazione delle risposte e le funzionalità disponibili anziché presumere un comportamento identico in tutte le app. |
| Prestazioni e modifiche | Misura i tempi di risposta ed esegui nuovamente i casi di regressione dopo modifiche a istruzioni, conoscenze, strumenti, abilità o comportamento della piattaforma. |
Includi gli utenti che non hanno scritto le istruzioni in modo che i test acquisiscano formulazioni e ipotesi impreviste. Trasformare problemi riproducibili segnalati dagli utenti in casi di regressione.
Per la progettazione del caso di test, le asserzioni e la valutazione ripetibile, vedere Panoramica della valutazione degli agenti. Per i controlli di rilascio, vedi Convalida dell'intelligenza artificiale responsabile e Convalidare e testare il plug-in.
Contenuti correlati
- Creare agenti con Generatore di agenti
- Creare agenti con gli strumenti di sviluppo di Work IQ (consigliato per scenari pro-code supportati)
- Scrivere istruzioni efficaci per gli agenti dichiarativi
- Aggiungere origini conoscenza all'agente dichiarativo
- Richieste di conferma per i plug-in MCP e API
- Panoramica della valutazione dell'agente
- Linee guida per la convalida degli agenti