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

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

什么是对话式客服人员？

Conversational Agents (Dialogflow CX) 对话代理是一种虚拟客服，可与用户进行自然语言对话。它可以分析用户输入、解读意图并提供适当的回答，从而实现互动式和个性化的对话式体验。这些客服人员专门负责处理各种渠道（例如网站、移动应用和即时通讯平台）上的对话。

什么是对话式客服工具？

在 Conversational Agents (Dialogflow CX) 中，工具表示对话式 AI 客服可以访问的特定功能或服务。工具在 Playbook 中定义，可让代理执行检索数据、执行 API 或与外部系统交互等操作。应用集成会根据集成的 API 触发器生成这些工具，以便您轻松将集成逻辑与对话流程相关联。

准备工作

在使用应用集成创建对话式 AI 工具之前，请确保满足以下条件：

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

服务账号所需的 IAM 角色

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

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

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

如需使用应用集成创建新的对话式客服工具，请执行以下步骤：

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

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

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

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

注意事项

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

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