借助 Retail 预构建代理，用户可以搜索商品、获取商品推荐和下单。此预建代理使用生成式代理。
示例对话框
以下示例对话框演示了此预构建代理处理的常见场景。
搜索商品并购买商品
用户询问商店有售的手表。代理推荐符合此条件的产品，然后用户将其添加到购物车中。用户确认想要下单，代理会使用确认号来确认订单。然后，用户请求手机推荐，代理则会推荐手机，将一个手机添加到用户的购物车，并向用户下单。
| 用户输入 | 代理响应 |
|---|---|
| hi | |
| 你好，我是你的 Google 购物助理。我可以帮你搜索商品和下订单。您现在需要什么帮助？ | |
| 你有哪些手表 | |
| 我们有 Google Watch。要将商品添加到购物车吗？ | |
| 是的，请添加两个 | |
| 你答对了。我已经把两块 Google 手表添加到你的购物车了。想执行其他步骤吗？ | |
| 你可以把 Google Pixel 8 也加入我的购物车吗？ | |
| 你答对了。我已经把一台 Google Pixel 8 添加到购物车了。想执行其他步骤吗？ | |
| 我的购物车里有什么？ | |
| 您的购物车中有 1 部 Google Pixel 8 和 2 部 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 购物！祝您度过愉快的一天！ |
未找到商品
用户询问商店没有销售的商品。
| 用户输入 | 代理响应 |
|---|---|
| hi | |
| 你好，我是你的 Google 购物助理。我可以帮你搜索商品和下订单。您现在需要什么帮助？ | |
| 我想买车 | |
| 抱歉，目前没有汽车库存。您还有什么要找的吗？ | |
| 对，手表怎么样？ | |
| 我们有 Google Watch。要将商品添加到购物车吗？ | |
| 不用了 | |
| 您现在还需要其他方面的帮助吗？ | |
| 不行 | |
| 好的，感谢您使用 Google 购物！祝您度过愉快的一天！ |
无法识别的输入内容
用户询问与产品或订购无关的主题。代理会重复说明所涵盖的主题进行响应，并询问用户希望获得哪些帮助。
| 用户输入 | 代理响应 |
|---|---|
| hi | |
| 你好，我是你的 Google 购物助理。我可以帮你搜索商品和下订单。您现在需要什么帮助？ | |
| 我想预订酒店 | |
| 抱歉，我无法提供这方面的帮助。我可以帮你搜索手机、手表和头戴式耳机等商品。我还可以帮助您下单。您现在需要什么帮助？ |
基本设置
如需设置此预构建代理，请执行以下操作：
工具设置
此代理包含用于与外部服务集成的tools。您可以使用预构建工具安装程序为预构建代理部署示例代码和数据。
如需为 Retail 预构建代理部署和配置示例代码和数据，请展开查看相关说明。
- 将预构建工具安装程序下载到本地目录。
- 导航到您下载 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运行安装程序 -
部署所有必需的服务后，使用安装程序记录的提供的网址配置预构建代理中的每个工具：
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 如果您尚未导入预建代理，请将代理导入您的项目。
- 选择您的代理。
- 点击生成资源图标。
- 点击工具。
-
对于代理中的每个工具，请修改架构，将
servers:字段中的网址替换为安装程序记录的端点。 - 点击保存。
Google Store API
Google Store API 工具用于根据搜索字词从 Google 商店提取商品。
管理购物车
借助 Manage Shopping Cart 工具，用户可以查看购物车中的所有商品、将商品添加到购物车以及从购物车中移除商品，从而管理购物车。
下单
Place Order 工具用于向用户的当前购物车下订单，并返回所下订单的确认编号。
完成
您的代理及其集成现在应该已设置完毕，可以进行测试了。