購物助理預先建構的代理 (以 Playbook 為基礎)，可提供零售產品查詢、訂購、訂單狀態和取消訂單等功能。這項功能使用零售業專用代理搜尋和自訂執行酬載，提供豐富的視覺體驗。
對話範例
這個對話範例顯示了這個預先建構代理處理的常見情境。
產品和評論比較
- 使用者要求瀏覽傳統紗麗。
- 代理提供一些熱門選項，使用者選取第一個。
- 使用者要求搭配鞋子。
- 代理會提供一些熱門選項，使用者則要求比較評論，並選取評分最高的選項。
- 服務專員詢問尺寸，並確認鞋子已加入購物車。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 顯示傳統紗麗 | |
| [展示產品] 這些產品有你感興趣的嗎？還是你想看看其他選擇？ | |
| 第 1 個看起來不錯 | |
| 選得好！這款印度美學自訂設計印花時尚喬其紗莎麗非常美麗。由於紗麗通常只有一種尺寸，因此一定會完美合身。要加入購物車嗎？ | |
| 有搭配的高跟鞋嗎？ | |
| [展示產品] 這些產品有你感興趣的嗎？還是你想看看其他選擇？ | |
| 可以，但你能否瀏覽顧客評論，並從中挑選出最佳評論 | |
| Flat n Heels 女高跟鞋的平均評分為 4 顆星 (滿分 5 顆星)，Glitzy Galz 女高跟鞋的平均評分為 4.5 顆星 (滿分 5 顆星)。購買 Flat n Heels 女高跟鞋的顧客評價不一，有人認為一開始穿起來很舒服，但幾小時後就不舒服，也有人稱讚這款鞋很舒適。另一方面，Glitzy Galz 女高跟鞋則獲得多數好評，顧客稱讚其合腳、品質和設計。請問要將哪一項加入購物車？ | |
| 評論和評分最高的 | |
| Glitzy Galz 女高跟鞋的評分最高，滿分 5 顆星，獲得 4.5 顆星。請問 Glitzy Galz 女用高跟鞋要什麼尺寸？我們有 5 到 11 號。 | |
| 6 | |
| 太好了！1 雙 6 號 Glitzy Galz 女高跟鞋已加入購物車。還有其他商品要加入購物車嗎？ |
端對端購物體驗
- 使用者瀏覽產品目錄。
- 代理會根據使用者要求提供建議。
- 經過幾次搜尋後，使用者找到要購買的商品。
- 代理會確認要購買的商品尺寸和數量，以及預計送達日期。
- 使用者要求變更送達日期，但無法變更，因此同意原本的送達日期。
- 服務專員會確認系統記錄的運送、付款和聯絡資訊。
- 使用者更新外送資訊並確認。
- 代理下單並提供訂單編號給使用者。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 天氣越來越冷了。有好看的毛衣嗎？ | |
| [展示產品]。這些產品有你感興趣的嗎？還是想找其他的？ | |
| 我想買這件女裝毛衣給老婆，但我也想找男童毛衣 | |
| [展示產品]。這些產品有你感興趣的嗎？還是想找其他的？ | |
| 將第一件女士毛衣加入購物車 | |
| Nineteen 素色圓領休閒女款毛衣，您要什麼尺寸？我們有 XS 到 XL 的尺寸。 | |
| 中 | |
| 太好了！1 件 Nineteen 素色圓領休閒女用毛衣 (M 號) 已加入購物車。還有其他商品要加入購物車嗎？ | |
| 否 | |
| Nineteen Solid 圓領休閒女用毛衣最快可在 2024 年 4 月 29 日送達。請問您方便嗎？ | |
| 可以在 4 月 28 日送達嗎？ | |
| 很抱歉，我們無法在 2024 年 4 月 28 日送達 Nineteen 素色圓領休閒女用毛衣。最早可於 2024 年 4 月 29 日送達。 | |
| 好的，請維持原本的送達日期 | |
| 好的，Nineteen Solid 圓領休閒女用毛衣將於 2024 年 4 月 29 日送達。現在，請檢查個人資料，確保所有資訊都是最新狀態：\ | |
| Delivery Address: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| 付款資訊：Visa 卡 (末 4 碼為 4111) 聯絡電話：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 的任何協助，只要按一下就能聯絡我。\ |
查看訂單狀態
- 使用者要求查看訂單狀態。
- 代理會收集訂單編號並擷取訂單資訊。
- 代理會提供訂單中商品的詳細資料和預計送達日期。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 您好： | |
| 你可以從上方選項中選取，或直接輸入要查詢的內容，我會協助你。 | |
| 我想查看訂單狀態 | |
| 沒問題，我很樂意幫忙。首先，可以請你提供訂單 ID 嗎？ | |
| ee6b4cc7 | |
| 訂單已確認！目前正在處理中。 以下是你訂購的商品： Nineteen 素色圓領休閒女用毛衣 尺寸：M 號 數量：1 預計送達日期：2024 年 4 月 29 日 請問還有其他需要協助的地方嗎？ |
|
| 不用了，謝謝 | |
| 很高興能幫上忙！如果需要 Cymbal Apparel 的任何協助，只要按一下就能聯絡到我。 |
退回訂單
- 使用者想退回訂單商品。
- 代理會收集訂單號碼、擷取訂單詳細資料，並確認要退貨的商品。
- 服務專員啟動退貨程序，並提供退貨單，讓使用者列印並貼在包裹上。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 您好： | |
| 你可以從上方選項中選取，或直接輸入要查詢的內容，我會協助你。 | |
| 我想退回訂單 | |
| 我很樂意協助你辦理退貨。首先，請提供訂單編號。 | |
| 0fc77d64 | |
| 感謝你提供訂單號碼。我找到你在 2024 年 4 月 12 日下的訂單，訂單包含一件 YK 印花男孩圓領深藍色 T 恤，尺寸為 S。這是你要退貨的商品嗎？ | |
| 是 | |
| 好的，我已啟動退貨程序。退貨單附在下方，請列印出來並貼在包裹上，再寄回給我們。還需要其他協助嗎？ | |
| 不用了，謝謝 | |
| 很高興能幫上忙！如果需要 Cymbal Apparel 的任何協助，只要按一下就能聯絡到我。 |
基本設定
如要設定這個預先建構的代理，請按照下列步驟操作：
工具設定
這個代理包含工具，可用於整合外部服務。如要設定這些工具，請按照下列步驟操作：
- 建立名為
apparel-db的 Firestore 資料庫。 - 建立 Firestore Integration Connectors。
- 下載購物助理的 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 中建立的整合，並選擇「Service Account authentication」(服務帳戶驗證)，並使用您授予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 追蹤。並根據訂單狀態提供適當訊息。
完成
代理和整合項目應已設定完畢，可以開始測試。