借助基于 playbook 的预构建代理，用户可以搜索商品、获取商品推荐和下单。
对话示例
以下示例对话展示了此预建代理处理的常见场景。
搜索商品和购买商品
用户询问商店中是否有手表。代理会推荐符合此条件的产品，用户将其添加到购物车。用户确认要下单，代理通过确认编号确认订单。然后，用户请求手机推荐，代理会推荐手机、将一部手机添加到用户的购物车，并为用户下单。
| 用户输入 | 智能体回答 |
|---|---|
| hi | |
| 你好，我是你的 Google 购物助理。我可以帮助您搜索商品和下单。今天需要我做些什么？ | |
| 你有哪些手表 | |
| 我们有 Google 手表。要将其添加到购物车吗？ | |
| 好的，请添加两张 | |
| 没问题。我已将两块 Google 手表添加到您的购物车。想执行其他步骤吗？ | |
| 您好，您能再将一部 Google Pixel 8 加入我的购物车吗？ | |
| 没问题。我已将 1 部 Google Pixel 8 添加到您的购物车。想执行其他步骤吗？ | |
| 我的购物车里有什么？ | |
| 您的购物车中有一部 Google Pixel 8 和两块 Google 手表。您要结账吗？ | |
| 可以 | |
| 好的，我已下单，其中包含 1 部 Google Pixel 8 和 2 部 Google Watch。您的确认编号为 QKA67DW2。 | |
| 您现在还需要其他方面的帮助吗？ | |
| 实际上，您也能帮我找一部新手机吗？ | |
| 我们有 Google Pixel 8 和 Google Pixel 7，您想购买其中一款吗？ | |
| 是，给我 Pixel 8 | |
| 没问题。我已将 1 部 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 手表。要将其添加到购物车吗？ | |
| 不用了 | |
| 您现在还需要其他方面的帮助吗？ | |
| 不行 | |
| 好的，感谢您使用 Google 购物！祝您度过愉快的一天！ |
无法识别所输入的内容
用户咨询的主题与产品或订购无关。代理会重复说明其涵盖的主题，并询问用户需要哪些方面的帮助。
| 用户输入 | 智能体回答 |
|---|---|
| hi | |
| 你好，我是你的 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 -
部署所有必需的服务后，请使用安装程序记录的提供的网址配置预构建代理中的每个工具：
Vertex AI Agent Builder 控制台
- 如果您尚未导入预建代理，请将代理导入您的项目。
- 前往 Vertex AI Agent Builder 控制台。
- 从控制台下拉菜单中选择您的项目。
- 选择您的应用。
- 点击工具图标。
-
对于代理中的每个工具，请修改架构，将
servers:字段中的网址替换为安装程序记录的端点。 - 点击保存。
Dialogflow CX
- 如果您尚未导入预建代理，请将代理导入您的项目。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击生成式资源图标。
- 点击工具。
-
对于代理中的每个工具，请修改架构，将
servers字段中的网址替换为安装程序记录的端点。 - 点击保存。
-
向 Compute Engine 服务账号 (
your-project-number-) 授予 Cloud Datastore 用户角色，以便新部署的 Cloud Run 函数可以访问 Firestore。
Google Store API
Google Store API 工具用于根据搜索字词从 Google 商店中提取商品。
管理购物车
借助 Manage Shopping Cart 工具，用户可以查看购物车中的所有商品、向购物车添加商品以及从购物车中移除商品，从而管理购物车。
下单
Place Order 工具用于根据用户的当前购物车内容下单，并返回所下订单的确认编号。
完成
您的代理及其集成现在应已设置完毕，可以进行测试了。