版本和环境

您可以创建多个版本的代理流程和策略方案(也称为 Vertex AI 代理) 并将其部署到单独的投放环境

当您修改流程或 playbook 时 您正在修改草稿。 您可以随时将草稿另存为版本。 版本是流或 playbook 数据的不可变快照 以及相关代理数据对于数据流,这包括 intent、实体、webhook、页面、路由组。对于 playbook,这包括 只是示例。

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

  • 测试
  • 开发
  • 生产
  • 其他相关人员

此外, 您可以创建 特定于环境的 webhook, 以便将生产环境隔离 测试环境

生产环境流量最佳实践

始终对生产流量使用版本

您团队中的开发者每次做出更改时,系统都会更新草稿。 很容易在无意中中断草稿, 尤其是在多人拥有该代理的写入权限的情况下。 此外,最近修改的草稿 可能与经过训练的模型不一致, 因为训练可能会有延迟或需要手动执行。

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

始终使用特定于环境的网络钩子

对代理进行更新时, 网络钩子代码通常都有相互依赖的更新。 在开发和测试这些变更期间,您需要做好以下准备:

  • 根据网络钩子代码更新测试代理更新。
  • 避免将 webhook 代码部署到生产环境 直到您完成测试为止。

使用 特定于环境的 webhook 能够同时实现这两个目标。

考虑更改版本时可能出现的代理错误

如果您更改了生产环境中的版本 当会话处于活跃状态时 则可能会导致某些活跃会话的代理错误。 如果旧版本和新版本 彼此不一致 从而破坏会话状态 因此 您应计划在 Google Cloud 中 或非高峰时段。

将流版本加载到草稿

您可随时 可以将 Flow 版本加载到草稿, 因此,该文件在默认环境中可修改和使用。playbook 尚不支持此功能。

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

管理版本

如需管理您的版本,请按以下步骤操作:

控制台

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

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

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

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择策略方案
  5. 点击版本历史记录
  6. 点击查看版本历史记录
  7. 系统会列出所选 playbook 的版本。

对于每个资源,系统会显示以下信息:

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

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

如需将某个特定流版本加载为草稿流,请执行以下操作:

  1. 将指针悬停在某个版本行上。
  2. 点击选项 按钮。
  3. 点击加载到草稿选项。
  4. 您可以选择在加载时覆盖代理级别数据。

如需删除特定流版本,请执行以下操作:

  1. 将指针悬停在某个版本行上。
  2. 点击选项 按钮。
  3. 点击删除版本选项。

API

请参阅 Version 类型的方法。

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

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

比较流程版本

创建流程版本后 您可以使用版本比较工具 查看流程版本和草稿版本之间的并排比较。此功能不适用于 playbook。 如需比较版本,请执行以下操作:

控制台

  1. 将指针悬停在某个版本行上。
  2. 点击选项 按钮。
  3. 点击比较版本选项。
  4. 选择另一个流版本或者草稿流以进行比较。
  5. 此时会显示并排比较。

API

请参阅 Version 类型的 compareVersions 方法。

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

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

管理环境

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

控制台

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

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

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

如需选择流程和 playbook 版本并配置环境,请按以下步骤操作: 点击环境并提供信息。

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

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

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

API

请参阅 Environment 类型的方法。

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

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

为会话调用指定环境

使用控制台模拟器或 API,您可以在进行运行时会话调用时指定环境。如果未指定环境,则使用默认环境。

控制台

使用控制台模拟器时,选择在环境中测试代理选项,然后选择环境。

API

如需为 detectIntentstreamingDetectIntentmatchIntent 和会话实体 REST 调用指定环境,请在 agentsessions 路径参数之间插入 environments/environment-id,以更改网址。

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

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

为会话调用指定流版本

使用控制台模拟器或 API,您可以在进行运行时会话调用时指定一组流版本。所选流版本不必是 任何环境中引用的对象。

控制台

使用控制台模拟器时,选择具有特定流版本的测试代理选项,然后选择流版本。

API

如需为 detectIntentstreamingDetectIntentmatchIntent 以及会话实体 REST 调用; 在 query_parameters.flow_versions 中提供所选的流程版本 字段。