Configurare istruzioni di alta qualità per l'orchestrazione generativa

Questo articolo fornisce indicazioni su come scrivere le istruzioni migliori per l'agente quando quest'ultimo utilizza l'orchestrazione generativa. Le istruzioni sono definite nella pagina Panoramica dell'agente.

Le istruzioni vengono utilizzate dall'agente nei seguenti modi:

• Per decidere quale risorsa o conoscenza chiamare per rispondere a una query dell'utente o a un'attivazione automatica.
• Per compilare gli input per qualsiasi strumento in base al contesto disponibile.
• Per generare una risposta all'utente finale.

Linguaggio per la scrittura delle istruzioni

Usa verbi come Recupera o Usa per recuperare e analizzare i dati e parole come Da e Con per agire sui risultati.

Le seguenti parole sono comunemente usate per creare semplici istruzioni:

Istruzioni di base nelle fonti delle informazioni e negli strumenti

Gli agenti non possono agire sulle istruzioni per usare strumenti o ricerche nella fonti di informazioni se l'agente non dispone di tali strumenti o fonti delle informazioni. È necessario prima configurare l'agente con gli strumenti e le fonti delle informazioni 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 fonte delle informazioni in un argomento. Verifica che tutte le istruzioni fornite all'agente siano supportate negli strumenti e nella conoscenza configurati per l'agente.

Consente all'agente di determinare gli strumenti e le conoscenze appropriati da chiamare

Prima di aggiungere istruzioni per chiamare gli strumenti corretti e le fonti delle informazioni per l'agente, verifica che ogni strumento, agente, argomento e fonte delle informazioni stia seguendo le procedure consigliate per la creazione di descrizioni. Per ottenere risultati ottimali, il nome e la descrizione devono essere accurati e specifici, perché questi campi sono quelli utilizzati dall'agente per determinare cosa richiamare. Usa la descrizione per indicare cosa non fare se vedi che l'agente li sta chiamando nel momento sbagliato.

Non è necessario definire gli strumenti o le fonti delle informazioni disponibili nelle istruzioni, perché queste informazioni sono già disponibili per l'agente. Puoi usare / durante la scrittura di istruzioni per specificare uno strumento, un argomento o una variabile specifica o un'espressione Power Fx per l'agente. Tuttavia, l'agente usa anche gli strumenti o i nomi e le descrizioni delle fonti delle informazioni per determinare quale usare, quindi non è necessario specificare quelli specifici per l'agente.

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

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 delle informazioni

Per aiutare il tuo agente a recuperare con successo le informazioni dalle fonti di informazioni, assicurati di spiegare quali documenti cercare nelle istruzioni. Ad esempio, «cerca nella tua KB il documento di onboarding dei dipendenti.» Anche se questo tipo di specificità non è strettamente necessario, può essere utile guidare il tuo agente. Questo tipo di specificità è utile quando ci sono 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 desideri che l'agente crei un record per l'ordine di acquisto in Dataverse usando lo strumento create order, usa / e aggiungi tale strumento specifico alle istruzioni. In questo scenario, viene fornita un'istruzione chiara: "Quando l'utente ha fornito i dettagli del computer portatile preferito, creare un ordine di acquisto usando/Ordine di acquisto". Questa specificità è utile in cui sono disponibili numerosi strumenti (più di cinque) aggiunti 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 ed elaborarle.

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

Se richiedi che il tuo agente sia molto specifico quando risponde all'input dell'utente, potrebbe essere opportuno creare un argomento per gestire questo particolare caso d'uso. Ad esempio, la creazione di un argomento che riconosca frasi simili a "ci sono altre opzioni disponibili?" L'agente risponde in modo specifico: "Al momento non sono disponibili altre opzioni, seleziona dall'elenco di quelle disponibili."

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 informa l'agente su quando chiamare uno strumento specifico, ad esempio "chiama questo strumento quando l'utente chiede di recuperare la cronologia delle prenotazioni dei clienti".

I trigger potrebbero essere vulnerabili ad attacchi 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 inviare a se stesso 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 delle informazioni. Ad esempio, invia via e-mail le informazioni solo dopo aver verificato una fonte delle informazioni per il contesto.

• Limita i parametri che l'agente deve utilizzare per gli strumenti. Ad esempio, invia tramite e-mail solo un elenco specificato di persone.

Se noti che l'agente blocca il comportamento normale con il filtro del contenuto, puoi aggiornare le istruzioni dell'agente ad indicare il comportamento che ci si aspetta.

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 usa la cronologia delle conversazioni e le chiamate precedenti agli strumenti e alle fonti delle informazioni per determinare quali devono essere gli input. Se l'agente non identifica tutti gli input, chiede aiuto all'utente per la compilazione delle 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

Innanzitutto, utilizza le istruzioni per fornire al tuo agente delle linee guida per quando non dovrebbe rispondere. L'agente genera una risposta dopo aver effettuato chiamate a strumenti o le fonti delle informazioni rilevanti per lo scenario corrente. Se attivi l'impostazione Consenti risposte non fondate nella sezione Conoscenza delle impostazioni di IA generativa del tuo agente, l'agente può generare una risposta senza chiamare alcuno strumento o fonte delle informazioni.

Di seguito è riportato un esempio di come utilizzare le istruzioni per le linee guida:

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 hai un argomento specifico che non vuoi che l'agente discuta, puoi aggiungere 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, fornisci all'agente istruzioni su come 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 è necessario dare istruzioni per questo tono, poiché è il comportamento predefinito dell'agente. Fornire istruzioni sul tono solo per casi d'uso specifici.

Istruzioni basate sulle conversazioni

Nell'esempio seguente viene illustrato come formattare le istruzioni basate sulla conversazione, utilizzando una costruzione di vincoli, formato delle risposte e indicazioni. Combina questi tre elementi in uno solo per fornire un set 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 eseguiti da un agente in base a istruzioni autonome:

Istruzioni e comportamento dell'agente

Utilizza le istruzioni dell'agente in Copilot Studio per influenzare il riepilogo delle risposte dopo il recupero del documento. Sono elencate le procedure consigliate e i malintesi comuni seguenti che consentono di progettare esperienze affidabili degli agenti.

Comportamento delle schede adattive

Le istruzioni dell'agente non possono modificare la modalità di attivazione delle schede adattive.

Se invece utilizzi schede adattive:

• Modifica direttamente la scheda adattiva.
• Regola le frasi trigger all'interno della configurazione della scheda per controllare quando viene visualizzata.

Usare domande di completamento

Usa domande di follow-up per chiarire l'intento, raccogliere input mancanti ed evidenziare azioni o informazioni rilevanti. Quando si utilizza questo approccio, l'agente pone la domanda giusta successiva in base a ciò che può fare e a ciò che sa durante l'esecuzione.

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

• Se l'impostazione Consenti risposte senza fondamento è disattivata, le domande di follow-up non funzionano.
• Se disabiliti questa impostazione, l'orchestratore considera le domande chiarificative senza citazione non fondate e le sopprime. Per impostazione predefinita, l'agente ha la risposta seguente: "Mi dispiace, non so come aiutarti. Puoi provare a riformulare?"

Gli agenti possono anticipare le esigenze degli utenti e suggerire il prossimo passaggio logico in base agli strumenti e alle conoscenze a loro disposizione. Ad esempio, un agente che risponde a «Qual è il tempo oggi a Roma?» può proporre «Vuoi sapere anche le previsioni per domani?» e poi procedere in base al «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 ramificazione al guidare il ragionamento dell'agente tramite istruzioni che fanno riferimento alle sue capacità.

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 contestualizzate. Le istruzioni supportano direttamente il riferimento a agenti, variabili, strumenti, conoscenze e espressioni Power Fx.

• Chiedi all'agente di concludere le risposte con domande di follow-up pertinenti al contesto attuale 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. Passa all'argomento Fallback: Argomenti → Sistema → Fallback.

2. Nell'argomento Fallback, modifica il testo 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 della 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

Modifica il payload del trigger predefinito per aiutare l'agente a capire cosa fare quando il trigger viene richiamato. Utilizza le variabili per ridurre le dimensioni del payload. Crea il trigger e quindi lo modifica usando Power Automate per 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ù trigger

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

• Mantieni le istruzioni per l'agente il più semplici e brevi possibile.
• Usa le istruzioni dell'agente per il riepilogo e il flusso di conversazione, non per i comportamenti a livello di sistema.
• Utilizza la configurazione dell'argomento per la personalizzazione delle schede adattive e di fallback, anziché le istruzioni.
• Convalida le funzionalità come il supporto multilingue prima di prometterle agli utenti.

Informazioni correlate

• Orchestrare il comportamento dell'agente con l'IA generativa
• Riepilogo delle fonti delle informazioni
• Aggiungere strumenti agli agenti personalizzati
• Domande frequenti per l'uso dell'orchestrazione generativa