IBM Cloud Docs
概述: 预览和发布

概述: 预览和发布

构建助手后,可以进行测试以确保其按预期工作,然后将其提供给客户。IBM® watsonx™ Assistant 使您能够直接在已关闭的环境中预览助手,并精确管理可供客户使用的内容。

助手由三个核心元素组成:

  • 内容: 用于响应客户的对话逻辑和词。 每个助手都需要内容。
  • 渠道: 助手与客户交互的位置,例如 Web 站点上的 Web 聊天界面。 每个助手至少需要一个通道。
  • 扩展: 帮助解决特定客户问题 (例如,搜索现有帮助内容) 的最终体验附加组件。

通常,您在助手的整个生命周期内都遵循此高级流程:

  1. 构建初始内容。
  2. 在草稿环境中测试内容,并获得团队成员的核准。
  3. 发布不同版本的草稿内容。
  4. 在客户与助手进行交互的实时环境中设置通道。
  5. 将已发布的版本分配给实时环境以供客户使用。
  6. 使用分析来改进助手并根据需要重新发布内容。

环境

您可以在称为 _环境_的单独容器中对工作进行分组。 每个环境都包含自己的内容,通道和扩展。 环境还具有自己的标识,URL 和可由外部服务引用的服务凭证。

每个新助手都随附两个环境: 草稿环境和实时环境。 在“环境”页面上,可以从 草稿环境 选项卡管理草稿环境,也可以从 活动环境 选项卡管理活动环境。 您的客户在实时环境中与助手进行交互,而无法在草稿环境中与助手进行交互。 您可以独立于客户所看到的内容来构建和迭代内容。 您不希望客户偶然发现不完整的操作导致他们走向死胡同。

对于企业套餐,您最多可以添加三个环境作为登台区域,以在部署之前测试助手。 您可以在草稿环境中构建内容,并在额外环境中构建内容的测试版本。 有关更多信息,请参阅 添加和使用多个环境

草稿环境

草稿环境在“操作”,“预览”和“发布”页面中包含所有正在进行的工作。 使用 草稿环境 选项卡来管理草稿环境,包括在部署之前添加可用于内部测试的草稿环境集成 (通道和扩展)。 这些集成对于草稿环境是唯一的,对草稿集成的更改不会影响实时环境。

草稿环境
草稿环境

您可以单击 预览此环境 以打开另一个浏览器选项卡,并将草稿环境视为样本 Web 交谈。

有关在草稿环境中预览助手的更多信息,请参阅 预览和共享助手

发布

当您准备好创建内容和设置的快照时,可以从“发布”页面进行发布。 每次发布时,都会创建新版本,例如 V1 或 V2。

发布
"发布" 页面

发布内容时,watsonx Assistant 会创建草稿内容的快照,从而生成版本。 此版本包含来自操作的所有内容,包括设置和变量。 版本不包含集成配置或环境设置。 必须在每个环境中手动配置集成配置和环境设置。

三个最新发布的版本将显示在“发布”页面本身的列表中。 如果有三个以上的版本,那么可以单击 查看全部 以查看所有已发布版本的列表。

所有版本
所有版本

可维护的版本数取决于您拥有的计划类型。 如果达到可以拥有的版本的计划限制,那么需要先删除一个版本,然后才能发布另一个版本。

服务套餐已发布版本
服务套餐 已发布的版本
企业 50
高级 (旧版) 50
Plus 10
试用 10
Lite 2

现场环境

使用 实时环境 选项卡来管理实时环境。 此选项卡指示在助手中活动的内容以及内容所连接到的渠道。 选项卡左侧显示在其中部署内容的通道,或者客户可以与助手进行交互的通道。 选项卡右侧显示解决方法,或者助手如何响应客户问题或请求。

实时环境
实时环境

解析方法 显示发布到实时环境的内容版本。

有两种方法可将版本发布到实时环境:

  • 从草稿环境发布版本时
  • 使用 实时环境 选项卡,然后单击 发布版本

将版本发布到实时环境后,可以通过两种方法切换到不同的版本:

  • 从草稿环境发布版本时,您可以选择将其分配给实时环境,以替换已存在的版本
  • 使用 活动环境 选项卡,然后单击 切换版本

有关发布的更多信息,请参阅 发布内容

环境设置

每个环境都有自己的设置。 单击 设置 齿轮图标 齿轮图标 以打开设置。

如果您正在使用经典体验,那么这些设置位于助手的 助手设置 中。

API 详细信息

API 详细信息为每个环境提供以下值:

  • 环境名称
  • 环境标识
  • 会话 URL
  • 指向 IBM Cloud 控制台的链接,用于查看实例的服务凭证

Webhook

预消息,后消息和日志 Webhook 的设置。 有关更多信息,请参阅 使用 Webhook 扩展助手

不活动状态超时

指定在客户停止与助手交互后,在结束会话之前要等待的时间量。

当客户通过其中一个内置集成或通过使用有状态 message API 的定制客户机连接到助手时,会话将在指定的超时时间间隔后结束。

会话结束时,助手会丢失在与客户对话期间保存的任何上下文信息。 例如,如果助手询问客户的名称,然后在整个对话的其余部分按该名称调用客户,那么在会话结束并开始新的会话后,助手将从再次询问客户的名称开始。

最大不活动超时因服务实例套餐类型而异。 下表列出了限制。

服务套餐详细信息
服务套餐 聊天会话缺省不活动时间段 聊天会话最长不活动时间段
企业 1 小时 168 小时(7 天)
高级 (旧版) 1 小时 168 小时(7 天)
Plus 1 小时 24 小时
试用 5 分钟 5 分钟
Lite 5 分钟 5 分钟

会话历史记录

对于每个环境,您可以记录来自每个客户的对话的最新消息,以便与 session_history 变量 配合使用。 将针对操作和对话记录消息。

会话历史记录可用于:

  • 在传输期间向实时代理提供对话摘要
  • 使用搜索扩展通过使用对话摘要而不是最近的话语来查找答案
  • 调用生成 AI 扩展以根据摘要生成答案

最近的消息会话历史记录包括:

  • 最后 24 条消息
  • 每条消息 512 个字符
  • 总计 2048 个字符

session_history 的内容使用此语法,例如: [{u : 'book a flight', n : true}, {a : 'sure! from where?'}]

语法
语法 描述
u 客户 (用户) 的问题或回复
n 指示客户问题触发了新的基本操作,该操作不是子操作或离题操作。
a 助手的问题或回复

您还可以编写表达式以变换变量的输出。 有关更多信息,请参阅 Array.transform