内置购物助理预构建聊天机器人，支持 Vertex AI Search for Retail

购物助理基于手册的预构建客服人员提供零售商品查询、订购、订单状态和订单取消服务。它使用 Vertex AI Search for Retail 和自定义执行载荷，提供丰富的视觉体验。

对话框示例

以下示例对话框演示了此预构建代理处理的常见场景。

商品和评价比较

用户要求浏览传统的纱丽。代理会显示一些热门选项，用户选择第一个选项。用户询问是否有匹配的鞋子。客服人员会显示热门选项，用户要求比较评价，然后选择评分最高的选项。客服人员询问鞋子的尺码，并确认鞋子已添加到购物车。

用户输入	客服人员回复
给我看看传统纱丽
	[展示商品] 您对这些商品中的哪款感兴趣？还是想要其他选项？
第一个看起来不错
	太棒了！印度美女自助设计印花时尚乔其纱丽，美丽动人。由于纱丽通常是单一尺码，因此它会非常合身。您要将其添加到购物车吗？
您有搭配的细高跟鞋吗？
	[展示商品] 您对这些商品中的哪款感兴趣？还是想要其他选项？
可以，但您能否查看客户评价，从中挑选一条最合适的评价
	Flat n Heels 女式高跟鞋的平均评分为 4 星（满分 5 星），而 Glitzy Galz 女式高跟鞋的平均评分为 4.5 星（满分 5 星）。购买 Flat n Heels 女鞋的客户给出的评价褒贬不一，有些客户认为鞋子刚开始穿着很舒服，但几个小时后就很不舒服，而有些客户则赞扬了鞋子的舒适性。另一方面，Glitzy Galz 女式高跟鞋收到的评价大多是正面的，客户赞扬了其合身性、质量和设计。您想将哪个添加到购物车？
评价和评分较高的任一版本
	Glitzy Galz 女式高跟鞋的最高评分为 4.5 星（满分 5 星）。您想要什么尺寸的 Glitzy Galz 女式高跟鞋？我们提供 5 到 11 的尺寸。
6
	太好了！您已将尺码为 6 的 Glitzy Galz 女式高跟鞋添加到购物车中，数量为 1。您还想将其他商品添加到购物车吗？

端到端购物体验

用户浏览商品清单。客服人员会根据用户的请求提供建议。用户搜索了几次后，找到了要购买的商品。客服人员确认要购买的商品的尺寸和数量，以及预计送达日期。用户请求其他送货日期（不可用），并同意原送货日期。客服人员会确认登记的送货、付款和联系信息。用户更新配送信息并确认。客服人员下单并向用户提供订单号。

用户输入	客服人员回复
天气越来越冷了。您有好看的毛衣吗
	[展示商品]。您对这些商品中的哪一款感兴趣，还是想要其他选项？
我喜欢为妻子买这件女士毛衣，但我还想买一件男孩毛衣
	[展示商品]。您对这些商品中的哪款感兴趣？还是想要其他选项？
将第一个女士毛衣添加到购物车
	您想订购什么尺寸的 Nineteen 纯色圆领休闲女士毛衣？我们提供从超小到超大等多种尺寸。
中
	太好了！您已将一件中号 Nineteen 纯色圆领休闲女款毛衣加入购物车，数量为 1。您还想将其他商品添加到购物车吗？
否
	我们最早可在 2024 年 4 月 29 日之前将 Nineteen 纯色圆领休闲女款毛衣寄送给您。您看这样可以吗？
您能否在 4 月 28 日送达？
	很抱歉，我们无法在 2024 年 4 月 28 日送达“Nineteen 纯色圆领休闲女式卫衣”。我们最早可在 2024 年 4 月 29 日提供该报告。
好的，保持原来的送达日期
	好的，您的“Nineteen 纯色圆领休闲女款毛衣”将于 2024 年 4 月 29 日送达。现在，我们来检查您的商家资料详情，确保所有信息都是最新的：
送货地址：638 Maple Street, Apt 11, Cupertino, CA 95014\
	付款信息：尾号为 4111 的 Visa 卡联系电话：416-555-5555 电子邮件：email@example.com 请查看以下详细信息。如果所有信息正确无误，只需进行确认即可。如果您需要进行任何更改，请告诉我。
我的地址已更改为 371 Talbot Street Carmichael, CA 95608
	您的送货地址已成功更新为 371 Talbot Street, Carmichael, CA 95608。您还想修改其他内容吗？
否
	您订购的 Nineteen 纯色圆领休闲女式卫衣已成功下单，订单 ID 为 ee6b4cc7。订单预计会在 2024 年 4 月 29 日送达。
谢谢
	您的订单已成功下单！您还需要其他方面的帮助吗？
不用了
	很高兴能帮到您！如需 Cymbal Apparel 方面的任何帮助，欢迎随时与我联系。\

查看订单状态

用户请求查看订单状态。客服人员会收集订单号并检索订单信息。客服人员会提供订单中商品的详细信息，以及其当前状态和预计送达日期。

用户输入	客服人员回复
<first name>，
	您可以随意从上述选项中进行选择，也可以直接输入您要查找的内容，我会为您提供帮助。
我想查看订单状态
	好的，我可以为您提供帮助。首先，能否请您提供一下订单 ID？
ee6b4cc7
	您的订单已确认！订单目前正在处理中。您订购的商品如下： Nineteen 纯色圆领休闲女式卫衣尺寸：中号数量：1 预计送货时间：2024 年 4 月 29 日您还需要其他方面的帮助吗？
不用了
	很高兴能帮到您！如需 Cymbal Apparel 方面的任何帮助，欢迎随时与我联系。

退货

用户想要退回订单。客服人员会收集订单号、检索订单详情，并确认要退回的商品。然后，客服人员会发起退货流程，并提供退货单供用户打印并贴在包裹上。

用户输入	客服人员回复
<first name>，
	您可以随意从上述选项中进行选择，也可以直接输入您要查找的内容，我会为您提供帮助。
我想退回订单
	我非常乐意帮助您处理退货事宜。首先，能否请您告诉我您的订单号？
0fc77d64
	感谢您提供订单号。我找到了您于 2024 年 4 月 12 日下单的订单。订单包含一件小号 YK 印花男孩圆领深蓝色 T 恤。这是您要退回的商品吗？
是
	好的，我已发起退货流程。退货单已附在下方。请先打印并将其贴附在包裹上，然后再寄回。您还需要其他方面的帮助吗？
不用了
	很高兴能帮到您！如需 Cymbal Apparel 方面的任何帮助，欢迎随时与我联系。

基本设置

如需设置此预构建代理，请执行以下操作：

导入预建代理。
使用外部服务配置提供的工具，请参阅工具设置。

工具设置

此代理包含用于与外部服务集成的工具。如需配置这些工具，请按以下步骤操作：

创建一个名为 apparel-db 的 Firestore 数据库。
创建 Firestore 集成连接器。
下载适用于购物助理的应用集成。
将对 projects/customermod-genai-sa/locations/us-central1/connections/firestore 的所有引用替换为在第 2 步中创建的连接器的标识符。
上传并发布集成。
向您的 Dialogflow 服务代理授予 Application Integration Invoker 角色。
更新 paths 属性，以引用您在第 5 步中在以下工具的 OpenAPI 规范中创建的集成：get-order-status、order-lookup、place-order、return-order

Google 购物

search-products 工具会根据搜索查询和商品目录中的偏移量值检索最匹配的商品。该工具会返回包含商品详情的自定义载荷响应。界面会使用此自定义载荷以富媒体形式显示商品。

产品详情

get-product-details 工具使用 Retail API 从商品目录中提取商品详情。然后，系统会转换检索到的商品详情，并以简化格式返回，以便客服助理回答有关其向用户显示的商品的问题

商品评价

get-reviews 工具用于检索商品评价。它需要显示的商品列表，并提取每个商品的评价。生成的评价会转换为适合在富媒体界面中显示的自定义模板 (review_template) 格式。

类似商品

similar-products 工具可帮助您使用 Retail Recommendation API 发现与指定商品相似的商品。该 API 接受商品 ID，并利用 Retail Recommendation API 从商品目录中预测类似商品。

传送日期

store-delivery-date 工具负责存储购物车中商品的首选送达日期，该日期应与最早的预计送达日期进行比较。

get-delivery-date 工具负责估算购物车中商品的送达日期。

用户详细信息

get-user-info 工具用于检索用户的个人信息，包括送货地址、付款信息、电话号码和电子邮件地址，而 update-user-info 工具负责更新用户的信息。

订单管理

place-order 工具会处理为购物车商品下单的流程。它会将订单及其数据（包括订单 ID、状态、创建时间戳和商品列表）存储在 Firestore 中。它会将订单号返回给客服人员。

order-lookup 工具会根据提供的订单 ID 从 Firestore 数据库中提取订单数据。

return-order 工具会将 Firestore 数据库中订单的状态更新为“return_pending”，表示客户已发起退货，并且订单正在等待退货。

get-order-status 工具负责提取订单的状态，如果订单已发货，则使用 DHL API 跟踪订单。它会根据订单状态提供适当的消息。

完成

您的代理及其集成现在应该已设置完毕，可以进行测试了。

零售

旅行