使用 Application Integration 构建对话式智能体

Application Integration 现在可直接与 Conversational Agents (Dialogflow CX) 集成，从而简化对话体验的创建。借助此功能，您可以直接从集成工作流中使用 API 触发器构建智能聊天机器人和工具，以增强用户互动并自动执行任务。

什么是对话式代理？

对话代理 (Dialogflow CX) 对话代理是一种虚拟客服，可使用自然语言与用户进行对话。它会分析用户输入、解读意图并提供适当的回答，从而实现互动式个性化对话体验。这些代理旨在处理各种渠道（例如网站、移动应用和消息服务平台）中的对话。

什么是对话式代理工具？

在 Conversational Agents (Dialogflow CX) 中，工具表示对话型代理可以访问的特定功能或服务。工具在 playbook 中定义，可让智能体执行检索数据、执行 API 或与外部系统互动等操作。Application Integration 会根据集成的 API 触发器生成这些工具，从而轻松将集成逻辑与对话流程相关联。

准备工作

在使用 Application Integration 创建对话式代理工具之前，请确保满足以下条件：

将以下 IAM 角色分配给您的主账号：
- Service Account Admin (roles/iam.serviceAccountAdmin)
- Service Usage Admin (roles/serviceusage.serviceUsageAdmin)
- Dialogflow Console Agent Editor (roles/dialogflow.consoleAgentEditor)
如需了解如何向主账号授予角色，请参阅授予或撤消单个角色。

服务账号所需的 IAM 角色

用于创建对话式代理工具的服务账号需要以下 IAM 角色：

服务账号	说明	所需的角色
服务账号	用于创建对话式代理工具的服务账号。	Application Integration Invoker (`roles/integrations.integrationInvoker`)
Dialogflow 服务代理（`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`）	Conversational Agents (Dialogflow CX) 用于访问集成的服务账号。	Service Account Token Creator (`roles/iam.serviceAccountTokenCreator`)

创建新的对话式智能体工具

如需使用 Application Integration 创建新的对话式代理工具，请执行以下步骤：

在 Google Cloud 控制台中，进入 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击集成。
系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。
选择现有集成，或点击创建集成以创建新的集成。
如果您要创建新的集成，请执行以下操作：
1. 在创建集成窗格中输入名称和说明。
2. 选择集成的区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 为集成选择服务账号。您可以随时在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
  注意：只有在您为所选区域启用了集成治理后，才会显示用于选择服务账号的选项。
4. 点击创建。
  这将在集成编辑器中打开集成。
选择现有集成。这将在集成编辑器中打开集成。
确保所选集成配置了一个或多个 API 触发器。
发布集成版本。
在设计器工具栏中，点击（操作菜单），然后选择创建对话式代理工具。
Application Integration 会验证所需的 API 是否已启用。如果未启用，系统会提示您启用。
在创建对话代理工具窗格中，提供以下输入内容：
1. API 触发器：默认情况下，系统会选择集成中的所有 API 触发器。您可以选择性地取消选择不想纳入该工具中的任何 API 触发器。
2. 类型：选择创建新的对话智能体，然后输入以下详细信息：
  1. 区域：为代理选择区域。
  2. 代理名称：输入代理的名称。
  3. 工具名称：输入工具的名称。
3. 服务账号：选择具有必要的角色和权限的服务账号，以便代理访问资源。如果缺少，系统会提示您授予这些权限。
点击查看规范，查看为所选触发器生成的规范。您也可以选择在保存之前修改规范。
点击保存。
系统会显示一条消息，表明已成功创建工具。点击查看，在 Conversational Agents (Dialogflow CX) 控制台中打开代理。
在 Conversational Agents (Dialogflow CX) 控制台中，前往 Playbook，点击已创建代理的 playbook，然后向该 playbook 添加使用工具的指令。如需了解详情，请参阅 Playbook 工具。

使用现有代理创建对话代理工具

如需使用现有代理创建对话式代理工具，请执行以下步骤：

在 Google Cloud 控制台中，进入 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击集成。
系统会显示集成页面，其中列出了 Google Cloud 项目中的所有可用集成。
选择现有集成，或点击创建集成以创建新的集成。
要创建新的集成，请执行以下操作：
1. 在创建集成窗格中输入名称和说明。
2. 选择集成的区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 为集成选择服务账号。您可以随时在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
  注意：只有在您为所选区域启用了集成治理后，才会显示用于选择服务账号的选项。
4. 点击创建。
  这将在集成编辑器中打开集成。
选择现有集成。这将在集成编辑器中打开集成。
确保所选集成配置了一个或多个 API 触发器。
发布集成版本。
在设计器工具栏中，点击（操作菜单），然后选择创建对话式代理工具。
Application Integration 会验证所需的 API 是否已启用。如果未启用，系统会提示您启用。
在创建对话代理工具窗格中，提供以下输入内容：
1. API 触发器：默认情况下，系统会选择集成中的所有 API 触发器。您可以选择性地取消选择不想纳入该工具中的任何 API 触发器。
2. 类型：选择选择现有对话代理，然后执行以下操作：
  1. 对话代理：系统会显示项目中的可用代理列表。选择要使用的代理。
  2. 工具：选择创建新工具或选择现有工具。
    如果您选择创建新工具，请输入工具的名称。
    
    如果您选择 Choose existing Tool，系统会显示所选代理中的可用工具列表。选择要使用的工具。
3. 服务账号：选择具有必要的角色和权限的服务账号，以便代理访问资源。如果缺少这些角色，系统会提示您授予这些角色。
点击查看规范，查看为所选触发器生成的规范。您也可以选择在保存之前修改规范。
点击保存。
系统会显示一条消息，表明已成功创建工具。点击查看，在 Conversational Agents (Dialogflow CX) 控制台中打开代理。
在 Conversational Agents (Dialogflow CX) 控制台中，前往 Playbook，点击已创建代理的 playbook，然后向该 playbook 添加使用工具的指令。如需了解详情，请参阅 Playbook 工具。

注意事项

使用对话式代理工具时，需要注意以下事项：

对话式代理工具只能为具有 API 触发器的已发布集成创建。
创建完成后，在 Conversational Agents (Dialogflow CX) 控制台中查看并测试您的客服。