借助零售基于 playbook 的预构建代理，您可以搜索商品、获取商品推荐和下单。
对话示例
此示例对话展示了此预构建智能体处理的常见场景。
搜索商品和购买商品
- 用户询问商店中有哪些手表。
- 智能体推荐符合这些条件的商品。
- 用户将商品添加到购物车。
- 用户将另一件商品添加到购物车。
- 用户询问购物车中的商品。
- 代理列出购物车中的商品，用户确认要购买这些商品。
- 代理下单并提供确认号。
- 用户请求推荐手机。
- 智能体推荐商店中在售的手机。
- 用户将其中一个添加到购物车。
- 用户下单购买手机并提供确认号。
| 用户输入 | 智能体回答 |
|---|---|
| <first name>， | |
| 您好，我是您的 Google 购物助理。我可以帮您搜索商品和下单。今天需要我做些什么？ | |
| 你有哪些手表 | |
| 我们有 Google Watch。您要将其添加到购物车吗？ | |
| 好的，请添加两个 | |
| 你答对了。我已将两块 Google 手表添加到您的购物车。想执行其他步骤吗？ | |
| 你能把一部 Google Pixel 8 也添加到我的购物车吗？ | |
| 你答对了。我已将一部 Google Pixel 8 添加到您的购物车。想执行其他步骤吗？ | |
| 我的购物车里有什么？ | |
| 您的购物车中有一部 Google Pixel 8 和两块 Google Watch。您想结账吗？ | |
| 可以 | |
| 好的，我已下单，订单中包含一部 Google Pixel 8 和两块 Google Watch。您的确认码为 QKA67DW2。 | |
| 您现在还需要其他方面的帮助吗？ | |
| 其实，你能不能也帮我找一款新手机？ | |
| 我们有 Google 手机 Pixel 8 和 Google 手机 Pixel 7，您想购买其中一款吗？ | |
| 是，给我一部 Pixel 8 | |
| 你答对了。我已将一部 Google 手机 Pixel 8 添加到您的购物车。想执行其他步骤吗？ | |
| 不，我们可以查看 | |
| 您的购物车中有一部 Google 手机 Pixel 8。您想使用此购物车结账吗？ | |
| 是 | |
| 好的，我已为您下单。您的订单包含一部 Google 手机 Pixel 8。您的确认码为 Y43KTF0T。 | |
| 您现在还需要其他方面的帮助吗？ | |
| 没有了，谢谢 | |
| 好的，感谢您通过 Google 购物！祝您度过愉快的一天！ |
购物车管理
用户要求将一些商品添加到购物车，然后在下单前移除其中一件商品。
| 用户输入 | 智能体回答 |
|---|---|
| 您好，我想买一部手机 | |
| 我们有 Google 手机 Pixel 8 和 Google 手机 Pixel 7。您想购买哪一款？ | |
| 给我两个 8 | |
| 你答对了。我已将两部 Google Pixel 8 手机添加到您的购物车。想执行其他步骤吗？ | |
| 其实，你能移除其中一个吗？ | |
| 好的，我已从您的购物车中移除了一部 Google 手机 Pixel 8。想执行其他步骤吗？ | |
| 我已准备好下单 | |
| 好的，我已下单，订单中包含一部 Google 手机 Pixel 8。您的确认码为 X0KP6K5T。 | |
| 您现在还需要其他方面的帮助吗？ | |
| 没有了 | |
| 好的，感谢您通过 Google 购物！祝您度过愉快的一天！ |
未找到商品
用户询问商店没有的商品。
| 用户输入 | 智能体回答 |
|---|---|
| <first name>， | |
| 您好，我是您的 Google 购物助理。我可以帮您搜索商品和下单。今天需要我做些什么？ | |
| 我想买车 | |
| 抱歉，我们目前没有现车。您还有其他想查找的内容吗？ | |
| 是的，手表呢？ | |
| 我们有 Google Watch。您要将其添加到购物车吗？ | |
| 不用了 | |
| 您现在还需要其他方面的帮助吗？ | |
| 不行 | |
| 好的，感谢您通过 Google 购物！祝您度过愉快的一天！ |
无法识别所输入的内容
- 用户询问与商品或订购无关的主题。
- 代理会重复其涵盖的主题，并询问用户需要什么帮助。
| 用户输入 | 智能体回答 |
|---|---|
| <first name>， | |
| 您好，我是您的 Google 购物助理。我可以帮您搜索商品和下单。今天需要我做些什么？ | |
| 我想预订酒店 | |
| 抱歉，我无法回答这个问题。我可以帮您搜索手机、手表和耳机等商品。我还可以帮您下单。今天需要我做些什么？ |
基本设置
请按照以下步骤设置此预构建代理：
工具设置
此智能体包含用于与外部服务集成的工具。使用工具安装程序为预构建代理部署示例代码和数据。
如需为零售预构建代理部署和配置示例代码和数据，请展开以查看说明。
- 将预构建的工具安装程序下载到本地目录。
- 前往您下载 installer.zip 的本地目录。
- 解压缩 installer.zip 并打开
installer文件夹。 - 请查看 README.md，详细了解安装程序及其要求。
- 运行
pip install -r requirements.txt以安装要求。 -
运行
gcloud auth application-default login，以使用 gcloud auth 进行身份验证。 -
使用
python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail运行安装程序 -
部署所有必需的服务后，使用安装程序记录的所提供网址配置预构建代理中的每个工具：
Generative AI App Builder
- 如果您尚未导入预构建代理，请将代理导入到项目中。
- 前往 Generative AI App Builder。
- 从控制台下拉菜单中选择您的项目。
- 选择您的应用。
- 点击工具图标。
-
对于代理中的每个工具，修改架构，将
servers:字段中的网址替换为安装程序记录的端点。 - 点击保存。
Dialogflow CX
- 如果您尚未导入预构建代理，请将代理导入到项目中。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击生成式资源对应的图标。
- 点击工具。
-
对于代理中的每个工具，修改架构，将
servers字段中的网址替换为安装程序记录的端点。 - 点击保存。
-
向 Compute Engine 服务账号 (
your-project-number-) 授予 Cloud Datastore User 角色，以便新部署的 Cloud Run functions 可以访问 Firestore。
Google 商店 API 工具
Google Store API 工具会根据搜索字词从 Google 商店中提取商品。
管理购物车工具
“管理购物车”工具可让用户通过查看、添加和移除商品来管理购物车。
“下单”工具
“下单”工具会为用户当前的购物车下单，并返回确认编号。
完成
您的代理已设置完毕，可以开始测试了。