運用 Application Integration 建構對話型代理

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

什麼是對話式代理程式？

Conversational Agents (Dialogflow CX) 對話型服務專員是一種虛擬服務專員，可透過自然語言對話與使用者溝通。它會分析使用者輸入內容、解讀意圖，並提供適當回應，提供互動式和個人化的對話體驗。這些服務機器人可處理網站、行動應用程式和通訊平台等不同管道的對話。

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

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

事前準備

使用應用程式整合功能建立對話方工具前，請確認下列事項：

將下列 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`)

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

如要使用應用程式整合功能建立新的對話式服務工具，請執行下列步驟：

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

使用現有代理程式建立對話型代理工具

如要使用現有服務專員建立對話式服務專員工具，請執行下列步驟：

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「應用程式整合」
在導覽選單中，按一下「整合」。
系統隨即會顯示「Integrations」頁面，列出 Google Cloud 專案中可用的所有整合項目。
選取現有的整合，或按一下「建立整合」來建立新的整合。
如果您要建立新的整合功能：
1. 在「Create Integration」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「Regions」下拉式選單只會列出 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，然後在 Playbook 中加入使用工具的操作說明。詳情請參閱「Playbook 工具」。

注意事項

使用對話方言工具時，請注意下列事項：

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