代理

对话式客服 (Dialogflow CX) 代理是负责与最终用户同时对话的虚拟客服。它是一种自然语言理解模块，能够理解人类语言的细微差别。对话式客服 (Dialogflow CX) 可以在对话过程中将最终用户输入的文字和音频转换为应用和服务可以理解的结构化数据。您可以设计并构建 Conversational Agents (Dialogflow CX) 客服来负责您的系统所需的各种对话。

Conversational Agents (Dialogflow CX) 代理类似于人工呼叫中心代理。二者都需要经过训练，以处理预期的对话场景，并且内容不必过于明确。

创建代理

注意 ：您可以为一个 Google Cloud 项目创建多个对话式客服 (Dialogflow CX) 代理。

如需创建代理，请执行以下操作：

控制台

1. 打开 Dialogflow CX 控制台。
2. 创建或选择 Google Cloud 项目。
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
Ruby	不可用	不可用

关闭

代理数据

Conversational Agents (Dialogflow CX) 代理充当虚拟代理的设置和数据的顶级容器。

如需访问代理的数据，请执行以下操作：

控制台

1. 打开 Dialogflow CX 控制台。
2. 为代理选择 Google Cloud 项目。
3. 在列表中找到代理。
4. 点击代理显示名。
5. 按照其他指南中的说明更新流程、页面等。

API

请参阅要更新数据的指南。

以下数据与代理相关联：

• 意图
• 实体类型
• 网络钩子
• 流
• 页面
• 路由组

如需详细了解如何在不同级别应用数据，请参阅数据应用级别。

导出和恢复代理

您可以将代理导出到文件，然后使用该文件恢复代理。

代理导出内容包含所有代理数据，但以下数据除外：

• 流版本：仅草稿流会导出到文件。
• 环境：自定义环境不会导出到文件。

代理恢复会覆盖所有目标代理数据（包括所有流版本），但以下数据除外：

• 环境：所有自定义环境在目标代理中保持不变。只要关联的环境存在，目标代理中自定义环境引用的流版本将继续存在。不过，这些过时的数据流版本不会列出，也不会作为代理可选的数据流版本。
• Vertex AI Agents 应用：与 Vertex AI Agents 应用的关联在目标代理中保持不变。（换句话说，就是 GenAppBuilderSettings 中的 engine 的值）。这意味着，数据存储区代理只能恢复到其他现有的数据存储区代理，因为生成的代理还需要与 Vertex AI Agents 应用相关联。

• Vertex 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 智能体应用称为 GenAppBuilder 引擎。例如，在导出的 JSON 软件包中，您可以在 agent.json 文件的 genAppBuilderSettings.engine 键下找到引擎的名称。

导出时，您可以选择导出文件格式。如果您对代理数据使用源代码控制版本控制，则应以 JSON 格式导出。当您恢复代理时，Conversational Agents (Dialogflow CX) 会自动确定文件格式。

如需导出或恢复代理，请执行以下操作：

控制台

1. 打开 Dialogflow CX 控制台。
2. 为代理选择 Google Cloud 项目。
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
Ruby	不可用	不可用

关闭

如果代理大小超过上限，请使用 Cloud Storage 选项来导出和恢复代理。

如果您使用的是 GitHub，请参阅 GitHub 导出/恢复指南。

删除代理

警告：删除代理的操作无法撤消。必要时请导出代理以保留备份。

如需删除代理，您需要一个提供完整访问权限或修改权限的角色。如需了解详情，请参阅访问权限控制指南。

要删除代理，请按以下步骤操作：

控制台

1. 打开 Dialogflow CX 控制台。
2. 为代理选择 Google Cloud 项目。
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
Ruby	不可用	不可用

关闭

如果您删除项目，系统会立即删除与项目关联的所有对话式 AI 助理 (Dialogflow CX) 代理和数据。