策略方案

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Playbook 是生成式代理的基本构建块。 生成式代理通常具有许多 playbook，其中每个 playbook 都定义为处理特定任务。playbook 数据被提供给 LLM，以便 LLM 获得回答问题和执行任务所需的信息。每个 Playbook 都可以提供信息、向外部服务发送查询，或者将对话处理推迟到流或其他 Playbook 来处理子任务。

限制

存在以下限制：

• 使用 Playbook 的客服人员不支持通过“默认初始流程”中的“默认欢迎 intent”路由发送来电助手短信，但您可以在标准流程中启用来电助手短信选项。

语言支持

请参阅语言参考中的“Playbook”列。已标记为支持 Playbook 的语言已通过 gemini-2.0-flash 和 gemini-1.5-flash-002 模型进行质量测试。

使用非英语时，您应使用目标语言定义示例，同时将说明保留为英语。对于某些语言和使用情形，如果您还以目标语言提供说明，可能会获得稍好一些的回答。

模型支持

您可以在以下位置选择在剧本中使用的 LLM 模型：

• 在代理级别选择 LLM 模型。

  • 在对话式 AI 客服控制台中，依次选择“客服设置”->“生成式 AI”->“Playbook”，然后从所有可用模型的下拉菜单中按显示名称选择模型。
  • 如果您使用 API 更新代理设置，请在 GenerativeSettings.llm_model_settings.model 字段中指定模型名称（请参阅 GenerativeSettings）。

• 在请求级别替换模型选择。

  • 在对 Playbook 进行测试时，在对话式 AI 控制台模拟器中，从下拉菜单中按显示名称选择模型。
  • 如果您是通过 API 测试客服人员，请在 DetectIntentRequest.query_params.llm_model_settings.model 字段中指定模型名称（请参阅 DetectIntentRequest）。

模型名称	模型显示名称	模型规范	发布阶段	适用区域
gemini-pro	gemini-1.0-pro-001	Gemini 1.0 Pro	GA	所有 Playbook 区域
gemini-1.5-flash	gemini-1.5-flash-001	Gemini 1.5 Flash	GA	所有 Playbook 区域
gemini-1.5-flash-002	gemini-1.5-flash-002	Gemini 1.5 Flash 002	公开预览版	所有 Playbook 区域
gemini-2.0-flash-001	gemini-2.0-flash-001	Gemini 2.0 Flash	公开预览版	在 Vertex AI 支持的欧盟、美国多区域和单区域中。

模型停用日期与 Vertex AI 中的日期一致。如需了解详情，请参阅模型版本。

地区支持

以下区域支持 Playbook：

• global
• asia-south1
• asia-southeast1
• asia-northeast1
• australia-southeast1
• eu（多区域）
• europe-west1
• europe-west2
• europe-west3
• northamerica-northeast1
• us（多区域）
• us-central1
• us-east1
• us-west1

Playbook 数据

剧本由以下数据组成：

• 手册名称：一个简洁的自然语言名称，有助于开发者和 LLM 了解该手册处理的任务
• 目标：简要说明该 Playbook 应实现的目标
• 说明：定义实现目标应采取的流程步骤
• 示例：对话示例，实际上是 LLM 的少样本提示示例
• 参数：用于存储与对话相关的信息，例如用户输入、用户系统信息、操作结果等。

Playbook 类型

创建 playbook 时，您可以选择所需的 playbook 类型：任务 playbook 或日常安排 playbook。

任务手册

任务 Playbook 是原始类型的 Playbook。它们用于将复杂任务分解为较小的可重复使用子任务。它们用于对组合对话阶段进行建模，其中每个阶段都通过输入和输出参数进行通信。

以下示例展示了一个任务 Playbook（调用方）调用另一个任务 Playbook（被调用方）：

1. 调用方启动被调方。
2. 调用方向被调用方提供必要的输入参数。
3. 被调用方会处理此信息，执行其指定的函数，并返回输出参数。
4. 调用方从被调用方接收参数。

任何日常安排或任务 Playbook 都可以调用其他任务 Playbook，但任务 Playbook 无法调用其他日常安排 Playbook。

例程 Playbook

常规 Playbook 是一种新型 Playbook。它们用于对顺序对话阶段进行建模，其中每个阶段都是完整且独立的。它们可以调用任务 Playbook 来将较大的任务分解为较小的子任务，还可以转换到其他常规 Playbook 或流程。

以下示例展示了常规 Playbook (A) 转换为另一个常规 Playbook (B)，然后转换为流程 (C)：

1. 日常安排 Playbook A 可以在启动时读取会话参数，并在退出前写入会话参数。
2. 例程 Playbook A 退出并转换为例程 Playbook B。
3. 常规 Playbook B 可以在启动时读取会话参数，并在退出前写入会话参数。
4. 常规 Playbook B 退出并转换为流程 C。
5. Flow C 可以读取和写入会话参数。

如果常规 Playbook 未转换到其他常规 Playbook 或流程，会话将返回到上一个活跃流程，如果没有，则会结束。

例程 Playbook 具有以下参数管理行为：

• 输入常规 Playbook 后，系统会为其输入参数分配与同名会话参数等效的值。
• 当常规 Playbook 退出时，它会为其输出参数生成值，并将这些值分配给具有相同名称的会话参数。

默认的 Playbook

使用对话式代理控制台创建生成式代理时，系统会自动创建默认生成式 Playbook。

默认的 Playbook 是对话的起点，因此与其他 Playbook 有一些重要的区别：

• 默认的 Playbook 不会收到之前对话回合的摘要。
• 默认的 Playbook 无法定义或接收输入参数。

导入和导出 Playbook

使用对话式 AI 代理控制台创建 Playbook 后，您可以导出这些 Playbook 以便在其他代理中使用。如需导出 Playbook，请执行以下操作：

1. 前往 Playbook 列表。
2. 点击要导出的 Playbook 的导出按钮。
3. 选择导出选项。
4. 点击导出。

如需导入之前导出的 Playbook，请执行以下操作：

1. 前往 Playbook 列表。
2. 点击导入。
3. 选择导入选项。
4. 点击导入。