Playbook 是生成式代理的基本构建块。 生成式代理通常具有许多 playbook，其中每个 playbook 都定义为处理特定任务。playbook 数据被提供给 LLM，以便 LLM 获得回答问题和执行任务所需的信息。每个 Playbook 都可以提供信息、向外部服务发送查询，或者将对话处理推迟到流或其他 Playbook 来处理子任务。
限制
存在以下限制：
- 使用 Playbook 的客服人员不支持通过“默认初始流程”中的“默认欢迎 intent”路由发送来电伴侣短信，但您可以在标准流程中启用来电伴侣短信选项。
语言支持
手册支持与 Gemini 模型相同的语言。
地区支持
以下区域支持 Playbook：
globalasia-south1asia-southeast1asia-northeast1australia-southeast1eu（多区域）europe-west1europe-west2europe-west3northamerica-northeast1us（多区域）us-central1us-east1us-west1
Playbook 数据
剧本由以下数据组成：
- 手册名称：一个简洁的自然语言名称，有助于开发者和 LLM 了解该手册处理的任务
- 目标：简要说明该 Playbook 应实现的目标
- 说明：定义实现目标应采取的流程步骤
- 示例：对话示例，实际上是 LLM 的少样本提示示例
- 参数：用于存储与对话相关的信息，例如用户输入、用户系统信息、操作结果等。
Playbook 类型
创建 playbook 时，您可以选择所需的 playbook 类型：任务 playbook 或日常安排 playbook。
任务手册
任务 Playbook 是原始类型的 Playbook。它们用于将复杂任务分解为更小的可重复使用子任务。它们用于对组合对话阶段进行建模，其中每个阶段都通过输入和输出参数进行通信。
以下示例展示了一个任务 Playbook（调用方）调用另一个任务 Playbook（被调用方）：
- 调用方启动被调方。
- 调用方向被调用方提供必要的输入参数。
- 被调用方会处理此信息，执行其指定的函数，并返回输出参数。
- 调用方从被调用方接收参数。
任何日常安排或任务 Playbook 都可以调用其他任务 Playbook，但任务 Playbook 无法调用其他日常安排 Playbook。
例程 Playbook
常规 Playbook 是一种新型 Playbook。它们用于对顺序对话阶段进行建模，其中每个阶段都是完整且独立的。它们可以调用任务 Playbook 来将较大的任务分解为较小的子任务，还可以转换到其他常规 Playbook 或流程。
以下示例展示了常规 Playbook (A) 转换为另一个常规 Playbook (B)，然后转换为流程 (C)：
- 日常安排 Playbook A 可以在启动时读取会话参数，并在退出前写入会话参数。
- 例程 Playbook A 退出并转换为例程 Playbook B。
- 常规 Playbook B 可以在启动时读取会话参数，并在退出前写入会话参数。
- 常规 Playbook B 退出并转换为流程 C。
- Flow C 可以读取和写入会话参数。
如果常规 Playbook 未转换到其他常规 Playbook 或流程，会话将返回到上一个活跃流程，如果没有，则会结束。
例程 Playbook 具有以下参数管理行为：
- 输入常规 Playbook 后，系统会为其输入参数分配与同名会话参数等效的值。
- 当常规 Playbook 退出时，它会为其输出参数生成值，并将这些值分配给具有相同名称的会话参数。
默认的 Playbook
使用对话式代理控制台创建生成式代理时，系统会自动创建默认生成式 Playbook。
默认的 Playbook 是对话的起点，因此与其他 Playbook 有一些重要的区别：
- 默认的 Playbook 不会收到之前对话回合的摘要。
- 默认的 Playbook 无法定义或接收输入参数。
导入和导出 Playbook
使用对话式 AI 代理控制台创建 Playbook 后，您可以导出这些 Playbook 以便在其他 AI 代理中使用。如需导出 Playbook，请执行以下操作：
- 前往 Playbook 列表。
- 点击要导出的 Playbook 的导出按钮。
- 选择导出选项。
- 点击导出。
如需导入之前导出的 Playbook，请执行以下操作：
- 前往 Playbook 列表。
- 点击导入。
- 选择导入选项。
- 点击导入。