使用 playbook 构建代理

注意：Agent Builder 控制台仍将 Playbook 称为代理。此字段很快就会在 Play 管理中心内更新为手册。

本指南介绍了如何使用 Playbook 构建和测试简单的衬衫订购代理。与此代理互动时，您可以查询商店位置、获取商店营业时间或创建衬衫订单。

准备工作

在阅读本指南之前，请先完成以下事项：

1. 如果您尚未完成，请按照 Dialogflow 设置说明操作。

Playbook 简介

一个代理由一个或多个 playbook 组成。 每个手册都有明确定义的范围限制。 Playbook 包含以下数据：

X	项
名称	用于标识 Playbook 的名称。
目标	目标是对手册应实现的目标的概要说明。
说明	说明是指为实现手册目标而应采取的概要步骤。
示例	示例是最终用户与代理之间的对话示例。这些示例实际上是 LLM 的少样本提示示例。

创建代理

如需创建代理，请执行以下操作：

1. 前往 Agent Builder 控制台：

   Agent Builder 控制台

2. 从控制台下拉列表中选择您的项目。

3. 如果您尚未激活该 API，请阅读并同意服务条款，然后点击继续并激活 API。

4. 点击 Create a New App 或 New App。

5. 选择代理。

6. 为应用名称提供“Shirt Ordering Assistant”。

7. 请选择区域。

8. 点击创建。

9. 界面会将您定向到名为 Default Agent 的默认 Playbook。

10. 点击返回按钮，查看 Playbook 列表。

创建订单 playbook

Order playbook 处理衬衫订单。 如需创建此 Playbook，请执行以下操作：

1. 点击创建。
2. 输入名称：Order。

3. 输入以下目标：

   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.
   

4. 输入以下说明：

   - 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.
   

5. 点击保存。

   

6. 点击返回按钮，返回到 Playbook 列表。

创建信息手册

信息手册可帮助您解答与商店相关的问题。 如需创建此 Playbook，请执行以下操作：

1. 点击创建。
2. 输入名称：Information。

3. 输入以下目标：

   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.
   

4. 输入以下说明：

   - 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.
   

5. 点击保存。

6. 点击返回按钮，返回到 Playbook 列表。

更新默认 playbook

最初创建应用时 系统已为您创建默认 playbook。 本指南应引导对话 并参考具有具体目标的适当手册。 在以下说明中 您可以看到默认 playbook 如何引用其他 playbook。 如需更新此 playbook，请执行以下操作：

1. 点击默认 playbook。此 Playbook 带有突出显示的星形。

2. 输入以下目标：

   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.
   

3. 输入以下说明：

   - 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 ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. 点击保存。

5. 点击返回按钮，返回到 Playbook 列表。

提供示例

此时， 是否正常运行 不过，您必须提供示例，以确保获得优质回答。

您可以手动提供示例中的示例 标签页。 不过，与正常运行的 Playbook 进行对话并将对话保存为示例通常更容易。

使用默认 playbook 的对话示例较短。 此 Playbook 只需将您定向到其他 Playbook 即可。如需与默认的 Playbook 对话，请执行以下操作：

1. 关闭或取消屏幕右侧可能显示的任何面板。 您希望看到包含发送消息以查看客服人员的回复的模拟器面板。
2. 选择默认 playbook。
3. 选择模型：gemini-pro。
4. 在标有输入用户输入内容的文本框中，输入 Hello，然后按 Enter 键。
5. 此 playbook 会使用问候语进行响应。

如需将此对话保存为示例，请执行以下操作：

1. 点击 保存示例按钮 “管理”按钮
2. 系统随即会打开示例编辑器面板。 您可以使用此编辑器对操作执行添加、修改、删除或重新排序等操作。
3. 提供示例名称：Greeting。
4. 根据需要更新手册回复。

5. 点击保存。

   

为信息手册添加位置示例：

1. 关闭或取消屏幕右侧可能显示的任何面板。 如有必要，请使用重置 restart_alt 按钮重置对话。
2. 选择信息手册。
3. 选择模型：gemini-pro。
4. 输入消息：Where are you located?。
5. 该 Playbook 会响应一个位置。
6. 将此对话保存为名为 Location 的示例。 只有默认的 Playbook 示例可以以用户操作开头，因此您必须删除包含“您在哪里”的操作。

为信息手册添加营业时间示例：

1. 类似于上述步骤，但输入消息：What are your hours?，并将示例命名为：Hours。

为订单 playbook 添加选择示例：

1. 类似于上述步骤，但将示例命名为 Selection，选择有序剧本，然后发送以下消息：

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

测试代理

您的代理现在可以进行测试了。打开模拟器面板，然后与客服人员对话。您无需与上述对话内容相同。例如，您可以询问此客服人员衬衫有哪些颜色。如果您未获得预期行为，请优化示例并创建新示例，以便获得更理想的回答。

使用 API 与代理进行交互

请参阅 与 API 进行交互。