代理

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

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

创建代理

如需创建代理,请执行以下操作:

控制台

  1. 打开 Dialogflow CX 控制台
  2. 创建或选择 Google Cloud 项目。
  3. 点击创建代理
  4. 选择自动生成以创建数据存储区代理,或选择自行构建以创建其他类型的代理。
  5. 填写基本代理设置表单:
    1. 您可以选择任何显示名。
    2. 选择您的首选位置。如果您想要更改高级位置设置,请点击修改按钮。
    3. 选择您的首选时区。
    4. 选择代理的默认语言。 代理一旦创建便无法更改其默认语言。
  6. 点击保存

API

如果您尚未为项目配置位置设置,则必须先使用控制台配置这些设置,然后才能使用 API 创建代理。目前,您无法使用 API 配置位置信息设置。

如需创建代理,请参阅 Agent 类型的 create 方法。

为代理参考选择协议和版本

协议 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) 代理充当虚拟代理的设置和数据的顶级容器。 以下数据与代理相关联:

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

导出和恢复代理

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

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

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

代理恢复会覆盖所有目标代理数据(包括所有流版本),但以下数据除外:

  • 环境:所有自定义环境在目标代理中保持不变。 目标代理中自定义环境所引用的流版本将继续存在,只要关联的环境存在即可。 不过,这些过时的流程版本不会列为代理的流程版本,也无法选择。
  • 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

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

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

控制台

  1. 打开 Dialogflow CX 控制台
  2. 为代理选择 Google Cloud 项目。
  3. 点击列表中代理的选项 菜单。
  4. 点击导出恢复按钮。
  5. 按照说明完成操作。

API

请参阅 Agent 类型的 exportrestore 方法。

为代理参考选择协议和版本

协议 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 方法。

为代理参考选择协议和版本

协议 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) 代理和数据都会立即删除。