您可以创建多个版本的代理流程和策略方案(也称为 Vertex AI 代理) 并将其部署到单独的投放环境
当您修改流程或 playbook 时 您正在修改草稿。 您可以随时将草稿另存为版本。 版本是流或 playbook 数据的不可变快照 以及相关代理数据对于数据流,这包括 intent、实体、webhook、页面、路由组。对于 playbook,这包括 只是示例。
保存草稿时 它会部署到默认环境。 在创建特定版本时 则可以将其部署到自定义环境。 您可以创建各种自定义环境来进行以下活动:
- 测试
- 开发
- 生产
- 其他相关人员
此外, 您可以创建 特定于环境的 webhook, 以便将生产环境隔离 测试环境
生产环境流量最佳实践
始终对生产流量使用版本
您团队中的开发者每次做出更改时,系统都会更新草稿。 很容易在无意中中断草稿, 尤其是在多人拥有该代理的写入权限的情况下。 此外,最近修改的草稿 可能与经过训练的模型不一致, 因为训练可能会有延迟或需要手动执行。
您应始终为生产流量使用版本。 在将草稿资源升级到正式版之前,应先对其进行测试, 如果发现任何问题,您可以回滚到先前的版本。
始终使用特定于环境的网络钩子
对代理进行更新时, 网络钩子代码通常都有相互依赖的更新。 在开发和测试这些变更期间,您需要做好以下准备:
- 根据网络钩子代码更新测试代理更新。
- 避免将 webhook 代码部署到生产环境 直到您完成测试为止。
使用 特定于环境的 webhook 能够同时实现这两个目标。
考虑更改版本时可能出现的代理错误
如果您更改了生产环境中的版本 当会话处于活跃状态时 则可能会导致某些活跃会话的代理错误。 如果旧版本和新版本 彼此不一致 从而破坏会话状态 因此 您应计划在 Google Cloud 中 或非高峰时段。
将流版本加载到草稿
您可随时 可以将 Flow 版本加载到草稿, 因此,该文件在默认环境中可修改和使用。playbook 尚不支持此功能。
将流版本加载到草稿可以更新代理中的多个资源,包括意图和实体等代理级别资源。使用控制台或 API 将版本加载到草稿时,您可以选择是否覆盖代理级别层资源。
管理版本
如需管理您的版本,请按以下步骤操作:
控制台
如需列出流的当前版本,请执行以下操作:
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击管理标签页。
- 点击版本。
- 系统会列出代理流。选择一个。
- 系统会列出选定流的版本。
如需列出 playbook 的当前版本,请执行以下操作:
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择策略方案
- 点击版本历史记录。
- 点击查看版本历史记录。
- 系统会列出所选 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
中提供所选的流程版本
字段。