代理

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

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

创建代理

注意： 您可以为一个 Google Cloud 项目创建多个 Dialogflow CX 代理。

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

控制台

1. 打开 Dialogflow CX 控制台。
2. 创建或选择一个项目。
3. 点击 Create agent。
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	不可用	不可用

关闭

代理数据

Dialogflow CX 代理充当虚拟代理的设置和数据的顶级容器。以下数据与代理相关联：

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

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

智能断点

如果为代理启用了智能端点检测，您可以按如下方式自定义数值型参数的智能端点检测行为：

1. 将最少位数设置为提示智能端点检测器等待，直到收集到所有数字。
2. 设置修正转写内容，通过修正常见的数字转写错误来提高数字语音识别准确率。仅当请求指定 en 或 en-* 语言代码时，才支持此功能。
3. 设置等待超时时间以指定额外的时间。Dialogflow CX 将等待用户提供其他输入。

Speech-to-Text (STT) 是一种 API，可使用机器学习技术将音频转换为文本，让您将语音识别功能集成到应用中。

支持的 STT 模型包括任何长篇模型（例如 phone_call）。仅支持 en-US 语言。

注意： 如果使用短模型，此参数会启用云语音端点检测。

Dialogflow CX 超时是指在触发语音超时之前，允许用户向 STT 转写内容添加内容的宽限期。触发语音超时后，Dialogflow CX 会开始意图实现（例如，自然反馈、虚拟代理响应、Webhook 执行 + VA 响应）。

Dialogflow CX 会使用启发式方法根据转写内容指定需要选择的超时时间。例如，如果意图匹配成功，它可以选择非常短的超时时间。如果未匹配到意图，可以增加超时时间，以便用户说出其他内容，然后重试意图匹配。

项目现在可以利用以下 STT 增强功能：

• 更快的断点检测：实时分析使用音频转写流式传输来区分自然停顿和话语结束，同时保持 STT 流处于打开状态。如果用户已说完话，Dialogflow CX 会提前终止流，以便更快地提供响应。
• 优化的数字收集：Dialogflow CX 会对最终的 STT 转写内容使用启发式方法，以验证是否捕获了所有预期数字。它还会自动更正常见的转写错误（例如，将“to”/“too”解析为“2”，将“for”解析为“4”，或将“ate”/“weight”解析为“8”）。
• 自然对话反馈：如果用户在说话时停顿，Dialogflow CX 可以动态延长 STT 超时时间，以防止过早中断，或注入自然的后向通道提示（例如“嗯嗯”“啊哈”），以确认虚拟客服仍在聆听。

导出和恢复代理

警告： 自 2025 年 8 月 15 日起，我们将不再为 OpenAPI 工具和 Webhook 导出原始值凭证。您应迁移为在 Secret Manager 中存储凭据。如需查看相关说明，请参阅 Webhook 和工具文档。

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

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

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

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

• 环境：所有自定义环境在目标代理中保持不变。 目标代理中自定义环境所引用的流版本将继续存在，只要关联的环境存在即可。 不过，这些过时的流版本不会列为代理的可用流版本，也无法选择。
• Vertex AI Agents 应用：目标智能体（即 GenAppBuilderSettings 中的 engine 值）与 Vertex AI Agents 应用的关联保持不变。 这意味着，数据存储区代理只能恢复到其他现有的数据存储区代理中，因为恢复后的代理也需要与 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 Agents 应用称为 GenAppBuilder Engine。例如，在导出的 JSON 软件包中，您可以在 agent.json 文件中的 genAppBuilderSettings.engine 键下找到引擎的名称。

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

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

控制台

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

关闭

如果您删除项目，则与该项目关联的所有 Dialogflow CX 代理和数据都会立即删除。