版本和环境

您可以创建多个版本的代理流,并将它们部署到不同的服务环境。

当您修改流时,您是在修改“草稿流”。您可以随时将草稿流保存为“流版本”。流版本是流数据以及关联代理数据(如意图、实体、网络钩子、页面、路由组等)的不可变快照。

当您保存草稿流时,它会部署到默认环境。当您创建特定流版本时,您可以将其部署到自定义环境。您可以创建各种自定义环境来进行以下活动:

  • 测试
  • 开发
  • 生产

生产流量

每当团队的开发者进行更改时,草稿流都会更新。很容易无意间中断草稿流(尤其是当多人拥有代理的写入权限时)。此外,最近修改过的草稿流与训练过的模型可能会不一致,这是因为训练可能会有延迟或需要手动执行。

您应始终使用流版本来处理生产流量。在将草稿流提升为正式版之前,应先对其进行测试;如果发现任何问题,您可以回滚到旧版。

将流版本加载到草稿

您可以随时将流版本加载到草稿,以便默认环境进行修改和使用。

将流版本加载到草稿可以更新代理中的多个资源,包括意图和实体等代理级别资源。使用控制台或 API 将版本加载到草稿时,您可以选择是否覆盖代理级别层资源。

管理流版本

要管理流版本,请执行以下操作:

控制台

如需列出流的当前版本,请执行以下操作:

  1. 打开 Dialogflow CX 控制台
  2. 选择 GCP 项目。
  3. 选择您的代理。
  4. 点击管理标签页。
  5. 点击版本
  6. 系统会列出代理流。选择一个。
  7. 系统会列出选定流的版本。

显示每个流的以下信息:

  • 显示名:版本显示名。
  • 版本 ID:版本的 ID。
  • NLU 类型 (NLU Type):流版本的 NLU 类型
  • 创建时间戳:创建版本的日期和时间。
  • 状态:训练状态。只当状态标记为准备就绪后,流版本才可供使用。

如需创建新的流版本,请点击创建按钮并提供版本的显示名说明

如需将某个特定流加载为草稿流,请点击列表中版本右侧附近的加载按钮。您可以选择在加载时覆盖代理级别数据。

如需删除特定流版本,请点击列表中版本右侧附近的删除 按钮。

API

请参阅 Version 类型的方法。

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

协议 V3 V3beta1
REST 版本资源 版本资源
RPC 版本接口 版本接口
C# 不可用 不可用
Go 不可用 不可用
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP 不可用 不可用
Python VersionsClient VersionsClient
Ruby 不可用 不可用

管理环境

要管理您的代理环境,请执行以下操作:

控制台

如需列出代理的当前环境,请执行以下操作:

  1. 打开 Dialogflow CX 控制台
  2. 选择 GCP 项目。
  3. 选择您的代理。
  4. 点击管理标签页。
  5. 点击环境
  6. 系统会列出代理环境。

如需创建新环境,请点击创建按钮并提供信息。

如需选择流版本并配置环境,请点击一个环境并提供信息。

如需查看环境的修改记录,请点击列表中环境右侧附近的历史记录 按钮。

如需复制包含环境 ID 的环境资源名称,请点击列表中环境右侧附近的复制 按钮。

如需删除环境,请点击列表中环境右侧附近的删除 按钮。

API

请参阅 Environment 类型的方法。

为环境参考选择协议和版本

协议 V3 V3beta1
REST 环境资源 环境资源
RPC 环境接口 环境接口
C# 不可用 不可用
Go 不可用 不可用
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP 不可用 不可用
Python EnvironmentsClient EnvironmentsClient
Ruby 不可用 不可用

为运行时会话调用指定环境

您可以为运行时会话调用指定环境,例如 detectIntentstreamingDetectIntentmatchIntent 和会话实体调用。要指定环境,请在 agentsessions 路径参数之间插入 environments/environment-id,以更改端点网址。

例如,以下端点使用 6db409d7-57ac-41d7-83bd-89b8768e2745 环境 ID:

https://dialogflow.googleapis.com/v3beta1/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

如果未指定环境,则使用默认环境。