本指南介绍了如何使用 Playbook 构建和测试简单的衬衫订购代理。与此代理互动时，您可以查询商店位置、获取商店营业时间或创建衬衫订单。
准备工作
在阅读本指南之前，请先完成以下事项：
- 如果您尚未完成，请按照 Dialogflow 设置说明操作。
Playbook 简介
代理由一个或多个 Playbook 组成。每本手册都有明确定义且有限的范围。模板包含以下数据：
| X | 项 |
|---|---|
| 名称 | 用于标识 Playbook 的名称。 |
| 目标 | 目标是对该手册应实现的目标的概要说明。 |
| 说明 | 说明是指为实现手册目标而应采取的概要步骤。 |
| 示例 | 示例是最终用户与代理之间的对话示例。这些示例实际上是 LLM 的少样本提示示例。 |
创建代理
如需创建代理，请执行以下操作：
前往 Agent Builder 控制台：
从控制台下拉菜单中选择您的项目。
如果您尚未激活该 API，请阅读并同意服务条款，然后点击继续并激活 API。
点击创建新应用或新应用。
选择代理。
为应用名称提供“Shirt Ordering Assistant”。
选择区域。
点击创建。
界面会将您定向到名为 Default Agent 的默认 Playbook。
点击返回按钮，查看 Playbook 列表。
创建有序 Playbook
Order 手册用于处理衬衫订单。如需创建此 Playbook，请执行以下操作：
- 点击创建。
- 输入名称：
Order。 输入以下目标：
You are a shirt store ordering assistant. Help customers purchase shirts. Help the customer choose a size and color. The shirts come in small, medium, and large. The shirts can be red, green, or blue.输入以下说明：
- If the customer has not provided a size, ask them to choose a size. - If the customer has not provided a color, ask them to choose a color. - Once the customer has selected a size and color for the shirt, repeat the selection to the customer, and ask them to confirm the selection. - Once the customer has confirmed their selection, let them know that the shirt is now ordered. - Do not provide prices or collect payment. - Do not collect the customer's name or address.点击保存。
点击返回按钮，返回到 Playbook 列表。
创建信息手册
信息手册可帮助您解决与商店相关的问题。 如需创建此 Playbook，请执行以下操作：
- 点击创建。
- 输入名称：
Information。 输入以下目标：
You provide information about a shirt store. The store is open between 8 AM and 6 PM every day. The store is located at 1007 Mountain Drive, Gotham City, NJ.输入以下说明：
- If the customer asks for the store location, provide them with the address. - If the customer asks for the store hours, provide them with the hours.点击保存。
点击返回按钮，返回到 Playbook 列表。
更新默认 Playbook
当您首次创建应用时，系统会为您创建一个默认的 Playbook。此 Playbook 应引导对话朝着具有特定目标的适当 Playbook 发展。在以下说明中，您可以了解默认 Playbook 如何引用其他 Playbook。如需更新本手册，请执行以下操作：
- 点击默认的 Playbook。此 Playbook 带有突出显示的星形。
输入以下目标：
You are an assistant for a shirt store. Your name is "Samantha". Your job is to direct customers to other playbooks based on the customer's questions.输入以下说明：
- If the customer hasn't been greeted yet, greet the customer, introduce yourself, and ask the user how you can help. - If the customer wants information about the store, route them to ${PLAYBOOK: Information} - If the customer wants to purchase a shirt, route them to ${PLAYBOOK: Order}点击保存。
点击返回按钮，返回到 Playbook 列表。
提供示例
至此，您的 Playbook 已可正常运行。不过，您必须提供示例，以确保获得优质回答。
打开某个 Playbook 后，您可以从示例标签页中手动提供示例。不过，与正常运行的 Playbook 进行对话并将对话保存为示例通常更容易。
以下是使用默认 Playbook 的对话示例，内容较短。 此 Playbook 只需将您定向到其他 Playbook 即可。如需与默认的 Playbook 对话，请执行以下操作：
- 关闭或取消屏幕右侧可能显示的任何面板。 您希望看到包含发送消息以查看客服人员的回复的模拟器面板。
- 选择默认的 Playbook。
- 选择模型：
gemini-pro。 - 在标有输入用户输入内容的文本框中，输入
Hello，然后按 Enter 键。 - 该 Playbook 会回复问候语。
如需将此对话保存为示例，请执行以下操作：
- 点击界面右上角附近的 Save example（保存示例）按钮。
- 系统随即会打开示例编辑器面板。 您可以使用此编辑器添加、修改、删除或重新排列操作。
- 提供示例名称：
Greeting。 - 根据需要更新手册回复。
点击保存。
为信息手册添加位置示例：
- 关闭或取消屏幕右侧可能显示的任何面板。 如有必要，请使用重置 restart_alt 按钮重置对话。
- 选择信息 Playbook。
- 选择模型：
gemini-pro。 - 输入消息：
Where are you located?。 - 该 Playbook 会响应一个位置。
- 将此对话保存为名为
Location的示例。 只有默认的 Playbook 示例可以以用户操作开头，因此您必须删除包含“您在哪里”的操作。输入“前面对话情境”摘要：The customer asked "Where are you located?"。输入示例执行摘要：The store is located at 1007 Mountain Drive, Gotham City, NJ.
为信息手册添加营业时间示例：
- 类似于上述步骤，但输入消息：
What are your hours?，并将示例命名为：Hours。
为有序 playbook 添加一个选择示例：
类似于上述步骤，但将示例命名为
Selection，选择有序剧本，然后发送以下消息：I want to buy a shirtLargeGreenYes
测试代理
您的代理现在可以进行测试了。打开模拟器面板，然后与客服人员对话。您无需与上述对话内容相同。例如，您可以询问此客服人员衬衫有哪些颜色。如果您未获得预期行为，请优化示例并创建新示例，以便获得更理想的回答。
使用 API 与代理互动
请参阅通过 API 进行互动。