Conversational Agents (Dialogflow CX) 代理程式是虛擬服務專員,可處理與使用者的並行對話。這種自然語言理解模組可以解讀人類語言的細微差異。Conversational Agents (Dialogflow CX) 會將使用者在對話期間提供的文字或音訊內容,轉譯為應用程式與服務可以解讀的結構化資料。您可以設計並建構 Conversational Agents (Dialogflow CX) 代理程式,處理系統所需的對話類型。
Conversational Agents (Dialogflow CX) 代理程式與客服中心的真人客服專員類似,您可以訓練代理程式和客服專員來處理預期的對話情境,而且訓練內容不必過於明確。
建立虛擬服務專員
如要建立代理程式,請按照下列步驟操作:
主控台
- 開啟 Dialogflow CX 控制台。
- 建立或選擇 Google Cloud 專案。
- 按一下「建立代理程式」。
- 選取「自動產生」,建立資料儲存庫代理程式,或選取「自行建構」,建立其他類型的代理程式。
- 填寫基本服務專員設定表單:
- 按一下 [儲存]。
API
如果尚未為專案設定位置資訊設定,請先使用控制台設定這些設定,再透過 API 建立代理程式。目前無法透過 API 設定位置資訊設定。
如要建立代理程式,請參閱 Agent
類型的 create
方法。
為代理程式參照選取通訊協定和版本:
通訊協定 | V3 | V3beta1 |
---|---|---|
REST | 服務專員資源 | 服務專員資源 |
RPC | 服務專員介面 | 服務專員介面 |
C++ | AgentsClient | 不適用 |
C# | AgentsClient | 不適用 |
Go | AgentsClient | 不適用 |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 不適用 | 不適用 |
Python | AgentsClient | AgentsClient |
Ruby | 不適用 | 不適用 |
服務專員資料
Conversational Agents (Dialogflow CX) 代理程式是虛擬服務專員設定和資料的頂層容器。以下資料與代理程式相關聯:
如要進一步瞭解資料在不同層級的套用方式,請參閱資料套用層級。
匯出及還原代理程式
您可以將代理程式匯出到檔案,再透過該檔案還原代理程式。
代理程式匯出項目包含所有代理程式資料,但下列資料除外:
還原代理程式會覆寫所有目標代理程式資料 (包括所有流程版本),但下列項目除外:
- 環境: 目標代理程式中的所有自訂環境維持不變。 只要相關聯的環境存在,目標代理程式中自訂環境參照的流程版本就會繼續存在。不過,這些過時的流程版本不會列出,也不會顯示為代理程式可選取的流程版本。
- Vertex AI Agents 應用程式:
目標代理程式與 Vertex AI Agents 應用程式的關聯維持不變。(換句話說,GenAppBuilderSettings 中的
engine
值)。這表示資料儲存庫代理程式只能還原至其他現有的資料儲存庫代理程式,因為產生的代理程式也需要與 Vertex AI Agents 應用程式建立關聯。 Vertex AI Agents 資料儲存庫: 系統會根據下列規則,覆寫目標虛擬服務專員中的所有資料儲存庫參照:
- 如果目標代理程式未與應用程式建立關聯,就無法將含有資料儲存庫參照的代理程式還原至該應用程式。嘗試這麼做會導致錯誤訊息。如要修正這個問題,您可以從頭建立新的資料儲存庫代理程式,(或者,您也可以為現有代理新增資料儲存庫狀態處理常式,將其變成資料儲存庫代理。在這種情況下,系統會引導您將相關聯的應用程式新增至代理程式。)
- 如果目標代理程式與應用程式相關聯,還原後所有資料儲存參照都會更新:Google Cloud 專案 ID 和位置資訊會更新,以符合目標代理程式的應用程式。集合 ID 和資料儲存庫 ID 不會變更。也就是說,在還原作業之前,您需要將所有 ID 的資料存放區 (類型相符) 新增至目標代理程式的應用程式。
舉例來說,如果來源代理程式參照名為
projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1
的資料儲存庫,且目標代理程式的應用程式名為projects/321/locations/us-east1/collections/default_collections/engines/app123
,則目標代理程式中產生的資料儲存庫參照會變成:projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
匯出時, 你可以選取匯出檔案格式。 如果您使用來源控管版本管理代理程式資料,請以 JSON 格式匯出。還原虛擬服務專員時,Conversational Agents (Dialogflow CX) 會自動判斷檔案格式。
如要匯出或還原代理程式,請按照下列步驟操作:
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇代理程式的 Google Cloud 專案。
- 按一下清單中代理程式的選項選單 more_vert。
- 按一下「匯出」或「還原」按鈕。
- 按照操作說明完成設定。
API
請參閱 Agent
類型的 export
和 restore
方法。
為代理程式參照選取通訊協定和版本:
通訊協定 | V3 | V3beta1 |
---|---|---|
REST | 服務專員資源 | 服務專員資源 |
RPC | 服務專員介面 | 服務專員介面 |
C++ | AgentsClient | 不適用 |
C# | AgentsClient | 不適用 |
Go | AgentsClient | 不適用 |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 不適用 | 不適用 |
Python | AgentsClient | AgentsClient |
Ruby | 不適用 | 不適用 |
如果代理程式大小超過上限,請使用 Cloud Storage 選項匯出及還原代理程式。
如果您使用 GitHub,請參閱 GitHub 匯出/還原指南。
刪除代理程式
您需要有提供完整存取權或編輯存取權的角色,才能刪除代理程式。詳情請參閱存取權控管指南。
如要刪除代理程式:
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇代理程式的 Google Cloud 專案。
- 按一下清單中代理程式的選項選單 more_vert。
- 按一下刪除按鈕。 delete
- 在對話方塊中確認刪除。
API
請參閱 Agent
類型的 delete
方法。
為代理程式參照選取通訊協定和版本:
通訊協定 | V3 | V3beta1 |
---|---|---|
REST | 服務專員資源 | 服務專員資源 |
RPC | 服務專員介面 | 服務專員介面 |
C++ | AgentsClient | 不適用 |
C# | AgentsClient | 不適用 |
Go | AgentsClient | 不適用 |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 不適用 | 不適用 |
Python | AgentsClient | AgentsClient |
Ruby | 不適用 | 不適用 |
如果刪除專案,系統會立即刪除所有與專案相關的 Conversational Agents (Dialogflow CX) 代理程式和資料。