購物小幫手以指南為基礎的預先建構代理程式可提供零售產品查詢、訂購、訂單狀態和訂單取消功能。這項服務使用 Vertex AI Search for Retail 和自訂執行載荷，提供豐富的視覺體驗。
對話方塊範例
以下對話方塊範例說明這個預先建構的服務代理人處理的常見情境。
產品和評論比較
使用者要求瀏覽傳統紗麗。代理人會提供一些熱門選項，使用者選取第一個選項。使用者詢問是否有搭配的鞋子。代理程式會提供熱門選項，使用者要求比較評論，並選取評分最高的選項。服務專員詢問鞋子尺寸，並確認鞋子已加入購物車。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請顯示傳統沙麗 | |
| [展示產品] 這些產品是否有任何產品引起你的興趣，或是你想尋找其他選項？ | |
| 第 1 個看起來沒問題 | |
| 選得好！印度美女自製的印花喬其紗紗麗是一件精美的服飾。由於紗麗通常只有一種尺寸，因此會非常合身。你要將這項商品加入購物車嗎？ | |
| 你有搭配的鞋跟嗎？ | |
| [展示產品] 這些產品是否有任何產品引起你的興趣，或是你想尋找其他選項？ | |
| 是的，但你能否查看顧客評論，並從中挑選最佳評論 | |
| Flat n Heels 女裝高跟鞋的平均評分為 5 顆星 (滿分 5 顆星)，而 Glitzy Galz 女裝高跟鞋的平均評分為 5 顆星 (滿分 5 顆星)。購買 Flat n Heels 女用高跟鞋的顧客給予的評價褒貶不一，有些人認為鞋子一開始穿起來很舒適，但幾小時後就會不舒服，其他人則稱讚鞋子穿起來很舒適。另一方面，Glitzy Galz 女用高跟鞋的評論大多是正面，顧客讚賞鞋子合腳、品質和設計。請問要將哪一項商品加入購物車？ | |
| 選擇評論和評分較好的產品 | |
| Glitzy Galz Women Heels 的最高評分為 4.5 顆星 (滿分 5 顆星)。你想購買 Glitzy Galz 女式高跟鞋的哪種尺寸？我們提供 5 到 11 號尺寸。 | |
| 6 | |
| 太好了！你已將 Glitzy Galz 女式高跟鞋 (尺寸 6) 加入購物車，數量為 1。還有其他想加入購物車的商品嗎？ |
端對端購物體驗
使用者瀏覽產品目錄。代理會根據使用者的要求提供建議。使用者搜尋幾次後，找到要購買的商品。服務專員會確認要購買的商品尺寸和數量，以及預計送達日期。使用者要求其他無法提供的送達日期，並同意原先的送達日期。服務專員會確認檔案中的運送、付款和聯絡資訊。使用者更新運送資訊並確認。服務專員會下單，並提供訂單號碼給使用者。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 天氣開始變冷了。你有好看的毛衣嗎 | |
| [產品介紹]。你對這些產品有興趣嗎？還是想找其他選項？ | |
| 我想要買一件女士毛衣給太太，但我要找一件男孩的毛衣 | |
| [產品介紹]。你對這些產品有興趣嗎？還是想找其他選項？ | |
| 將第一件女士毛衣加入購物車 | |
| 你想購買哪種尺寸的 Nineteen Solid Round Neck Casual Women's Sweater？我們提供從 XS 到 XXXL 的尺寸。 | |
| 中 | |
| 太好了！您已將 Nineteen 中性休閒圓領毛衣 (中碼) 新增至購物車，數量為 1。還有其他想加入購物車的商品嗎？ | |
| 否 | |
| 我們最快會在 2024 年 4 月 29 日為您出貨 Nineteen 素色圓領休閒女式毛衣。請問您方便嗎？ | |
| 可以於 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 | |
| 你的訂單已確認！目前正在處理。 你訂購的商品如下： Nineteen Solid Round Neck Casual Women's Sweater 尺寸：Medium 數量：1 預計送達日期：2024 年 4 月 29 日 是否還有其他需要協助的地方？ |
|
| 不用了，謝謝 | |
| 很高興能為您解決問題！如果你需要 Cymbal Apparel 的任何產品，只要點選一下，就能與我聯絡。 |
退回訂單
使用者想退回訂單。服務專員會收集訂單號碼、擷取訂單詳細資料，並確認要退回的商品。接著，服務專員會啟動退貨程序，並提供退貨標籤，供使用者列印並貼在包裹上。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 您好： | |
| 歡迎從上述選項中選擇，或直接輸入你要尋找的內容，我會提供協助。 | |
| 我想退回訂購商品 | |
| 我很樂意協助你辦理退貨。首先，可以請你提供訂單號碼嗎？ | |
| 0fc77d64 | |
| 感謝你提供訂單號碼。我發現你在 2024 年 4 月 12 日下單。訂單包含一件 YK 男童圓領深藍色 T 恤 (小號)。這是你要退貨的商品嗎？ | |
| 是 | |
| 好的，我已啟動退貨程序。下方附上退貨單。請先列印出來，再貼在包裹上寄回。還有其他問題需要我協助嗎？ | |
| 不用了，謝謝 | |
| 很高興能為您解決問題！如果你需要 Cymbal Apparel 的任何產品，只要點選一下，就能與我聯絡。 |
基本設定
如要設定這個預先建構的代理程式，請按照下列步驟操作：
- 匯入預先建構的代理程式。
- 請使用外部服務設定提供的工具，請參閱工具設定。
工具設定
這個代理程式包含用於整合外部服務的工具。如要設定這些工具，請按照下列步驟操作：
- 建立名為
apparel-db的 Firestore 資料庫。 - 建立 Firestore 整合連接器。
- 下載 Shopping Assistant 的應用程式整合功能。
- 將所有
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屬性，以便參照您在步驟 5 中為 OpenAPI 規格建立的整合，並選擇Service Account authentication，並選擇您已授予Application Integration Invoker角色的服務帳戶。 - 將伺服器網址屬性更新為您為其餘工具部署的 Cloud Run 函式。
商品搜尋
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 追蹤訂單。並根據訂單狀態提供適當的訊息。
完成
代理程式及其整合功能現在應已設定完成，可以進行測試。