Best practice per i playbook

Le seguenti best practice possono aiutarti a creare agenti solidi.

Nome del playbook in linguaggio naturale

Utilizza un linguaggio naturale con significati chiari per i nomi dei playbook. Ad esempio, "Cliente Guida pratica del Centro assistenza" è più descrittivo di "company_specialist", il che consente le prestazioni degli LLM in fase di runtime.

Obiettivi concisi

Gli obiettivi devono essere una descrizione concisa dello scopo del playbook.

Fornisci istruzioni di qualità

Le istruzioni devono:

  • Riflettano l'approccio passo passo per risolvere un problema dell'utente finale
  • essere frasi concise in linguaggio naturale di istruzioni di alto livello
  • essere semplice e specificare gli scenari di utilizzo dello strumento

Almeno un esempio per ogni playbook

Devi avere almeno uno esempio per ogni playbook, ma ti consigliamo di averne almeno quattro. Gli esempi devono includere scenari di buon esito.

Senza esempi sufficienti, è probabile che un playbook generi un comportamento imprevedibile. Se la guida pratica non risponde o non si comporta come previsto, esempi mancanti o mal definiti sono probabilmente la causa. Prova a migliorare gli esempi o ad aggiungerne di nuovi.

Precisione di istruzioni ed esempi

Aiuta scrivere istruzioni chiare e descrittive, ma la qualità e la quantità dei tuoi esempi che determinano l'accuratezza del comportamento del playbook. In altre parole, spendi più tempo a scrivere esempi dettagliati che a scrivere istruzioni perfettamente precise.

Strumenti di riferimento negli esempi

Se il playbook è progettato per fornire risposte utilizzando strumenti, fai riferimento agli strumenti negli esempi corrispondenti a questo tipo di richiesta.

Campo operationId dello schema dello strumento

Quando definisci gli schemi per i tuoi strumenti, il valore operationId è importante. Le istruzioni del playbook faranno riferimento a questo valore. Di seguito sono riportati alcuni consigli per la denominazione di questo campo:

  • Solo lettere, numeri e trattini bassi.
  • Deve essere univoco tra tutti i valori operationId descritti nello schema.
  • Deve essere un nome significativo che rifletta la funzionalità fornita.

Convalida dello schema dello strumento

Devi convalidare lo schema dello strumento. Puoi utilizzare lo Editor di Swagger per controllare la sintassi dello schema openAPI 3.0.

Gestire i risultati dello strumento vuoti

Quando il playbook si basa su uno strumento per definire la risposta, un risultato dello strumento vuoto può portare a un comportamento imprevedibile del playbook. A volte, l'LLM informazioni allucinazioni in una risposta al posto del risultato di uno strumento. Per evitare questo, puoi aggiungere istruzioni specifiche per assicurarti che l'LLM del playbook non provi a rispondere autonomamente.

Alcuni casi d'uso richiedono che le risposte dei playbook siano ben basate sui risultati degli strumenti o ha fornito i dati e ha bisogno di mitigare le risposte in base solo agli LLM dei playbook conoscenze.

Esempi di istruzioni per attenuare le allucinazioni:

  • "Devi utilizzare lo strumento per rispondere a tutte le domande degli utenti"
  • "Se non ricevi dati dallo strumento, rispondi che non conosci la risposta alla query dell'utente"
  • "Non inventarti una risposta se lo strumento non restituisce dati"

Generare uno schema con Gemini

Gemini generare uno schema per te. Ad esempio, prova a dire "puoi creare uno schema openAPI 3.0 di esempio per Google Calendar".

Playbook incentrati

Evita di creare playbook molto grandi e complessi. Ogni playbook deve svolgere un'attività specifica e chiara. Se hai un playbook complesso, valuta la possibilità di suddividerli in playbook secondari più piccoli.

Evitare loop e ricorsione

Non creare loop o ricorsi durante il collegamento degli agenti nelle tue istruzioni.

Fornire informazioni sul routing agli esempi

Quando un playbook deve indirizzare a un altro playbook, devi fornire queste informazioni agli esempi. Viene fornito a un esempio del campo Esempio finale con informazioni sull'output della sezione degli esempi Input e output.

Ad esempio, la frase finale di questo campo potrebbe essere "Ripristina il playbook predefinito per ulteriori query".

Utilizzare le funzioni JavaScript di Messenger per gli agenti conversazionali (Dialogflow CX) per la personalizzazione

Quando utilizzi Messenger per gli agenti conversazionali (Dialogflow CX), le seguenti funzioni sono utili per inviare informazioni sulla personalizzazione dell'utente dall'interfaccia web al playbook: