使用者可以透過零售業劇本型預先建構的代理程式搜尋商品、取得產品推薦，以及下單。
對話範例
下列範例對話說明這個預先建構的代理程式處理的常見情境。
搜尋產品及購買商品
使用者詢問商店提供的智慧手錶。代理商會推薦符合這項條件的產品，使用者則將產品加入購物車。使用者確認要下單，代理程式會提供確認號碼來確認訂單。接著，使用者要求提供手機建議，服務專員會建議手機、將手機加入使用者的購物車，並為使用者下單。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 嗨 | |
| 你好，我是你的 Google 購物助理。我可以協助你搜尋商品和下單。今天需要什麼協助呢？ | |
| 你有哪些手錶 | |
| 我們有 Google Watch，要將這項商品加入購物車嗎？ | |
| yes add two please | |
| 沒問題。我已將兩支 Google 手錶加入購物車。要繼續設定嗎？ | |
| 可以幫我將一部 Google Pixel 8 加入購物車嗎？ | |
| 沒問題。已將一部 Google Pixel 8 加入購物車。要繼續設定嗎？ | |
| 我的購物車裡有哪些項目？ | |
| 購物車中有一部 Google Pixel 8 和兩支 Google 手錶。請問要結帳嗎？ | |
| 好，謝謝 | |
| 好的，我已下訂一隻 Google Pixel 8 和兩支 Google 手錶。確認編號為 QKA67DW2。 | |
| 還需要其他協助嗎？ | |
| 其實你也可以幫我找新手機嗎？ | |
| 我們有 Google 手機 Pixel 8 和 Google 手機 Pixel 7，請問你要購買哪一款？ | |
| 是，請提供 Pixel 8 | |
| 沒問題。我已將一部 Google 手機 Pixel 8 加入購物車。要繼續設定嗎？ | |
| no we can check out | |
| 購物車中有一部 Google Pixel 8 手機。要使用這個購物車結帳嗎？ | |
| 是 | |
| 好的，我已為你下單。你的訂單包含一部 Google 手機 Pixel 8。確認號碼為 Y43KTF0T。 | |
| 還需要其他協助嗎？ | |
| 不用了，謝謝 | |
| 好的，感謝你使用 Google 購物！祝你有美好的一天。 |
購物車管理
使用者要求將某些商品加入購物車，然後在下單前移除其中一項商品。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 你好，我想買手機 | |
| 我們有 Google 手機 Pixel 8 和 Google 手機 Pixel 7。請問你想購買哪一個？ | |
| 給我兩個 8 號 | |
| 沒問題。我已將兩部 Google 手機 Pixel 8 加入購物車。要繼續設定嗎？ | |
| 實際上可以移除其中一個嗎？ | |
| 沒問題，我已從購物車中移除一部 Google 手機 Pixel 8。要繼續設定嗎？ | |
| 我已準備好下單 | |
| 好的，我已下訂一隻 Google 手機 Pixel 8。確認號碼為 X0KP6K5T。 | |
| 還需要其他協助嗎？ | |
| 沒有，就這樣 | |
| 好的，感謝你使用 Google 購物！祝你有美好的一天。 |
找不到產品
使用者詢問商店未販售的產品。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 嗨 | |
| 你好，我是你的 Google 購物助理。我可以協助你搜尋商品和下單。今天需要什麼協助呢？ | |
| 我想買車 | |
| 很抱歉，我們目前沒有任何車輛。你還想尋找其他內容嗎？ | |
| 對啊，那手錶呢？ | |
| 我們有 Google Watch，要將這項商品加入購物車嗎？ | |
| 不用了，謝謝 | |
| 還需要其他協助嗎？ | |
| 否 | |
| 好的，感謝你使用 Google 購物！祝你有美好的一天。 |
無法辨識的輸入內容
使用者詢問與產品或訂購無關的主題。代理程式會重複說明涵蓋的主題，並詢問使用者需要哪方面的協助。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 嗨 | |
| 你好，我是你的 Google 購物助理。我可以協助你搜尋商品和下單。今天需要什麼協助呢？ | |
| 我想預訂飯店 | |
| 很抱歉，我無法提供這方面的協助。我可以協助你搜尋產品，包括手機、手錶和耳機。你也可以請我下單。今天需要什麼協助呢？ |
基本設定
如要設定這個預建代理程式，請按照下列步驟操作：
- 匯入預先建構的代理程式。
- 使用外部服務設定提供的工具，請參閱「工具設定」。
工具設定
這個代理程式包含用於整合外部服務的工具。您可以使用預先建構的工具安裝程式，為預先建構的代理程式部署程式碼範例和資料。
如要部署及設定零售業預建代理程式的程式碼範例和資料，請展開查看操作說明。
- 將預建工具安裝程式下載到本機目錄。
- 前往下載 installer.zip 的本機目錄。
- 解壓縮 installer.zip，然後開啟
installer資料夾。 - 請參閱 README.md，詳細瞭解安裝程式及其需求。
- 執行
pip install -r requirements.txt安裝必要條件。 -
執行
gcloud auth application-default login，使用 gcloud auth 進行驗證。 -
使用下列指令執行安裝程式：
python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail -
部署所有必要服務後，請使用安裝程式記錄的網址，在預先建構的代理程式中設定各項工具：
Vertex AI Agent Builder 控制台
- 如果尚未匯入預建代理程式，請將代理程式匯入專案。
- 前往 Vertex AI Agent Builder 控制台。
- 從主控台下拉式選單中選取專案。
- 選取應用程式。
- 按一下「工具」圖示。
-
針對代理程式中的每個工具，編輯結構定義，將
servers:欄位中的網址替換為安裝程式記錄的端點。 - 按一下 [儲存]。
Dialogflow CX
- 如果尚未匯入預建代理程式，請將代理程式匯入專案。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 按一下「生成資源」圖示。
- 按一下「工具」。
-
針對代理程式中的每個工具，編輯結構定義，將
servers欄位中的網址替換為安裝程式記錄的端點。 - 按一下 [儲存]。
-
將「Cloud Datastore 使用者」角色授予 Compute Engine 服務帳戶 (
your-project-number-developer.gserviceaccount.com)，這樣新部署的 Cloud Run 函式就能存取 Firestore。
Google Store API
Google Store API 工具會根據搜尋字詞，從 Google 商店擷取項目。
管理購物車
使用者可透過 Manage Shopping Cart 工具管理購物車，包括查看購物車中的所有商品、將商品加入購物車，以及從購物車中移除商品。
下單
Place Order 工具用於根據使用者目前的購物車內容下單，並傳回訂單確認號碼。
完成
代理程式及其整合功能應已設定完成，可開始測試。