零售預先建構的代理程式

零售業預建代理 (採用 Playbook) 可讓您搜尋商品、取得產品推薦及下單。

對話範例

這個對話範例顯示了這個預先建構代理處理的常見情境。

搜尋產品及購買商品

使用者詢問店內有哪些手錶。
代理會推薦符合這些條件的產品。
使用者將產品加入購物車。
使用者將另一項產品加入購物車。
使用者詢問購物車內容。
代理列出購物車中的商品，使用者確認要購買。
代理下單並提供確認號碼。
使用者要求推薦手機。
代理推薦店內現有的手機。
使用者將其中一項商品加入購物車。
使用者訂購手機並提供確認號碼。

使用者輸入內容	代理回覆
您好：
	嗨，我是你的 Google 購物助理。我可以協助你搜尋商品及下單。今天需要什麼協助呢？
你有什麼手錶？
	我們有 Google Watch。要加入購物車嗎？
是，請新增兩個
	沒問題。我已將兩支 Google 手錶加入購物車。要繼續設定嗎？
可以順便幫我把一支 Google Pixel 8 加入購物車嗎？
	沒問題。我已將一部 Google Pixel 8 加入購物車。要繼續設定嗎？
我的購物車裡有哪些商品？
	你的購物車中有一支 Google Pixel 8 和兩支 Google Pixel Watch。要結帳嗎？
好，謝謝
	好的，我已下單購買一支 Google Pixel 8 和兩支 Google Watch。您的確認編號為 QKA67DW2。
	還需要其他協助嗎？
其實，你也可以幫我找新手機嗎？
	我們有 Google Pixel 8 和 Google Pixel 7 手機，你想購買其中一款嗎？
好，我要 Pixel 8
	沒問題。我已將一部 Google Pixel 8 手機加入購物車。要繼續設定嗎？
不，我們可以看看
	購物車中有一支 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 執行安裝程式
部署所有必要服務後，請使用安裝程式記錄的網址，在預先建構的代理中設定各項工具：
Generative AI App Builder
1. 如果您尚未匯入預先建構的代理，請將代理匯入專案。
2. 前往 Generative AI App Builder。
  Generative AI App Builder
3. 從控制台下拉式選單中選取專案。
4. 選取應用程式。
5. 按一下「工具」圖示。
6. 針對代理中的每項工具，編輯結構定義，將 servers: 欄位中的網址替換為安裝程式記錄的端點。
7. 按一下 [儲存]。
Dialogflow CX
1. 如果您尚未匯入預先建構的代理，請將代理匯入專案。
2. 開啟 Dialogflow CX 控制台。
3. 選擇 Google Cloud 專案。
4. 選取代理程式。
5. 按一下「生成式資源」圖示。
6. 按一下「工具」。
7. 針對代理中的每項工具，編輯結構定義，將 servers 欄位中的網址替換為安裝程式記錄的端點。
8. 按一下 [儲存]。
將「Cloud Datastore 使用者」角色授予 Compute Engine 服務帳戶 (your-project-number-developer.gserviceaccount.com)，讓新部署的 Cloud Run 函式可以存取 Firestore。

Google 商店 API 工具

Google 商店 API 工具會根據搜尋字詞，從 Google 商店擷取商品。

管理購物車工具

使用者可以透過「管理購物車」工具查看、新增及移除商品，藉此管理購物車。

下單工具

「下單」工具會為使用者目前的購物車下單，並傳回確認號碼。

完成

代理已設定完成，可以開始測試。

電影專家

購物助理

零售預先建構的代理程式 透過集合功能整理內容 你可以依據偏好儲存及分類內容。