Guide pratiche

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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.

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.