购物助理基于 playbook 的预构建代理提供零售商品查询、订购、订单状态和订单取消功能。它使用 Agent Search for Retail 和自定义执行载荷提供丰富的视觉体验。
对话示例
此示例对话展示了此预构建智能体处理的常见场景。
商品和评价对比
- 用户要求浏览传统纱丽。
- 智能体提供了一些热门选项，用户选择了第一个。
- 用户询问是否有搭配的鞋子。
- 智能体提供了一些热门选项，用户要求比较评价并选择评分最高的选项。
- 代理询问尺码，并确认鞋子已添加到购物车。
| 用户输入 | 智能体回答 |
|---|---|
| 给我看看传统纱丽 | |
| [展示商品] 这些商品中有您感兴趣的吗？还是您想看看其他选择？ | |
| 第一个看起来不错 | |
| 太棒了！这款 Indian beauty 自主设计印花时尚乔其纱莎丽服非常漂亮。由于纱丽通常是均码，因此会非常合身。您要将其添加到购物车吗？ | |
| 你有搭配的高跟鞋吗？ | |
| [展示商品] 这些商品中有您感兴趣的吗？还是您想看看其他选择？ | |
| 可以，但您能否查看客户评价，并从中挑选出最佳评价 | |
| 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 | |
| 太好了！1 双 6 码的 Glitzy Galz 女士高跟鞋已加入您的购物车。您还想将其他商品添加到购物车吗？ |
端到端购物体验
- 用户浏览商品清单。
- 智能体根据用户请求提供建议。
- 经过几次搜索后，用户找到了要购买的商品。
- 代理确认要购买的商品的尺寸和数量，以及预计送达日期。
- 用户请求更改送货日期，但该日期不可用，因此用户同意按原定送货日期送货。
- 客服人员会确认系统中的配送、付款和联系信息。
- 用户更新配送信息并确认。
- 智能体下单并向用户提供订单号。
| 用户输入 | 智能体回答 |
|---|---|
| 天气越来越冷了。你们有好的毛衣吗 | |
| [展示商品]。您对这些产品感兴趣吗？还是想看看其他选项？ | |
| 我想给妻子买这款女士毛衣，但我也想找一款男童毛衣 | |
| [展示商品]。您对这些产品感兴趣吗？还是想看看其他选项？ | |
| 将第一件女士毛衣添加到购物车 | |
| 您想要 Nineteen Solid 圆领休闲女士毛衣的哪个尺码？我们有从特小号到特大号的各种尺码。 | |
| 中 | |
| 太好了！1 件 Nineteen 纯色圆领休闲女式毛衣（中码）已添加到您的购物车。您还想将其他商品添加到购物车吗？ | |
| 否 | |
| Nineteen 纯色圆领休闲女式毛衣最早可于 2024 年 4 月 29 日送达。您看这样可以吗？ | |
| 您能在 4 月 28 日送达吗？ | |
| 很抱歉，我们无法在 2024 年 4 月 28 日送达 Nineteen 纯色圆领休闲女士毛衣。我们最早可在 2024 年 4 月 29 日送达。 | |
| 好的，保持送达日期不变 | |
| 好的，您的 Nineteen Solid 圆领休闲女士毛衣将于 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 Solid 圆领休闲女士毛衣，订单 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 Integration 连接器。
- 下载购物助理的 Application Integration。
- 将对
projects/customermod-genai-sa/locations/us-central1/connections/firestore的所有引用替换为在第 2 步中创建的连接器的标识符。 - 上传并发布集成。
- 为 Dialogflow Service Agent 授予
Cloud Functions Invoker角色。 - 按照相应步骤设置零售目录。
- 更新属性控件，使以下字段可检索：ageGroups、availability、categories、colorFamilies、colors、conditions、cost、currencyCode、description、discount、images、materials、patterns、price、sizes、title、URI。
- 将示例目录导入到目录的分支 1 中，并将其设为默认分支。
- 下载 Cloud Run 函数并更新
config.toml。 - 按照部署 Cloud Run 函数中的步骤操作。
- 向您部署的 Cloud Run 函数授予
Retail ViewerIAM 角色。 - 对于以下工具：
get-order-status、order-lookup、place-order和return-order，请更新paths属性，以引用您在 OpenAPI 规范的第 5 步中创建的集成，并选择服务账号身份验证，其中服务账号已获授予Application Integration Invoker角色。 - 将服务器网址属性更新为您为其余工具部署的 Cloud Run 函数。
“搜索商品”工具
search-products 工具会根据搜索查询和商品清单中的偏移值检索最匹配的商品。该工具会返回包含商品详情的自定义载荷响应。界面会使用此自定义载荷以富媒体内容形式显示商品。
“获取商品详情”工具
get-product-details 工具会使用 AI Commerce Search API 从商品清单中提取商品详情。然后，系统会以简化的格式转换并返回检索到的商品详情，代理会使用这些详情来回答有关其向用户展示的商品的问题。
获取评价工具
get-reviews 工具可检索商品评价。它需要一个展示商品列表，并提取每个商品的评价。生成的评价会转换为适合在丰富界面中显示的自定义模板 (review_template) 格式。
“类似商品”工具
similar-products 工具可帮助您使用 Retail Recommendation API 发现与指定商品类似的商品。它接受商品 ID，并使用 Retail Recommendation API 从商品清单中预测类似商品。
送达日期工具
store-delivery-date 工具负责存储用户对购物车中商品的偏好送达日期，该日期应与最早预计送达日期进行比较。
get-delivery-date 工具会估算购物车中商品的送达日期。
“获取用户信息”工具
get-user-info 工具会检索用户的个人信息，包括送货地址、支付信息、手机号码和邮箱。update-user-info 工具会更新用户信息。
“下单”工具
place-order 工具会为购物车中的商品下单。它会将订单数据存储在 Firestore 中，包括订单 ID、状态、创建时间戳和商品列表，然后将订单号返回给代理。
订单查询工具
order-lookup 工具使用提供的订单 ID 从 Firestore 数据库中提取订单数据，并将订单信息返回给智能体。
“退货”工具
return-order 工具会将 Firestore 数据库中的订单状态更新为“return_pending”，表示已发起退货且正在等待处理。
“获取订单状态”工具
get-order-status 工具会提取订单的状态，如果订单已发货，则会使用 DHL API 跟踪订单。它会根据订单状态提供适当的消息。
完成
现在，您的代理及其集成应该已设置完毕，可以进行测试了。