代理

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
小茹	不適用	不適用

關閉

代理資料

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

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

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

智慧端點偵測

Speech-to-Text (STT) API 可運用機器學習技術將音訊轉換為文字，讓您將語音辨識功能整合至應用程式。支援的 STT 模型包括任何長篇模型 (例如 phone_call)。僅支援 en-US 語言。

注意： 如果使用短模型，這項設定會啟用 Cloud Speech 端點偵測功能。

如果代理已啟用智慧型端點偵測，您可以設定「等待逾時」來指定額外時間，自訂數值參數的智慧型端點偵測行為。Dialogflow CX 接著會等待使用者提供額外輸入內容。

等待逾時是寬限期，可讓您在語音逾時觸發前，將內容新增至 STT 轉錄稿。Dialogflow CX 會根據轉錄稿，使用經驗法則指定要選擇的逾時時間。舉例來說，如果意圖比對成功，系統可能會選擇非常短的逾時時間。如果意圖不相符，系統會延長逾時時間，讓您說出其他內容，並重新嘗試比對意圖。

其他 STT 功能包括：

• 更快速的端點偵測：即時分析功能會使用音訊轉錄串流，在 STT 串流保持開啟時，區分自然停頓和語句完成。如果使用者已說完，Dialogflow CX 會提早終止串流，以便更快提供回覆。
• 自然對話回饋：如果使用者在說話時停頓，Dialogflow CX 可以動態延長 STT 逾時時間，避免過早中斷，或插入自然的附和提示 (例如「嗯嗯」、「喔喔」)，確認虛擬服務專員仍在聆聽。

匯出及還原代理

警告： 2025 年 8 月 15 日起，我們將不再匯出 OpenAPI 工具和 Webhook 的原始值憑證。建議您改為將憑證儲存在 Secret Manager。如需操作說明，請參閱 Webhook 和工具說明文件。

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

匯出的代理資料包含所有代理資料，但下列項目除外：

• 流程版本：只有所選環境中使用的流程版本會匯出至檔案。
• 環境： 系統不會將所選環境以外的環境匯出至檔案。

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

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

• Vertex AI Agents 資料儲存庫：目標 AI 代理中所有資料儲存庫的參照都會遭到覆寫，規則如下：

  • 如果目標代理未與應用程式建立關聯，就無法將含有資料儲存庫參照的代理還原至該代理。如果嘗試這麼做，會收到錯誤訊息。如要修正這個問題，您可以從頭建立新的資料儲存庫代理，(或者，您也可以在現有代理中新增資料儲存庫狀態處理常式，將其轉換為資料儲存庫代理。在這種情況下，系統會引導您將相關聯的應用程式新增至代理。
  • 如果目標代理與應用程式相關聯，還原時會更新所有資料儲存庫參照： 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 引擎。舉例來說，在匯出的 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
小茹	不適用	不適用

關閉

如果代理程式大小超過上限，請使用 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
小茹	不適用	不適用

關閉

如果刪除專案，與專案相關聯的所有 Dialogflow CX 代理和資料都會立即刪除。