基于购物助理 剧本的预建智能体 提供零售商品查询、订购、订单状态和订单取消功能。 它使用 Vertex AI Search for Retail 和 自定义履单载荷， 提供丰富的视觉体验。
对话示例
以下对话示例展示了此预建智能体处理的常见场景。
商品和评价比较
用户要求浏览传统纱丽。 智能体展示了一些热门选项，用户选择了第一个。 用户要求提供搭配的鞋子。 智能体展示了热门选项，用户要求比较评价并选择了评分最高的选项。 智能体询问了尺码，并确认鞋子已添加到购物车。
| 用户输入 | 智能体回答 |
|---|---|
| show me traditional sarees | |
| [展示商品] 您对这些商品中的任何一款感兴趣吗？还是想看看其他选项？ | |
| 1st one is looking good | |
| 太棒了！这款印度美女自制印花时尚乔其纱纱丽非常漂亮。由于纱丽通常是均码，因此非常合身。您想将其添加到购物车吗？ | |
| do you have a matching heels with it? | |
| [展示商品] 您对这些商品中的任何一款感兴趣吗？还是想看看其他选项？ | |
| yes but can you go through the customer review and pick the best one from these | |
| Flat n Heels 女士高跟鞋的平均评分为 4 星（满分 5 星），而 Glitzy Galz 女士高跟鞋的平均评分为 4.5 星（满分 5 星）。购买 Flat n Heels 女士高跟鞋的客户的评价褒贬不一，有些人认为刚开始穿很舒服，但几个小时后就不舒服了，而另一些人则称赞其舒适度。另一方面，Glitzy Galz 女士高跟鞋收到的评价大多为正面评价，客户称赞其合脚度、质量和设计。您想将哪一款添加到购物车？ | |
| whichever has the best review and ratings | |
| Glitzy Galz 女士高跟鞋的评分最高，为 4.5 星（满分 5 星）。您想选择什么尺码的 Glitzy Galz 女士高跟鞋？我们提供 5 到 11 码的尺码。 | |
| 6 | |
| 太好了！尺码为 6 的 Glitzy Galz 女士高跟鞋已添加到您的购物车，数量为 1。您还想将其他商品添加到购物车吗？ |
端到端购物体验
用户浏览商品目录。智能体根据用户请求提供推荐。经过几次搜索后，用户找到要购买的商品。智能体确认要购买商品的尺码和数量，以及预计送达日期。用户请求更改送达日期，但无法更改，因此同意了原送达日期。智能体确认了文件中的送达、支付和联系信息。用户更新了送达信息并进行了确认。智能体下单并向用户提供了订单号。
| 用户输入 | 智能体回答 |
|---|---|
| It is getting cold. Do you have good sweaters | |
| [展示商品]。您对这些商品中的任何一款感兴趣吗？还是想看看其他选项？ | |
| I like the women's sweater for my wife, but i am looking for a boy's sweater | |
| [展示商品]。您对这些商品中的任何一款感兴趣吗？还是想看看其他选项？ | |
| add the first women's sweater to the cart | |
| 您想选择什么尺码的 Nineteen Solid 圆领休闲女士毛衣？我们提供从超小号到超大号的尺码。 | |
| medium | |
| 太好了！尺码为中号的 Nineteen Solid 圆领休闲女士毛衣已添加到您的购物车，数量为 1。您还想将其他商品添加到购物车吗？ | |
| no | |
| 我们最早可以在 2024 年 4 月 29 日将 Nineteen Solid 圆领休闲女士毛衣送达给您。您看这样可以吗？ | |
| can you deliver it on April 28? | |
| 很抱歉，我们无法在 2024 年 4 月 28 日送达 Nineteen Solid 圆领休闲女士毛衣。我们最早可以在 2024 年 4 月 29 日送达。 | |
| ok keep the delivery date as it is | |
| 好的，您的 Nineteen Solid 圆领休闲女士毛衣将于 2024 年 4 月 29 日送达。现在，我们来查看您的个人资料详情，确保所有信息都是最新的： | |
| 送达地址：638 Maple Street, Apt 11, Cupertino, CA 95014 | |
| 支付信息：Visa 卡，卡号末四位为 4111 联系电话：416-555-5555 电子邮件地址：email@example.com 请查看这些详细信息。如果一切正确，只需确认即可。如果您需要进行任何更改，请告诉我。 |
|
| my address has changed to 371 Talbot Street Carmichael, CA 95608 | |
| 您的配送地址已成功更新为 371 Talbot Street, Carmichael, CA 95608。您还想修改其他信息吗？ | |
| no | |
| 您已成功下单购买 Nineteen Solid 圆领休闲女士毛衣，订单号为 ee6b4cc7。预计送达日期为 2024 年 4 月 29 日。 | |
| thanks | |
| 您已成功下单！您还需要其他方面的帮助吗？ | |
| no thanks | |
| 很高兴能帮到您！如果您需要 Cymbal Apparel 的任何商品，只需点击一下即可。 |
查看订单状态
用户请求查看订单状态。智能体收集订单号并检索订单信息。智能体提供了订单中商品的详细信息，以及订单的当前状态和预计送达日期。
| 用户输入 | 智能体回答 |
|---|---|
| Hi | |
| 您可以从上面的选项中进行选择，也可以直接输入您要查找的内容，我会为您提供帮助。 | |
| I want to check the status of my order | |
| 好的，我可以为您提供帮助。首先，请您提供订单 ID。 | |
| ee6b4cc7 | |
| 您的订单已确认！目前正在处理中。 以下是您订购的商品： Nineteen Solid 圆领休闲女士毛衣 尺码：中号 数量：1 预计送达日期：2024 年 4 月 29 日 您还需要其他方面的帮助吗？ |
|
| No thanks | |
| 很高兴能帮到您！如果您需要 Cymbal Apparel 的任何商品，只需点击一下即可。 |
退货
用户想要退货。智能体收集订单号，检索订单详情并确认要退回的商品。然后，智能体启动退货流程，并提供退货单供用户打印并贴到包裹上。
| 用户输入 | 智能体回答 |
|---|---|
| Hi | |
| 您可以从上面的选项中进行选择，也可以直接输入您要查找的内容，我会为您提供帮助。 | |
| I want to return my order | |
| 我很乐意为您提供退货帮助。首先，请您提供订单号。 | |
| 0fc77d64 | |
| 感谢您提供订单号。我找到了您在 2024 年 4 月 12 日下的订单。该订单包含一件小号的 YK 印花男童圆领深蓝色 T 恤。这是您要退回的商品吗？ | |
| yes | |
| 好的，我已经启动了退货流程。您可以在下方找到退货单。请将其打印出来并贴到包裹上，然后再寄回。您还需要其他方面的帮助吗？ | |
| No thanks | |
| 很高兴能帮到您！如果您需要 Cymbal Apparel 的任何商品，只需点击一下即可。 |
基本设置
如需设置此预建智能体，请执行以下操作：
工具设置
此智能体包含工具，用于 与外部服务集成。如需配置这些工具，请按以下步骤操作：
- 创建名为
apparel-db的 Firestore 数据库 。 - 创建 Firestore 集成连接器。
- 下载 购物助理的 Application Integration。
- 将对
projects/customermod-genai-sa/locations/us-central1/connections/firestore的所有引用替换为在第 2 步中创建的连接器的标识符。 - 上传 并 发布 集成。
- 向 Dialogflow 服务智能体授予
Cloud Functions Invoker角色。 - 按照步骤 设置 Retail 目录
- 更新 属性控件 ，使以下字段可检索：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属性以引用您在第 5 步中创建的集成（ 在 OpenAPI 规范中），并选择 服务账号身份验证 ，使用您向其授予Application Integration Invoker角色的服务帐号。 - 对于其余工具，请将服务器网址属性更新为您部署的 Cloud Run 函数。
Product Search
search-products 工具会根据搜索查询和商品目录中的偏移值检索最匹配的商品。该工具会返回包含商品详情的自定义载荷响应。
界面使用此自定义载荷以富内容形式显示商品。
产品详情
get-product-details 工具使用 Retail 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 进行跟踪。它会根据订单状态提供适当的消息。
完成
您的智能体及其集成现在应该已设置完毕，可以进行测试了。