代理

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

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

建立虛擬服務專員

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

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

控制台

1. 開啟 Dialogflow CX 控制台。
2. 建立或選擇專案。
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
• 流程
• 網頁
• 路徑群組

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

智慧端點

如果代理程式已啟用智慧端點，您可以按照下列方式，為數值參數自訂智慧端點行為：

1. 將「Minimum digits」(最少位數)設為提示智慧端點，等待收集所有數字。
2. 設定「修正轉錄稿」，修正常見的數字轉錄錯誤，提升數字語音辨識準確度。只有指定 en 或 en-* 語言代碼的要求支援這項功能。
3. 設定「等待逾時」，指定額外時間。Dialogflow CX 會等待使用者提供其他輸入內容。

Speech-to-Text (STT) API 會使用機器學習技術將音訊轉換為文字，方便您將語音辨識功能整合至應用程式。

支援的 STT 模型包括任何長篇模型 (例如 phone_call)。 僅支援 en-US 語言。

注意： 如果使用短模型，這會啟用雲端語音端點。

Dialogflow CX 逾時是寬限期，使用者可以在語音逾時觸發前，在語音轉文字記錄中新增內容。語音逾時觸發後，Dialogflow CX 會開始執行意圖 (例如自然回饋、虛擬服務專員回應、Webhook 執行 + 虛擬服務專員回應)。

Dialogflow CX 會根據轉錄稿，使用經驗法則指定應選擇的逾時時間。舉例來說，如果意圖比對成功，可以選擇非常短的逾時時間。如果意圖不相符，可以延長逾時時間，讓使用者說出其他內容，然後重試意圖比對。

專案現在可以運用下列 STT 強化功能：

• 更快速的端點偵測：即時分析會使用音訊轉錄串流，在 STT 串流保持開啟的狀態下，區分自然停頓和語音結束。如果使用者已說完話，Dialogflow CX 會提早終止串流，以便更快提供回應。
• 最佳化數字收集：Dialogflow CX 會對最終 STT 轉錄稿使用啟發式方法，確認已擷取所有預期數字。這項功能也會自動修正常見的轉錄錯誤 (例如將「to」/「too」解析為「2」、「for」解析為「4」，或「ate」/「weight」解析為「8」)。
• 自然對話回饋：如果使用者在說話時停頓，Dialogflow CX 可以動態延長語音轉文字逾時時間，避免過早中斷對話，或插入自然的回應提示 (例如「嗯嗯」、「喔喔」)，確認虛擬代理程式仍在聆聽。

匯出及還原代理程式

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

說明文件。

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

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

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

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

• 環境： 目標代理程式中的所有自訂環境維持不變。 只要相關聯的環境存在，目標代理程式中自訂環境參照的流程版本就會繼續存在。 不過，這些過時的工作流程版本不會列出，代理程式也無法選取這些版本。
• Vertex AI Agents 應用程式： 目標代理程式 (即 GenAppBuilderSettings 中的 engine 值) 的關聯性維持不變。 也就是說，資料儲存庫代理只能還原到其他現有的資料儲存庫代理，因為產生的代理也需要與 Vertex AI Agents 應用程式建立關聯。

• Vertex AI Agents 資料儲存庫： 目標代理程式中的所有資料儲存庫參照都會根據下列規則覆寫：

  • 如果目標代理程式未與應用程式建立關聯，就無法將含有資料儲存庫參照的代理程式還原至該應用程式。嘗試這麼做會導致錯誤訊息。如要修正這個問題，您可以從頭建立新的資料儲存庫代理程式。(或者，您也可以為現有代理新增資料儲存庫狀態處理常式，將其變成資料儲存庫代理。(系統會引導您將相關聯的應用程式新增至代理程式)。
  • 如果目標代理程式與應用程式相關聯，還原後所有資料儲存庫參照都會更新：專案 ID 和位置會更新，以符合目標代理程式的應用程式。 Google Cloud 集合 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. 選擇代理程式的專案。
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. 選擇代理程式的專案。
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 虛擬服務專員和資料。