您可以创建多个版本的代理流,并将它们部署到不同的服务环境。
当您修改流时,您是在修改“草稿流”。您可以随时将草稿流保存为“流版本”。流版本是流数据以及关联代理数据(如意图、实体、网络钩子、页面、路由组等)的不可变快照。
当您保存草稿流时,它会部署到默认环境。当您创建特定流版本时,您可以将其部署到自定义环境。您可以创建各种自定义环境来进行以下活动:
- 测试
- 开发
- 生产
- 等
生产流量
每当团队的开发者进行更改时,草稿流都会更新。很容易无意间中断草稿流(尤其是当多人拥有代理的写入权限时)。此外,最近修改过的草稿流与训练过的模型可能会不一致,这是因为训练可能会有延迟或需要手动执行。
您应始终使用流版本来处理生产流量。在将草稿流提升为正式版之前,应先对其进行测试;如果发现任何问题,您可以回滚到旧版。
将流版本加载到草稿
您可以随时将流版本加载到草稿,以便默认环境进行修改和使用。
将流版本加载到草稿可以更新代理中的多个资源,包括意图和实体等代理级别资源。使用控制台或 API 将版本加载到草稿时,您可以选择是否覆盖代理级别层资源。
管理流版本
要管理流版本,请执行以下操作:
控制台
如需列出流的当前版本,请执行以下操作:
- 打开 Dialogflow CX 控制台。
- 选择 GCP 项目。
- 选择您的代理。
- 点击代理设置。
- 点击版本标签页。
- 系统会列出代理流。选择一个。
- 系统会列出选定流的版本。
显示每个流的以下信息:
- 版本:版本名称。
- NLU 类型 (NLU Type):流版本的 NLU 类型。
- Version Created:版本创建的日期和时间。
- 状态:训练状态。只当状态标记为准备就绪后,流版本才可供使用。
要创建新的流版本,请点击添加版本按钮并提供信息。
如需将某个特定流加载为草稿流,请点击列表中版本右侧附近的加载按钮。您可以选择在加载时覆盖代理级别数据。
如需删除特定流版本,请点击列表中版本右侧附近的删除 delete 按钮。
API
请参阅 Version
类型的方法。
为版本参考选择协议和版本:
协议 | V3 | V3beta1 |
---|---|---|
REST | 版本资源 | 版本资源 |
RPC | 版本接口 | 版本接口 |
C# | 不可用 | 不可用 |
Go | 不可用 | 不可用 |
Java | VersionsClient | VersionsClient |
Node.js | VersionsClient | VersionsClient |
PHP | 不可用 | 不可用 |
Python | VersionsClient | VersionsClient |
Ruby | 不可用 | 不可用 |
管理环境
要管理您的代理环境,请执行以下操作:
控制台
如需列出代理的当前环境,请执行以下操作:
- 打开 Dialogflow CX 控制台。
- 选择 GCP 项目。
- 选择您的代理。
- 点击代理设置。
- 点击环境标签页。
- 系统会列出代理环境。
如需创建新环境,请点击 Add Environment 按钮并提供信息。
如需选择流版本并配置环境,请点击一个环境并提供信息。
如需查看环境的修改记录,请点击列表中环境右侧附近的历史记录 history 按钮。
如需复制包含环境 ID 的环境资源名称,请点击列表中环境右侧附近的复制 content_copy 按钮。
如需删除环境,请点击列表中环境右侧附近的删除 delete 按钮。
API
请参阅 Environment
类型的方法。
为环境参考选择协议和版本:
协议 | V3 | V3beta1 |
---|---|---|
REST | 环境资源 | 环境资源 |
RPC | 环境接口 | 环境接口 |
C# | 不可用 | 不可用 |
Go | 不可用 | 不可用 |
Java | EnvironmentsClient | EnvironmentsClient |
Node.js | EnvironmentsClient | EnvironmentsClient |
PHP | 不可用 | 不可用 |
Python | EnvironmentsClient | EnvironmentsClient |
Ruby | 不可用 | 不可用 |
为运行时会话调用指定环境
您可以为运行时会话调用指定环境,例如 detectIntent
、streamingDetectIntent
、matchIntent
和会话实体调用。要指定环境,请在 agent
和 sessions
路径参数之间插入 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
如果未指定环境,则使用默认环境。