您可以创建多个版本的代理流和剧本（也称为 Vertex AI 代理），并将它们部署到不同的服务环境。
当您修改流程或剧本时，您是在修改草稿。您可以随时将草稿保存为版本。版本是流程或 Playbook 数据以及关联代理数据的不可变快照。对于流程，这包括意图、实体、网络钩子、页面、路由组。对于 Playbook，这仅包括示例。
保存草稿后，系统会将其部署到默认环境。创建特定版本时，您可以将其部署到自定义环境。您可以创建各种自定义环境，例如：
- 测试
- 开发
- 生产
此外，您还可以创建特定于环境的 webhook，以便将生产环境与开发环境和测试环境隔离开来。
生产环境流量最佳实践
始终针对生产流量使用版本
每当团队的开发者进行更改时，草稿都会更新。很容易无意间中断草稿（尤其是当多人拥有代理的写入权限时）。此外，最近修改过的草稿与训练过的模型可能会不一致，这是因为训练可能会有延迟或需要手动执行。
您应始终使用版本来处理生产流量。在将草稿资源提升为正式版之前，应先对其进行测试；如果发现任何问题，您可以回滚到旧版。
始终使用特定于环境的 webhook
更新代理时，您通常需要对网络钩子代码进行相互依赖的更新。在开发和测试这些更改期间，您需要做到以下几点：
- 针对 webhook 代码更新测试代理更新。
- 请勿在完成测试之前将您的 webhook 代码部署到生产环境。
使用特定于环境的 webhook 即可实现这两项目标。
考虑更改版本时可能出现的代理错误
如果您在会话处于活跃状态时更改生产环境中的版本，可能会导致某些活跃会话出现代理错误。如果旧版和新版之间存在会破坏会话状态的不一致之处，就可能会发生这些错误。因此，您应计划在非高峰时间或休息时间更改版本。
将版本加载到草稿
您可以随时将版本加载到草稿，以便默认环境进行修改和使用。
将流版本加载到草稿可以更新代理中的多个资源，包括意图和实体等代理级别资源。使用控制台或 API 将版本加载到草稿时，您可以选择是否覆盖代理级别层资源。
同样，将某个 Playbook 版本恢复为草稿后，系统会覆盖草稿中的现有 Playbook 及其示例。
管理版本
如需管理版本，请执行以下操作：
控制台
如需列出流的当前版本，请执行以下操作：
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击共享资源标签页。
- 点击版本。
- 系统会列出代理流。选择一个。
- 系统会列出选定流的版本。
如需列出 Playbook 的当前版本，请执行以下操作：
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择 Playbook
- 点击版本历史记录。
- 点击查看版本历史记录。
- 系统会列出所选 Playbook 的版本。
系统会显示每个资源的以下信息：
- 显示名：版本显示名。
- 版本 ID：版本的 ID。
- NLU 类型 (NLU Type)：流版本的 NLU 类型。
- 创建时间戳：创建版本的日期和时间。
- 状态：训练状态。只当状态标记为准备就绪后，流版本才可供使用。
如需创建新版本，请点击创建按钮，然后为该版本提供显示名称和说明。
如需将某个特定流版本加载为草稿流，请执行以下操作：
- 将指针悬停在某个版本行上。
- 点击选项 more_vert 按钮。
- 点击加载到草稿选项。
- 您可以选择在加载时覆盖代理级别数据。
如需删除特定流版本，请执行以下操作：
- 将指针悬停在某个版本行上。
- 点击选项 more_vert 按钮。
- 点击删除版本选项。
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。如需比较版本，请执行以下操作：
控制台
- 将指针悬停在某个版本行上。
- 点击选项 more_vert 按钮。
- 点击比较版本选项。
- 选择另一个流版本或者草稿流以进行比较。
- 此时会显示并排比较。
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 | 不可用 | 不可用 |
管理环境
要管理您的代理环境，请执行以下操作：
控制台
如需列出代理的当前环境，请执行以下操作：
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击共享资源标签页。
- 点击环境。
- 系统会列出代理环境。
如需创建新环境，请点击创建按钮并提供信息。
如需选择流和 Playbook 版本并配置环境，请点击一个环境并提供信息。
如需查看环境的修改记录，请点击列表中环境右侧附近的历史记录 history 按钮。
如需复制包含环境 ID 的环境资源名称，请点击列表中环境右侧附近的复制 content_copy 按钮。
如需删除环境，请点击列表中环境右侧附近的删除 delete 按钮。
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
如需为 detectIntent、streamingDetectIntent、matchIntent 和会话实体 REST 调用指定环境，请在 agent 和 sessions 路径参数之间插入 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
如需为 detectIntent、streamingDetectIntent、matchIntent 和会话实体 REST 调用指定流版本，请在请求的 query_parameters.flow_versions 字段中提供所选的流版本。