購物助理 以劇本為基礎的預先建立代理 提供零售產品查詢、訂購、訂單狀態和取消訂單等功能。 這項功能會使用 Vertex AI Search for Retail 和自訂履行酬載，提供豐富的視覺體驗。
對話範例
以下範例對話說明這個預先建構的代理程式處理的常見情境。
產品和評論比較
使用者要求瀏覽傳統紗麗。 代理程式會提供一些熱門選項，使用者選取第一個選項。 使用者要求搭配鞋子。 代理程式會顯示熱門選項，使用者要求比較評論，並選取評分最高的選項。服務專員詢問尺寸，並確認鞋子已加入購物車。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 顯示傳統沙麗 | |
| [呈現產品] 這些產品是否符合您的需求？還是您需要其他選項？ | |
| 第 1 項看起來不錯 | |
| 選得好！這款印度美女自製設計的印花時尚喬其紗麗，是件美麗的單品。由於紗麗通常只有一個尺寸，因此一定合身。要將這項商品加入購物車嗎？ | |
| 有搭配的鞋子嗎？ | |
| [呈現產品] 這些產品是否符合您的需求？還是您需要其他選項？ | |
| 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 女士高跟鞋則獲得許多正面評價，顧客紛紛稱讚其合身度、品質和設計。要將哪一個加入購物車？ | |
| 選擇評論和評分最高的產品 | |
| Glitzy Galz 女士高跟鞋的評分最高，為 4.5 顆星 (滿分 5 顆星)。你想要哪種尺寸的 Glitzy Galz 女士高跟鞋？尺寸範圍為 5 到 11。 | |
| 6 | |
| 太好了！已將 1 件 6 號的 Glitzy Galz 女款高跟鞋加入購物車。還有其他想加入購物車的商品嗎？ |
端對端購物體驗
使用者瀏覽產品目錄。代理會根據使用者要求提供建議。經過幾次搜尋後，使用者找到想購買的商品。代理人會確認要購買的商品尺寸和數量，以及預計送達日期。使用者要求變更送達日期，但該日期無法提供服務，因此同意原送達日期。服務專員會確認檔案中的送貨、付款和聯絡資訊。使用者更新運送資訊並確認。代理會下單並提供訂單編號給使用者。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 天氣越來越冷了，Do you have good sweaters | |
| [Presents products]。你對這些產品有興趣嗎？還是想找其他選項？ | |
| 我喜歡這件女裝毛衣，但我想找男童毛衣 | |
| [Presents products]。你對這些產品有興趣嗎？還是想找其他選項？ | |
| 將第一件女用毛衣加入購物車 | |
| 你想要 Nineteen Solid Round Neck Casual Women's Sweater 的哪個尺寸？我們提供 XS 到 XL 的尺寸。 | |
| 中 | |
| 太好了！已將 Nineteen Solid Round Neck Casual Women's Sweater (中號) 加入購物車，數量為 1。還有其他想加入購物車的商品嗎？ | |
| 否 | |
| 我們最快能在 2024 年 4 月 29 日將 Nineteen Solid Round Neck Casual Women's Sweater 寄給你。請問您方便嗎？ | |
| 4 月 28 日可以送達嗎？ | |
| 很抱歉，我們無法在 2024 年 4 月 28 日送達 Nineteen Solid Round Neck Casual Women's Sweater。我們最快會在 2024 年 4 月 29 日送達。 | |
| 好的，維持目前的送達日期 | |
| 好的，你的 Nineteen Solid Round Neck Casual Women's Sweater 將於 2024 年 4 月 29 日送達。現在，請檢查個人資料詳細資訊，確保所有內容都是最新狀態：\ | |
| 寄送地址：638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| 付款資訊：Visa 卡 (末四碼為 4111) 聯絡電話號碼：416-555-5555 電子郵件地址：email@example.com 請檢查這些詳細資料。如果一切正確無誤，請確認。如有任何變更需求，請告訴我。 |
|
| 我的地址已變更為 371 Talbot Street Carmichael, CA 95608 | |
| 你的寄送地址已成功更新為 371 Talbot Street, Carmichael, CA 95608。還有其他想修改的資訊嗎？ | |
| 否 | |
| 您已成功訂購 Nineteen Solid Round Neck Casual Women's Sweater，訂單 ID 為 ee6b4cc7。預計於 2024 年 4 月 29 日送達。 | |
| 謝謝 | |
| 訂單已成功提交！還需要其他協助嗎？ | |
| 不用了，謝謝 | |
| 很高興能幫上忙！如果需要 Cymbal Apparel 的任何產品，只要按一下滑鼠即可。\ |
查看訂單狀態
使用者要求查看訂單狀態。服務專員會收集訂單號碼並擷取訂單資訊。服務專員會提供訂單中的商品詳細資料，以及目前的狀態和預計送達日期。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 您好： | |
| 你可以從上方選項中選取，或直接輸入想查詢的內容，我會協助你。 | |
| 我想查看訂單狀態 | |
| 沒問題，我很樂意幫忙。如要開始進行相關程序，請提供訂單 ID。 | |
| ee6b4cc7 | |
| 訂單已確認！目前正在處理中。 以下是你的訂單內容： 十九號素色圓領休閒女用毛衣 尺寸：中號 數量：1 件 預計送達日期：2024 年 4 月 29 日 還有其他需要協助的地方嗎？ |
|
| 不用了，謝謝 | |
| 很高興能幫上忙！如果需要 Cymbal Apparel 的任何協助，只要按一下滑鼠即可。 |
退回訂單
使用者想退回訂單商品，服務專員會收集訂單編號、擷取訂單詳細資料，並確認要退貨的商品。服務專員接著會啟動退貨程序，並提供退貨單供使用者列印並貼在包裝上。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 您好： | |
| 你可以從上述選項中選取，或直接輸入想查詢的內容，我會協助你。 | |
| 我想退回訂單商品 | |
| 我很樂意協助你辦理退貨。請先提供訂單編號。 | |
| 0fc77d64 | |
| 感謝你提供訂單號碼。我們已找到您在 2024 年 4 月 12 日下的訂單。訂單包含一件 YK Printed Boy's Round Neck Dark Blue T-Shirt，尺寸為 S。這是你要退貨的商品嗎？ | |
| 是 | |
| 好的，我們已啟動退貨程序。退貨單隨附於下方。請列印這份文件，然後貼在包裹上再寄回。還需要其他協助嗎？ | |
| 不用了，謝謝 | |
| 很高興能幫上忙！如果需要 Cymbal Apparel 的任何協助，只要按一下滑鼠即可。 |
基本設定
如要設定這個預建代理程式，請按照下列步驟操作：
- 匯入預先建構的代理程式。
- 使用外部服務設定提供的工具，請參閱「工具設定」。
工具設定
這個代理程式包含用於整合外部服務的工具。如要設定這些工具，請按照下列步驟操作：
- 建立名為
apparel-db的 Firestore 資料庫。 - 建立 Firestore Integration 連接器。
- 下載 Shopping Assistant 的 Application Integration。
- 將所有對
projects/customermod-genai-sa/locations/us-central1/connections/firestore的參照，替換為步驟 2 中建立的連接器 ID。 - 上傳並發布整合項目。
- 將
Cloud Functions Invoker角色授予 Dialogflow 服務代理。 - 按照步驟設定零售目錄
- 更新屬性控制項，即可擷取下列欄位：ageGroups、availability、categories、colorFamilies、colors、conditions、cost、currencyCode、description、discount、images、materials、patterns、price、sizes、title、uri。
- 將範例目錄匯入目錄的分支 1，並設為預設分支。
- 從這裡下載 Cloud Run 函式，然後更新
config.toml。 - 請按照步驟部署 Cloud Run 函式。
- 將
Retail ViewerIAM 角色授予您部署的 Cloud Run 函式。 - 針對下列工具：
get-order-status、order-lookup、place-order和return-order，請更新paths屬性，參照您在 OpenAPI 規格的步驟 5 中建立的整合，並選擇服務帳戶驗證，使用您授予Application Integration Invoker角色的服務帳戶。 - 將伺服器網址屬性更新為您為其餘工具部署的 Cloud Run 函式。
商品搜尋
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 追蹤訂單。並根據訂單狀態提供適當訊息。
完成
代理程式及其整合功能應已設定完成，可開始測試。