Best practice

Le seguenti best practice possono aiutarti a creare solide app per agenti.

Nome dell'agente in linguaggio naturale

Utilizza un linguaggio naturale con significati chiari per i nomi degli agenti. Ad esempio, "Cliente Agente 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 dell'agente.

Fornisci istruzioni di qualità

Le istruzioni devono:

  • Rispecchiare l'approccio per risolvere un problema dell'utente finale, passo dopo passo
  • essere frasi in linguaggio naturale concise di istruzioni di alto livello
  • essere chiari e specificare gli scenari per l'utilizzo degli strumenti

Almeno un esempio per ogni agente

Devi avere almeno uno esempio per ogni agente, ma ti consigliamo di averne almeno quattro. Gli esempi dovrebbero includere scenari di percorso felice.

Senza un numero sufficiente di esempi, è probabile che un agente provochi comportamenti imprevedibili. Se l'agente 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 dell'agente. In altre parole, dedica più tempo alla scrittura di esempi completi che scrivere istruzioni perfettamente precise.

Strumenti di riferimento negli esempi

Se l'agente è progettato per fornire risposte utilizzando strumenti, fai riferimento alle disponibili 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 dell'agente faranno riferimento a questo valore. Di seguito sono riportati alcuni suggerimenti 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 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 degli strumenti vuoti

Quando l'agente fa affidamento su uno strumento per fornire la sua risposta, viene restituito uno strumento vuoto possono determinare comportamenti imprevedibili degli agenti. A volte, l'LLM dell'agente informazioni allucinazioni in una risposta al posto del risultato di uno strumento. Per evitare che questo accada, puoi aggiungere istruzioni specifiche per assicurarti che l'LLM dell'agente non tenti di la risposta in modo autonomo.

Alcuni casi d'uso richiedono che le risposte degli agenti siano ben fondate sui risultati o ha fornito i dati e ha bisogno di mitigare le risposte in base solo agli LLM dell'agente conoscenze.

Esempi di istruzioni per attenuare le allucinazioni:

  • "Devi utilizzare lo strumento per rispondere a tutte le domande degli utenti"
  • "Se lo strumento non recupera dati, rispondi che non conosci risposta alla query dell'utente"
  • "Non inventare una risposta se non ottieni alcun dato dallo strumento"

Genera uno schema con Gemini

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

Agenti interessati

Evita di creare agenti molto grandi e complessi. Ogni agente deve svolgere un'attività specifica e chiara. Se hai un agente complesso, valuta la possibilità di suddividerlo in sub-agenti più piccoli.

Evitare loop e ricorsi

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

Fornisci informazioni sui percorsi agli esempi

Quando un agente deve reindirizzare a un altro agente, è necessario fornire queste informazioni agli esempi. Fornisce un esempio tratto dalla sezione Fine esempio con informazioni di output del campo Input & Sezione di esempio.

Ad esempio, l'ultima frase di questo campo "Reindirizza nuovamente all'agente predefinito per ulteriori query."

Utilizza le funzioni JavaScript di Dialogflow CX Messenger per la personalizzazione

Quando usi Dialogflow CX Messenger, le seguenti funzioni sono utili per inviare messaggi di personalizzazione le informazioni dall'interfaccia web all'agente: