Guide pratiche

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: la funzionalità Playbook è esclusa dall'SLA di Dialogflow.

Un playbook è l'elemento di base degli agenti generativi. Un agente generativo in genere ha molti playbook, in cui ogni playbook è definito per gestire attività specifiche. I dati del playbook vengono forniti all'LLM, in modo che disponga delle informazioni necessarie per rispondere alle domande ed eseguire le attività. Ogni playbook può fornire informazioni, inviare query a servizi esterni o rimandare la gestione della conversazione a un flusso o a un altro playbook per gestire le sottoattività.

Limitazioni

Si applicano le seguenti limitazioni:

• Gli agenti che utilizzano i playbook non supportano l'invio di un SMS di compagno di chiamata dal percorso dell'intent di benvenuto predefinito nel flusso di inizio predefinito, ma puoi attivare l'opzione di SMS di compagno di chiamata nei flussi standard.

Supporto dei linguaggi

I playbook supportano le stesse lingue dei modelli Gemini.

Supporto per le regioni

I playbook sono supportati nelle seguenti regioni:

• global
• asia-south1
• asia-southeast1
• asia-northeast1
• australia-southeast1
• eu (più regioni)
• europe-west1
• europe-west2
• europe-west3
• northamerica-northeast1
• us (più regioni)
• us-central1
• us-east1
• us-west1

Dati del playbook

Un playbook è composto dai seguenti dati:

• Nome del playbook: un nome conciso in linguaggio naturale che aiuta gli sviluppatori e il LLM a capire quali attività gestisce il playbook
• Obiettivi: descrizione di alto livello di ciò che il playbook deve realizzare
• Istruzioni: definisce i passaggi della procedura da seguire per raggiungere l'obiettivo
• Esempi: conversazioni di esempio che sono effettivamente esempi di prompt few-shot per l'LLM
• Parametri: vengono utilizzati per memorizzare informazioni su una conversazione, come input dell'utente, informazioni sul sistema dell'utente, risultati delle azioni e così via.

Tipi di playbook

Quando crei un playbook, seleziona il tipo di playbook che ti interessa: playbook di attività o playbook di routine.

Playbook di attività

I playbook di attività sono il tipo originale di playbook. Vengono utilizzati per suddividere le attività complesse in attività secondarie più piccole e riutilizzabili. Vengono utilizzati per modellare le fasi di conversazione compositive, dove ogni fase comunica tramite parametri di input e output.

Di seguito è riportato un playbook di attività (chiamatore) che chiama un altro playbook di attività (chiamato):

1. Il chiamante avvia la chiamata.
2. L'utente che chiama fornisce i parametri di input necessari all'utente chiamato.
3. Il chiamante elabora queste informazioni, esegue la funzione designata e restituisce i parametri di output.
4. Il chiamante riceve i parametri dal chiamato.

Qualsiasi playbook di routine o attività può chiamare un altro playbook di attività, ma un playbook di attività non può chiamare un altro playbook di routine.

Playbook di routine

I playbook di routine sono un nuovo tipo di playbook. Vengono utilizzati per modellare le fasi di conversazione sequenziali, in cui ogni fase è completa e indipendente. Possono chiamare playbook di attività per scomporre attività più grandi in sottoattività più piccole e possono passare ad altri flussi o playbook di routine.

Di seguito è riportato un playbook di routine (A), la transizione a un altro playbook di routine (B), la transizione a un flusso (C):

1. Il playbook di routine A può leggere i parametri di sessione all'avvio e scrivere i parametri di sessione appena prima di uscire.
2. Il playbook di routine A esce e passa al playbook di routine B.
3. Il playbook di routine B può leggere i parametri di sessione all'avvio e scrivere i parametri di sessione appena prima di uscire.
4. Il playbook di routine B esce ed esegue la transizione al flusso C.
5. Il flusso C può leggere e scrivere i parametri di sessione.

Se un playbook di routine non passa a un altro playbook o flusso di routine, la sessione tornerà all'ultimo flusso attivo o terminerà se non ce ne sono.

I playbook di routine hanno il seguente comportamento di gestione dei parametri:

• Quando viene inserito un playbook di routine, ai suoi parametri di input vengono assegnati valori equivalenti ai parametri di sessione con lo stesso nome.
• Quando un playbook di routine esce, genera valori per i relativi parametri di output e li assegna ai parametri di sessione con lo stesso nome.

Playbook predefinito

Quando crei un agente generativo utilizzando la console degli agenti conversazionali, viene creato automaticamente un playbook generativo predefinito.

Il playbook predefinito è il punto di partenza per le conversazioni, pertanto presenta alcune distinzioni importanti rispetto agli altri playbook:

• Il playbook predefinito non riceve un riepilogo delle svolte della conversazione precedente.
• Il playbook predefinito non può definire o ricevere parametri di input.

Importare ed esportare playbook

Dopo aver creato i playbook utilizzando la console Agent conversazionali, puoi esportarli per utilizzarli in un altro agente. Per esportare un playbook:

1. Vai all'elenco dei playbook.
2. Fai clic sul pulsante di esportazione del playbook che vuoi esportare.
3. Seleziona le opzioni di esportazione.
4. Fai clic su Esporta.

Per importare un playbook che hai esportato in precedenza:

1. Vai all'elenco dei playbook.
2. Fai clic su Importa.
3. Seleziona le opzioni di importazione.
4. Fai clic su Importa.