代理

对话式客服 (Dialogflow CX) 代理是负责与最终用户同时对话的虚拟客服。它是一种自然语言理解模块,能够理解人类语言的细微差别。对话式客服 (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) 代理充当虚拟代理的设置和数据的顶级容器。

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

控制台

  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

导出时,您可以选择导出文件格式。如果您对代理数据使用源代码控制版本控制,则应以 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 不可用 不可用

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