Configurare istruzioni di alta qualità per l'orchestrazione generativa

Questo articolo fornisce indicazioni su come scrivere le migliori istruzioni per il tuo agente quando utilizza l'orchestrazione generativa. Definisci le istruzioni nella pagina Panoramica del tuo agente.

L'agente utilizza le istruzioni nei seguenti modi:

• Per decidere quale strumento o conoscenza utilizzare per gestire una query dell'utente o un trigger autonomo.
• Per compilare gli input di qualsiasi strumento in base al contesto disponibile.
• Per generare una risposta all'utente finale.

Linguaggio per la scrittura delle istruzioni

Usare verbi come Get o Use per recuperare e analizzare i dati e parole come From e With per agire sui risultati.

Le parole seguenti vengono comunemente usate per creare istruzioni semplici:

Istruzioni di base in fonti e strumenti di conoscenza

Gli agenti non possono agire sulle istruzioni per usare strumenti o origini delle informazioni se l'agente non dispone di tali strumenti o fonti di informazioni. È necessario prima configurare l'agente con gli strumenti e le fonti di conoscenza appropriati. Ad esempio, se dai un'istruzione all'agente di cercare le domande frequenti in un sito Web, l'agente non può seguire tale istruzione a meno che non si aggiungono domande frequenti sul sito Web come origine della conoscenza in un argomento. Verifica che tutte le istruzioni fornite all'agente siano supportate negli strumenti e nella conoscenza configurati per l'agente.

Aiuta l'agente a determinare gli strumenti e le conoscenze appropriati per effettuare la chiamata.

Prima di aggiungere istruzioni per chiamare gli strumenti e le fonti di conoscenza giuste per il tuo agente, assicurati che ogni strumento e fonte di conoscenza segua le migliori pratiche per la scrittura delle descrizioni. Per ottenere i migliori risultati, il nome e la descrizione devono essere accurati e specifici, perché l'agente utilizza questi campi per determinare cosa chiamare. Usa la descrizione per indicare cosa non fare se vedi l'agente chiamarli al momento sbagliato.

Non è necessario definire gli strumenti o le fonti di conoscenza disponibili nelle istruzioni, poiché queste informazioni sono già disponibili all'agente. Puoi usare / mentre scrivi le istruzioni per specificare uno strumento, un argomento, una variabile o un'espressione Power Fx specifica per il tuo agente. Tuttavia, il tuo agente usa anche i nomi e le descrizioni degli strumenti o delle fonti di conoscenza per determinare quale strumento utilizzare, quindi non è necessario specificare strumenti specifici per il tuo agente.

Concentrati invece sull'aggiunta di istruzioni solo per i casi in cui vuoi fornire suggerimenti all'agente quando lo strumento o l'origine delle informazioni corretta potrebbe essere ambigua. Puoi anche fornire un'istruzione che faccia riferimento a più strumenti o fonti di conoscenza.

Use the FAQ documents only if the question is not relevant to Hours, Appointments, or Billing.
Only use the ticket creation topic for creating tickets.
For other requests related to fixing issues, use the troubleshooting topic.

Aiutare l'agente a scegliere le giuste fonti di conoscenza

Per garantire che l'agente recuperi correttamente le informazioni dalle origini delle informazioni, assicurarsi di spiegare i documenti da cercare nelle istruzioni. Ad esempio, "cercare nella Knowledge Base il documento di onboarding dei dipendenti". Anche se questo tipo di specificità non è strettamente necessario, può essere utile guidare l'agente. Questo tipo di specificità è utile quando sono presenti numerosi documenti che l'agente deve cercare.

Aiutare l'agente a scegliere la sequenza corretta di strumenti

L'agente tenta di selezionare lo strumento corretto e in genere ci riesce, ma è sempre bene essere espliciti nelle istruzioni. Ad esempio, se si vuole che l'agente crei un record dell'ordine di acquisto in Dataverse usando lo create order strumento , usare / e aggiungere tale strumento specifico alle istruzioni. In questo scenario, fornisci un'istruzione chiara: "Quando l'utente ha fornito i dati del proprio laptop preferito, crea un ordine di acquisto usando /Ordine di Acquisto." Questa specificità è utile quando sono stati aggiunti numerosi strumenti (più di cinque) all'agente.

Numera o elenca utilizzando punti elenco le tue istruzioni e specifica che l'agente deve seguirle in ordine. Puoi anche utilizzare il formato Markdown per migliorare la leggibilità delle tue istruzioni e aiutare l'IA generativa a comprenderle e processarle.

Quando si assegna un nome a uno strumento nelle istruzioni, assicurarsi di usare lo stesso nome dello strumento. Lievi differenze nell'assegnazione del nome possono influire negativamente sui risultati. Assicurarsi inoltre di usare / per la costruzione del nome specifico dello strumento (/"Tool_Name").

Se richiedi che il tuo agente sia molto specifico nel rispondere ai suggerimenti degli utenti, considera di creare un argomento adatto a questo caso d'uso specifico. Ad esempio, crea un argomento che riconosca frasi simili a "ci sono altre opzioni disponibili?" L'agente risponde poi specificamente: "Attualmente non sono disponibili altre opzioni, per favore seleziona dalla lista disponibile."

L'agente usa la descrizione dello strumento per capire perché usare tale strumento. Compilare la descrizione dello strumento aiuta l'agente a scegliere lo strumento corretto. Aggiungi una descrizione che informi l'agente quando chiamare uno strumento specifico, ad esempio "chiama questo strumento quando l'utente chiede di recuperare la cronologia delle prenotazioni del cliente."

I trigger potrebbero essere vulnerabili agli attacchi di jailbreak. Questo tipo di attacco è quello in cui un utente malintenzionato invia istruzioni da seguire per l'agente nel payload del trigger. Ad esempio, l'utente malintenzionato potrebbe chiedere all'agente di inviarsi un'e-mail con le informazioni a cui l'agente può accedere.

Per proteggere l'agente da questo rischio, assicurati che le relative istruzioni includano le informazioni seguenti:

• Limita gli strumenti che l'agente deve adottare quando fai riferimento alle fonti di conoscenza. Ad esempio, invia via e-mail le informazioni solo dopo aver verificato una fonte di conoscenza per il contesto.

• Limita quali parametri l'agente dovrebbe usare per gli strumenti. Ad esempio, invia tramite e-mail solo un elenco specificato di persone.

Se noti che il tuo agente blocca il comportamento normale usando il filtraggio dei contenuti, aggiorna le istruzioni dell'agente per indicare che il comportamento è previsto che funzioni.

Aiutare l'agente a riempire gli input per gli strumenti

L'agente potrebbe chiamare uno strumento con parametri di input che devono essere compilati. In questo caso, l'agente utilizza la cronologia delle conversazioni e le chiamate precedenti a strumenti e fonti di conoscenza per determinare quali dovrebbero essere gli input. Se l'agente non identifica tutti gli input, chiede all'utente di aiutare a compilare le informazioni mancanti.

In questo scenario, assicurati innanzitutto di configurare gli input per l'agente in base ai tipi di interazioni che prevedi che l'agente gestisca. Quindi, solo nelle situazioni in cui l'agente deve immettere il miglior input disponibile, utilizza le istruzioni per aiutare a compilare gli input.

Use the email address from the contact field of the lead when helping the user to draft an email to follow-up on a lead.

Aiutare l'agente a generare una risposta

Per prima cosa, usa le istruzioni per dare al tuo agente delle barriere quando non dovrebbe rispondere. L'agente genera una risposta dopo aver effettuato qualsiasi chiamata a strumenti o fonti di conoscenza rilevanti per lo scenario attuale. Se si attiva l'impostazione Consenti risposte non in primo piano nella sezione Knowledge delle impostazioni di intelligenza artificiale generativa dell'agente, l'agente può generare una risposta senza chiamare alcun strumento o origine delle informazioni.

Ecco un esempio di come utilizzare le istruzioni per le barriere protettive:

Only respond to messages that are relevant to Contoso corporation and ordering coffee. 
Otherwise, tell the user you can't help with their inquiry.

Se non vuoi che il tuo agente discuta un argomento specifico, aggiungi un argomento per questo scenario con una risposta scritta manualmente. In questo modo si evita di doversi basare solo sulle istruzioni per evitare l'argomento.

In secondo luogo, dai all'agente istruzioni su come dovrebbe formattare o strutturare le risposte. Ad esempio:

Always give responses about order status in a table format.

Se vuoi che il tuo agente sia professionale e parli educatamente, non devi dare istruzioni per questo tono, dato che è il comportamento predefinito dell'agente. Fornire istruzioni sul tono solo per casi d'uso specifici.

Istruzioni basate su conversazioni

Il seguente esempio mostra come formattare istruzioni basate sulla conversazione utilizzando una costruzione di vincoli,formato di risposta e linee guida. Combina questi tre elementi in uno solo per fornire un insieme completo di istruzioni per l'agente.

Vincoli

Only respond to requests to provide information about educational, legal, wellness, wellbeing, health, dental care, and newborn benefits for employees and dependents. 
Respond to benefit types with details, health plan comparisons available for employees and dependents in tabular format.
Answer in bold and underline fonts as necessary.

Formato risposta

Respond to inquiries by providing benefit types along with details, health plan comparisons available for employees and dependents in tabular format. 
Add a column for available options. 
Include insurance provider details and provide a link for enrollment. 
Answer in bold and underline fonts as necessary.

Linee guida

Search only within specific country folders relevant to the employee's country.

Istruzioni autonome

Il grafico seguente illustra i passaggi che un agente compie basandosi su istruzioni autonome:

Istruzioni e comportamento dell'agente

Usare le istruzioni dell'agente in Copilot Studio per influenzare la sintesi delle risposte dopo il recupero del documento. Le seguenti convinzioni sbagliate comuni e le migliori pratiche ti aiutano a progettare esperienze affidabili per gli agenti.

Comportamento delle schede adattive

Le istruzioni dell'agente non possono modificare la modalità di attivazione di Adaptive Cards.

Se invece si usa Adaptive Cards:

• Modifica direttamente la scheda adattiva.
• Regola le frasi attivatrici all'interno della configurazione della scheda per controllare quando appare.

Usare domande di completamento

Usa domande di approfondimento per chiarire l'intento, raccogliere input mancanti e far emergere azioni o conoscenze rilevanti. Quando si usa questo approccio, l'agente pone la domanda successiva corretta in base alle operazioni che può eseguire e a ciò che sa in fase di esecuzione.

Le seguenti avvertenze si applicano quando si usano domande di follow-up:

• Se l'impostazione Consenti risposte non in primo piano è disabilitata , le domande di completamento non funzionano.
• Se disabiliti questa impostazione, l'orchestratore considera che le domande chiarificanti che non hanno una citazione siano non fondamentate e le sopprime. Per impostazione predefinita, l'agente risponde con la seguente frase: "Mi dispiace, non sono sicuro di come aiutarti." Puoi provare a riformulare?"

Gli agenti possono anticipare le esigenze degli utenti e suggerire il prossimo passo logico basandosi sugli strumenti e le conoscenze a loro disposizione. Ad esempio, un agente che risponde a "Qual è il meteo oggi a Roma?" può offrire "Vuoi conoscere anche le previsioni per domani?" e poi agire sul "sì" dell'utente senza ulteriori chiarimenti.

Questo approccio riduce i percorsi di dialogo codificati in modo rigido. Invece, sposta l'onere dalla creazione di ogni possibile ramo al guidare il ragionamento dell'agente con istruzioni che fanno riferimento alle capacità dell'agente.

Quando si usano domande di follow-up, segui questa strategia:

• Fai riferimento agli strumenti, alle conoscenze e alle variabili nelle istruzioni affinché l'agente possa usarle per generare domande di follow-up consapevoli del contesto. Le istruzioni supportano direttamente agenti di riferimento, variabili, strumenti, conoscenze ed espressioni Power Fx.

• Chiedere all'agente di concludere le risposte con le domande di completamento pertinenti al contesto corrente e agli strumenti attivi dell'agente. Questo approccio consente un comportamento adattativo piuttosto che flussi fissi e fragili.

• Mantieni visibili esempi e ragionamenti nelle istruzioni così l'agente impara il modello atteso (cosa chiedere e perché). Elencare gli strumenti disponibili migliora la rilevanza e la naturalezza delle domande di follow-up, anche se l'orchestratore sa già quali strumenti sono attivi.

Modificare il messaggio di fallback predefinito

Le istruzioni personalizzate non possono eseguire l'override del messaggio di fallback predefinito.

Il messaggio predefinito è " Mi dispiace, non so come aiutarti. Puoi provare a riformulare?"

Per modificare il messaggio predefinito:

1. Vai all'argomento Fallback : Argomenti → Sistema → Fallback.

2. Nell'argomento Fallback , modifica il testo del Messaggio .

Termini ambigui

Evita frasi vaghe, ad esempio "casella di digitazione", nelle istruzioni. Questi tipi di termini sono ambigui per il modello linguistico e possono causare comportamenti imprevedibili.

Recupero delle informazioni di ricerca

Le istruzioni dell'agente non possono modificare la logica di recupero della ricerca. Rimuovi tutte le istruzioni che tentano di influenzare il recupero dei documenti.

Condivisione di documenti recuperati

Non puoi modificare la modalità di condivisione dei documenti recuperati. Il sistema controlla questo comportamento.

Includi un trigger

Modificare il payload del trigger predefinito per consentire all'agente di comprendere cosa fare quando viene richiamato il trigger. Utilizza le variabili per ridurre le dimensioni del payload. Creare il trigger, quindi modificarlo in Power Automate e selezionare variabili specifiche. Ad esempio, invia solo il campo dell'oggetto di un messaggio e-mail ricevuto, anziché l'intero payload del messaggio.

Può essere utile indicare all'agente cosa fare con il payload del trigger nelle istruzioni del trigger. Ad esempio, se l'agente aiuta i nuovi dipendenti a eseguire l'onboarding nell'azienda, definisci il payload del trigger come "Esegui l'onboarding del dipendente successivo". Questa istruzione è quindi seguita dal corpo del trigger, che contiene i dettagli del nuovo dipendente. Una volta che l'agente riceve il payload, segue le istruzioni definite per l'onboarding dei dipendenti.

Più condizioni di attivazione

Puoi aggiungere più trigger, ognuno con le proprie istruzioni. Queste istruzioni possono integrare le istruzioni generali dell'agente o essere utilizzate per diversi casi d'uso all'interno dello stesso agente, come la gestione dell'onboarding dei dipendenti e le segnalazioni di incidenti. Può essere utile assicurarsi che ogni payload del trigger indichi all'agente cosa fare quando il trigger viene attivato.

Formato e-mail

Chiedi al tuo agente di "inviare e-mail utilizzando la formattazione di testo arricchito per il contenuto del corpo dell'e-mail" o una formulazione simile. Puoi anche aggiungere questa richiesta nella descrizione dello strumento per enfasi aggiuntiva.

Supporto multilingue

Le istruzioni che richiedono supporto multilingue potrebbero funzionare, ma non è garantito. La funzionalità multilingue non è testata o ufficialmente supportata.

Punti chiave

• Usa le istruzioni dell'agente per il riepilogo e il flusso di conversazione, non per i comportamenti a livello di sistema.
• Usare la configurazione dell'argomento per il fallback e la personalizzazione delle schede adattive anziché le istruzioni.
• Convalidare funzionalità come il supporto multilingue prima di prometterle agli utenti.

Informazioni pertinenti

• Orchestrare il comportamento dell'agente con intelligenza artificiale generativa
• Riepilogo delle fonti di conoscenza
• Aggiungere strumenti agli agenti personalizzati
• Domande frequenti per l'uso dell'orchestrazione generativa