A playbook is the basic building block of generative agents. A generative agent typically has many playbooks, where each playbook is defined to handle specific tasks. The playbook data is provided to the LLM, so it has the information it needs to answer questions and execute tasks. Each playbook can provide information, send queries to external services, or defer conversation handling to a flow or another playbook to handle sub-tasks.
Limitations
The following limitations apply:
- Agents that use playbooks don't support sending a call companion SMS from the Default Welcome Intent route in the Default Start Flow, but you can enable the call companion SMS option in standard flows.
- The Agent Builder console does not support flows.
- Generative agents created in the Agent Builder console don't open in the Dialogflow CX console, unless the project is granted access to the restricted access feature in the Dialogflow CX console. To request access, contact your Google account team.
Language support
Playbooks support the same languages as Gemini models.
Region support
Playbooks are supported in the following regions:
global
asia-south1
asia-southeast1
australia-southeast1
eu
(multi-region)europe-west1
europe-west2
europe-west3
northamerica-northeast1
us
(multi-region)us-central1
us-east1
us-west1
Playbook data
A playbook is composed of the following data:
- Playbook name: a concise name in natural language that helps developers and the LLM to understand what tasks the playbook handles
- Goals: high level description of what the playbook should accomplish
- Instructions: defines the process steps that should be taken to accomplish the goal
- Examples: sample conversations that are effectively few-shot prompt examples for the LLM
- Parameters: are used to store information about a conversation like user input, user system information, results of actions, and so on.
Default playbook
When you create a generative agent using Agent Builder console, a default playbook is created automatically.
The default playbook is the starting point for conversations, so it has some important distinctions from other playbooks:
- The default playbook doesn't receive a summary of preceding conversation turns.
- The default playbook can't define or receive input parameters.
Agent Builder console agents vs Dialogflow CX console agents
Some projects have been granted access to the playbook restricted access feature in the Dialogflow CX console. The following table describes the currently supported playbook features for each console:
Capability | Dialogflow CX console | Agent Builder console |
---|---|---|
Release stage | Private GA | Public Preview |
Flows | ✅ | |
Input/output parameters for agents | ✅ | |
Function tools | ✅ (not supported in simulator) | ✅ |
Save simulator and conversation history as example | ✅ | |
Custom prompts for data store query rewrite and summarization | ✅ | |
Test cases | ✅ | |
Import and export | ✅ | |
VPC SC | Webhooks ✅ | Open API Tools ✅ |
Security and compliance | CMEK, AxT, DRZ | CMEK, AxT, DRZ |