使用 Application Integration 建構對話型代理

Application Integration 現在可直接與 Conversational Agents (Dialogflow CX) 整合，簡化對話式體驗的建立程序。這項功能可讓您直接在整合工作流程中，使用 API 觸發條件建構智慧型聊天機器人和工具，提升使用者互動體驗並自動執行工作。

什麼是對話式代理程式？

Conversational Agents (Dialogflow CX) 對話型服務專員是虛擬服務專員，可與使用者進行自然語言對話。這項技術會分析使用者輸入內容、解讀意圖，並提供適當的回應，打造互動式個人化對話體驗。這類服務專員可透過各種管道 (例如網站、行動應用程式和通訊平台) 處理對話。

什麼是對話式代理程式工具？

在 Conversational Agents (Dialogflow CX) 中，工具代表對話型代理程式可存取的特定功能或服務。工具是在劇本中定義，可讓代理程式執行擷取資料、執行 API 或與外部系統互動等動作。Application Integration 會根據整合的 API 觸發條件產生這些工具，方便您將整合邏輯連結至對話流程。

事前準備

使用 Application Integration 建立對話式代理程式工具前，請確認下列事項：

將下列 IAM 角色指派給主體：
- 服務帳戶管理員 (roles/iam.serviceAccountAdmin)
- 服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin)
- Dialogflow 主控台代理程式編輯者 (roles/dialogflow.consoleAgentEditor)
如要瞭解如何將角色授予主體，請參閱「授予或撤銷單一角色」。

服務帳戶所需的 IAM 角色

用於建立對話式代理程式工具的服務帳戶必須具備下列 IAM 角色：

服務帳戶	說明	必要的角色
服務帳戶	用於建立對話式代理程式工具的服務帳戶。	Application Integration 叫用者 (`roles/integrations.integrationInvoker`)
Dialogflow 服務代理人 (`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`)	Conversational Agents (Dialogflow CX) 用來存取整合服務的服務帳戶。	服務帳戶憑證建立者 (`roles/iam.serviceAccountTokenCreator`)

建立新的對話式服務專員工具

如要使用 Application Integration 建立新的對話式虛擬服務專員工具，請按照下列步驟操作：

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 點選「建立」。
  系統會在整合編輯器中開啟整合服務。
選取現有的整合服務。系統會在整合編輯器中開啟整合服務。
確認所選整合服務已設定一或多個 API 觸發條件。
發布整合版本。
在設計工具工具列中，按一下 (「動作」選單)，然後選取「建立對話式代理程式工具」。
Application Integration 會驗證必要的 API 是否已啟用。如果未啟用，系統會提示你啟用。
在「Create Conversational Agent Tool」(建立對話型代理工具) 窗格中，提供下列輸入內容：
1. API 觸發條件：系統預設會選取整合服務中的所有 API 觸發條件。您可以視需要取消選取不想納入工具的 API 觸發條件。
2. 類型：選取「建立新的對話型代理」，然後輸入下列詳細資料：
  1. 「Region」(區域)：選取代理程式的區域。
  2. 服務專員名稱：輸入服務專員名稱。
  3. 工具名稱：輸入工具名稱。
3. 服務帳戶：選擇具備必要角色和權限的服務帳戶，以存取代理程式的資源。如果缺少任一角色，系統會提示您授予角色。
按一下「查看規格」，即可查看所選觸發條件的生成規格。儲存前，您可以視需要編輯規格。
按一下「儲存」。
畫面上會顯示訊息，指出工具已成功建立。按一下「查看」，在 Conversational Agents (Dialogflow CX) 控制台中開啟服務專員。
在 Conversational Agents (Dialogflow CX) 控制台中，前往「Playbooks」，按一下所建代理程式的應對手冊，然後在應對手冊中新增使用工具的指示。詳情請參閱「Playbook 工具」。

使用現有服務專員建立對話型服務專員工具

如要使用現有代理程式建立對話式代理程式工具，請按照下列步驟操作：

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 點選「建立」。
  系統會在整合編輯器中開啟整合服務。
選取現有的整合服務。系統會在整合編輯器中開啟整合服務。
確認所選整合服務已設定一或多個 API 觸發條件。
發布整合版本。
在設計工具工具列中，按一下 (「動作」選單)，然後選取「建立對話式代理程式工具」。
Application Integration 會驗證必要的 API 是否已啟用。如果未啟用，系統會提示你啟用。
在「Create Conversational Agent Tool」(建立對話型代理工具) 窗格中，提供下列輸入內容：
1. API 觸發條件：系統預設會選取整合服務中的所有 API 觸發條件。您可以視需要取消選取不想納入工具的 API 觸發條件。
2. 類型：選取「選擇現有的對話型代理」，然後執行下列操作：
  1. 對話型代理：畫面會顯示專案中可用的代理程式清單。選取要使用的代理程式。
  2. 工具：選取「建立新工具」或「選擇現有工具」。
    如果選取「建立新工具」，請輸入工具名稱。
    
    如果選取「Choose existing Tool」，系統會顯示所選代理程式的可用工具清單。選取要使用的工具。
3. 服務帳戶：選擇具備必要角色和權限的服務帳戶，以存取代理程式的資源。如果缺少這些角色，系統會提示你授予角色。
按一下「查看規格」，即可查看所選觸發條件的生成規格。儲存前，您可以視需要編輯規格。
按一下「Save」(儲存)。
畫面上會顯示訊息，指出工具已成功建立。按一下「查看」，在 Conversational Agents (Dialogflow CX) 控制台中開啟服務專員。
在 Conversational Agents (Dialogflow CX) 控制台中，前往「Playbooks」，按一下所建代理程式的應對手冊，然後在應對手冊中新增使用工具的指示。詳情請參閱「Playbook 工具」。

注意事項

使用對話式代理程式工具時，請注意下列事項：

對話式代理工具只能為已發布的整合項目建立，且整合項目必須有 API 觸發條件。
建立完成後，請在 Conversational Agents (Dialogflow CX) 控制台中檢查及測試服務專員。