本指南介绍了如何使用 Playbook 构建和测试简单的衬衫订购代理。与此代理互动时,您可以查询商店位置、获取商店营业时间或创建衬衫订单。
准备工作
在阅读本指南之前,请先完成以下事项:
- 如果您尚未完成,请按照 Dialogflow 设置说明操作。
Playbook 简介
一个代理由一个或多个 playbook 组成。 每个手册都有明确定义的范围限制。 Playbook 包含以下数据:
X | 项 |
---|---|
名称 | 用于标识 Playbook 的名称。 |
目标 | 目标是对手册应实现的目标的概要说明。 |
说明 | 说明是指为实现手册目标而应采取的概要步骤。 |
示例 | 示例是最终用户与代理之间的对话示例。这些示例实际上是 LLM 的少样本提示示例。 |
创建代理
如需创建代理,请执行以下操作:
前往 Agent Builder 控制台:
从控制台下拉列表中选择您的项目。
如果您尚未激活该 API,请阅读并同意服务条款,然后点击继续并激活 API。
点击 Create a New App 或 New App。
选择代理。
为应用名称提供“Shirt Ordering Assistant”。
请选择区域。
点击创建。
界面会将您定向到名为 Default Agent 的默认 Playbook。
点击返回按钮,查看 Playbook 列表。
创建订单 playbook
Order playbook 处理衬衫订单。 如需创建此 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 带有突出显示的星形。
输入以下目标:
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 ${AGENT: Information} - If the customer wants to purchase a shirt, route them to ${AGENT: Order}
点击保存。
点击返回按钮,返回到 Playbook 列表。
提供示例
此时, 是否正常运行 不过,您必须提供示例,以确保获得优质回答。
您可以手动提供示例中的示例 标签页。 不过,与正常运行的 Playbook 进行对话并将对话保存为示例通常更容易。
使用默认 playbook 的对话示例较短。 此 Playbook 只需将您定向到其他 Playbook 即可。如需与默认的 Playbook 对话,请执行以下操作:
- 关闭或取消屏幕右侧可能显示的任何面板。 您希望看到包含发送消息以查看客服人员的回复的模拟器面板。
- 选择默认 playbook。
- 选择模型:
gemini-pro
。 - 在标有输入用户输入内容的文本框中,输入
Hello
,然后按 Enter 键。 - 此 playbook 会使用问候语进行响应。
如需将此对话保存为示例,请执行以下操作:
- 点击 保存示例按钮 “管理”按钮
- 系统随即会打开示例编辑器面板。 您可以使用此编辑器对操作执行添加、修改、删除或重新排序等操作。
- 提供示例名称:
Greeting
。 - 根据需要更新手册回复。
点击保存。
为信息手册添加位置示例:
- 关闭或取消屏幕右侧可能显示的任何面板。 如有必要,请使用重置 restart_alt 按钮重置对话。
- 选择信息手册。
- 选择模型:
gemini-pro
。 - 输入消息:
Where are you located?
。 - 该 Playbook 会响应一个位置。
- 将此对话保存为名为
Location
的示例。 只有默认的 Playbook 示例可以以用户操作开头,因此您必须删除包含“您在哪里”的操作。
为信息手册添加营业时间示例:
- 类似于上述步骤,但输入消息:
What are your hours?
,并将示例命名为:Hours
。
为订单 playbook 添加选择示例:
类似于上述步骤,但将示例命名为
Selection
,选择有序剧本,然后发送以下消息:I want to buy a shirt
Large
Green
Yes
测试代理
您的代理现在可以进行测试了。打开模拟器面板,然后与客服人员对话。您无需与上述对话内容相同。例如,您可以询问此客服人员衬衫有哪些颜色。如果您未获得预期行为,请优化示例并创建新示例,以便获得更理想的回答。
使用 API 与代理进行交互
请参阅 与 API 进行交互。