Guide pratiche

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.
  • La console di Agent Builder non supporta i flussi.
  • Gli agenti generativi creati nella console di Agent Builder non si aprono nella console Dialogflow CX, a meno che al progetto non venga concesso l'accesso alla funzionalità di accesso limitato nella console Dialogflow CX. Per richiedere l'accesso, contatta il team dedicato all'account Google.

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 utente'utente, informazioni sul sistema dell'utente, risultati delle azioni e così via.

Playbook predefinito

Quando crei un agente generativo utilizzando la console di Agent Builder, viene creato automaticamente un playbook 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.

Agenti della console di Agent Builder e agenti della console di Dialogflow CX

Ad alcuni progetti è stato concesso l'accesso alla funzionalità di accesso limitato del playbook nella console Dialogflow CX. La tabella seguente descrive le funzionalità dei playbook attualmente supportate per ogni console:

Capacità Console di Dialogflow CX Console di Agent Builder
Fase di rilascio GA privato Anteprima pubblica
Flussi ✅
Parametri di input/output per gli agenti ✅
Strumenti di funzione ✅ (non supportato nel simulatore) ✅
Salvare il simulatore e la cronologia delle conversazioni come esempio ✅
Prompt personalizzati per la riscrittura e il riepilogo delle query dell'archivio dati ✅
Scenari di test ✅
Importazione ed esportazione ✅
VPC-SC Webhook ✅ Open API Tools ✅
Sicurezza e conformità CMEK, AxT, DRZ CMEK, AxT, DRZ