代理程式

Dialogflow CX 代理程式是虛擬服務專員，可處理與使用者的並行對話。這種自然語言理解模組可以解讀人類語言的細微差異。Dialogflow CX 會將使用者在對話期間提供的文字或音訊內容轉譯為應用程式與服務可以解讀的結構化資料。您可以設計並建構 Dialogflow CX 代理程式來處理您的系統所需要的對話類型。

Dialogflow CX 代理程式與客服中心的真人客服專員類似，您可以訓練代理程式和客服專員來處理預期的對話情境，而且訓練內容不必過於明確。

建立虛擬服務專員

注意： 您可以為一個 Google Cloud 專案建立多個 Dialogflow CX 代理程式。

如要建立代理程式，請按照下列步驟操作：

控制台

1. 開啟 Dialogflow CX 控制台。
2. 建立或選擇 Google Cloud 專案。
3. 按一下「建立代理程式」。
4. 選取「自動產生」，建立資料儲存庫代理程式，或選取「自行建立」，建立其他類型的代理程式。
5. 填寫基本服務專員設定表單：
   1. 顯示名稱可自由選擇。
   2. 選取偏好的位置。 如要變更進階位置資訊設定，請按一下「編輯」按鈕。
   3. 選取偏好的時區。
   4. 選取代理程式的預設語言。 服務專員建立後，就無法變更預設語言。
6. 按一下 [儲存]。

API

如果尚未為專案設定位置資訊設定，請先透過控制台設定這些設定，再使用 API 建立代理程式。目前無法透過 API 設定位置資訊設定。

如要建立代理程式，請參閱 Agent 類型的 create 方法。前往 Agent API 參考資料

為代理程式參照選取通訊協定和版本：

通訊協定	V3	V3beta1
REST	服務專員資源	服務專員資源
RPC	服務專員介面	服務專員介面
C++	AgentsClient	不適用
C#	AgentsClient	不適用
Go	AgentsClient	不適用
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	不適用	不適用
Python	AgentsClient	AgentsClient
Ruby	不適用	不適用

關閉

服務專員資料

Dialogflow CX 代理程式是虛擬服務專員設定和資料的頂層容器。以下資料與代理程式相關聯：

• 意圖
• 實體類型
• Webhook
• 流程
• 網頁
• 路徑群組

如要進一步瞭解資料在不同層級的套用方式，請參閱資料套用層級。

匯出及還原代理程式

警告： 自 2025 年 8 月 15 日起，我們將不再匯出 OpenAPI 工具和 Webhook 的原始值憑證。您應遷移至 Secret Manager 儲存憑證。如需操作說明，請參閱「Webhook」和「工具」說明文件。

您可以將代理程式匯出到檔案，並使用該檔案還原代理程式。

代理程式匯出作業會匯出所有代理程式資料，但下列資料除外：

• 流程版本： 只有草稿流程會匯出至檔案。
• 環境： 自訂環境不會匯出至檔案。

還原代理程式會覆寫所有目標代理程式資料 (包括所有流程版本)，但下列項目除外：

• 環境： 目標代理程式中的所有自訂環境維持不變。 只要相關聯的環境存在，目標代理程式中自訂環境參照的流程版本就會繼續存在。不過，這些過時的流程版本不會列出，也不會顯示為代理程式可選取的流程版本。
• 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

注意：在 API 和匯出資料的內容中，Vertex AI Agents 應用程式稱為 GenAppBuilder Engine。 舉例來說，在匯出的 JSON 套件中，您可以在 agent.json 檔案的 genAppBuilderSettings.engine 鍵下找到引擎名稱。

匯出時， 您可以選取匯出檔案格式。 如果您使用來源控管版本管理代理程式資料，請以 JSON 格式匯出。還原虛擬服務專員時，Dialogflow CX 會自動判斷檔案格式。

如要匯出或還原代理程式，請按照下列步驟操作：

控制台

1. 開啟 Dialogflow CX 控制台。
2. 選擇代理程式的 Google Cloud 專案。
3. 按一下清單中代理程式的選項選單 。
4. 按一下「匯出」或「還原」按鈕。
5. 按照操作說明完成設定。

注意： 如要還原資料儲存庫代理程式，請確認目標代理程式是資料儲存庫代理程式。

API

請參閱 Agent 類型的 export 和 restore 方法。前往 Agent API 參考資料

為代理程式參照選取通訊協定和版本：

通訊協定	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 匯出/還原指南。

刪除代理程式

注意：代理程式一經刪除即無法復原。如有需要，請匯出代理程式做為備份。

您需要有提供完整存取權或編輯存取權的角色，才能刪除代理程式。詳情請參閱存取權控管指南。

如要刪除代理程式：

控制台

1. 開啟 Dialogflow CX 控制台。
2. 選擇代理程式的 Google Cloud 專案。
3. 按一下清單中代理程式的選項選單 。
4. 按一下刪除按鈕。
5. 在對話方塊中確認刪除。

API

請參閱 Agent 類型的 delete 方法。 前往 Agent API 參考資料

為代理程式參照選取通訊協定和版本：

通訊協定	V3	V3beta1
REST	服務專員資源	服務專員資源
RPC	服務專員介面	服務專員介面
C++	AgentsClient	不適用
C#	AgentsClient	不適用
Go	AgentsClient	不適用
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	不適用	不適用
Python	AgentsClient	AgentsClient
Ruby	不適用	不適用

關閉

如果刪除專案，系統會立即刪除與專案相關聯的所有 Dialogflow CX 虛擬服務專員和資料。