代理

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 智能体是虚拟代理设置和数据的顶级容器。以下数据与代理相关联：

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

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

智能端点检测

Speech-to-Text (STT) 是一种 API，可使用机器学习技术将音频转换为文本，让您能够将语音识别功能集成到应用中。支持的 STT 模型包括任何长格式模型（例如 phone_call）。仅支持 en-US 语言。

注意 ：如果使用短模型，则会启用云语音端点。

如果为代理启用了智能端点，您可以通过设置等待超时来指定额外时间，从而为数字参数自定义智能端点行为。然后，Dialogflow CX 将等待用户提供其他输入。

等待超时是一段宽限期，可让您在触发语音超时之前向 STT 转录内容添加内容。Dialogflow CX 使用启发法来指定需要根据转写内容选择的超时。例如，如果意图匹配成功，它可以选择非常短的超时。如果 intent 不匹配，它可以增加超时时间，以便您说出其他内容，并重试 intent 匹配。

其他 STT 功能包括：

• 更快的端点检测：实时分析使用音频转写流式传输，在 STT 流保持打开状态时，区分自然停顿和话语结束。如果用户已说完，Dialogflow CX 会提前终止数据流，以便更快地提供回答。
• 自然对话反馈：如果用户在说话过程中停顿，Dialogflow CX 可以动态延长 STT 超时时间，以防止过早中断，或插入自然的反馈提示（例如“嗯嗯”“啊哈”），以确认虚拟客服仍在倾听。

导出和恢复代理

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

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

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

• 流版本：只有所选环境中使用的流版本才会导出到文件。
• 环境：所选环境以外的环境不会导出到文件。

智能体恢复操作会覆盖所有目标智能体数据（包括所有 flow 版本），但以下数据除外：

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

• Vertex AI Agents 数据存储区：目标 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 引擎。例如，在导出的 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 智能体和数据都会立即删除。