Web 聊天发行说明

了解 Web 聊天集成中的新增内容。

网络聊天更新日志按版本号排列更改。有关 Web 聊天的更多信息，请参阅将 Web 聊天与 Web 站点集成。

有关核心 watsonx Assistant 产品的新功能和改进的信息，请参阅发行说明。

控制 Web 聊天版本

如果您想在部署之前评估网络聊天版本中引入的更改，可以设置网络聊天的版本。更多信息，请参阅控制网络聊天版本。

8.7.1

发布日期：2025 年 3 月 20 日

修正了用户点击日期选择器时，日期选择器会关闭的错误。
修正了使用 pre:receive 事件将上下文属性从单值更改为数组时出现的错误。
修正了消除歧义回复的可访问性错误。
更新了使用 IBM AI 主题聊天时使用的启动器图标。
修正了 ZenDesk 代理应用程序压缩文件的一个错误，该错误会导致代理应用程序无法在 ZenDesk 中加载。

8.7.0

发布日期：2025年2月17日

错误修订。

8.6.0

发布日期：2025年2月3日

停止流式传输：网络聊天中新增了“停止响应”按钮，用于停止流式传输的响应，并可取消。
- 当用户点击“停止响应”按钮时，会触发一个 stopStreaming 事件，您可以将其挂钩。
错误修订。

8.5.3

发布日期：2025年1月21日

对话式搜索的变化： 对对话式搜索响应进行了一些 UI 更改。这包括删除“生成的答案的准确性可能有所不同”的免责声明。
错误修订。

8.5.2

发布日期：2025年1月6日

错误修订。

8.5.1

发布日期：2024 年 12 月 5 日

增强了表格响应类型，允许用户更改每页可见的行数。
修正了导致在 Chrome 浏览器以外的浏览器中无法看到打字指示器的错误。

7.11.0

发布日期：2024 年 11 月 21 日

Added an asyncCallout option to the instance.send method that can be used to ensure a call to an extension is done using a one step process instead of the default two step process.

8.5.0

发布日期：2024 年 11 月 18 日

修复了一个小的可访问性问题。

8.4.0

发布日期：2024 年 10 月 21 日

表格回复类型： 网络聊天中现已提供对新表格响应类型的测试版支持。有关更多信息，请参阅响应类型参考。
修复了单卡旋转木马的样式问题。
修正了一个错误，该错误有时会导致用户点击链接时显示错误信息。

8.3.3

发布日期：2024 年 10 月 14 日

无障碍修复： 为网络聊天添加了一些元素，以便在使用屏幕阅读器时更轻松地使用下一个和上一个标题键浏览聊天内容。
修复了自定义菜单的焦点问题。用户从菜单中选择一个项目后，菜单将保持聚焦。
在等待扩展完成的过程中，扩展功能不再会导致输入字段禁用。

8.3.2

发布日期：2024 年 9 月 23 日

修复了一个会破坏旅程功能的错误。

8.3.1

发布日期：2024 年 9 月 13 日

错误修订。

8.3.0

发布日期：2024 年 9 月 9 日

对话式搜索中的富文本支持： 对话式搜索回复现在支持回复中的富文本格式，包括 Markdown。
对话式搜索来源的更改： 默认情况下，对话式搜索响应中不再突出显示来源。要查看亮点，必须展开信息源旋转木马并选择信息源。
添加了区域 aws-eu-central-1。
修正了 NiceDFO 服务台集成中的一个错误，该错误导致自定义字段在某些情况下不可用。
修正了 aiTooltipAfterDescriptionElement 可写元素的一个错误，该错误导致工具提示的某些内容不可见。
修正了从 restartConversation 事件调用 instance.send 方法时会导致网络聊天错误显示问候信息的错误。

8.2.6

发布日期：2024 年 8 月 20 日

小的改进。

8.2.5

发布日期：2024 年 8 月 12 日

搜索结果更新：如果搜索结果未包含URL 或PDF文件中，您现在可以点击网络聊天卡片查看更多信息。
更新了网络聊天收到的错误样式。

8.2.4

发布日期：2024 年 8 月 5 日

修正了一个 Bug，该 Bug 可在使用扩展程序的流媒体时导致网络聊天停止工作。

8.2.3

发布日期：2024 年 7 月 29 日

更新了标记符行为： 修复了有序列表中的数字无法显示正确数字的问题。
提高消息响应速度： 删除或减少较长响应的延迟。
错误修订。

8.2.2

发布日期：2024 年 7 月 15 日

更新了搜索结果的视觉效果： 更新了搜索响应的视觉效果，使其与对话式搜索更加一致。此外，网络聊天现在还以旋转木马的形式显示搜索结果。
下拉字段的更新： 删除了 option 响应的下拉字段的最大宽度。下拉字段的宽度现在设置为聊天窗口宽度的 100%。但是，如果使用 hasContentMaxWidth: true 选项，宽度将限制为 380px。
错误修订。

8.2.1

发布日期：2024 年 7 月 1 日

还原了与助手回复中的换行符和小标题有关的更改，这些更改是根据上一版本中标记符渲染的改进而引入的。

8.2.0

发布日期: 2024 年 6 月 20 日

新的布局配置: 您可以通过设置最大宽度并除去为助手提供无缝集成的阴影来定制全屏幕交谈窗口。有关更多信息，请参阅布局配置。
新的实例方法: 您可以使用新的 updateMainHeaderTitle 更改交谈标题中的标题。有关更多信息，请参阅 instance.updateMainHeaderTitle。
新建主题配置选项: 您可以更改边角的类型，以将 Web 聊天窗口小部件设置为“四舍五入”或“平方”。有关更多信息，请参阅 Theming 配置。
新建主屏配置选项: 您可以使用 homeScreenConfig.custom_content_only 来隐藏主屏头像，欢迎消息和入门模板，以便仅显示定制内容。有关更多信息，请参阅 instance.updateHomeScreenConfig。
改进了对表，代码块，块引号和受防护代码块的 Markdown 处理。
由于网络聊天中 markdown 渲染的改进，您现在可以看到助手回复中的换行符和项目符号的变化。
错误修订

8.1.3

发布日期: 2024 年 6 月 10 日

次要错误修订。

8.1.2

发布日期: 3 2024 年 6 月

次要错误修订。

8.1.1

发布日期: 2024 年 5 月 10 日

次要错误修订。

8.1.0

发布日期: 2024 年 4 月 15 日

支持会话式搜索流: 现在可以在 Web 聊天中启用或禁用会话式搜索流。要启用会话式搜索流式方法，请转至助手中的集成 > Web 聊天 > 样式。目前，只能对会话式搜索响应启用流式方法。但是，您的客户可以在其 Web 聊天中实时查看搜索消息流。
主屏的 Accent 颜色: 现在可以应用重音色，而不是 Web 聊天主屏上的缺省背景色。您还可以控制缺省主屏幕背景上显示的渐变。要更改 Web 聊天主屏上的背景色，请转至助手中的集成 > Web 聊天 > 主屏。
更新 restartConversation() 方法：现在，除了从客户端删除 watsonx Assistant 会话外，您还可以使用 restartConversation() 方法从服务器中删除 watsonx Assistant 会话。
新建 sessionExpired 事件: 助手现在会在助手会话到期之前触发新的 sessionExpired 事件。有关更多信息，请参阅 sessionExpired 事件。

8.0.1

发布日期：2024 年 4 月 2 日

修复了在 clientVersion 设置为 'latest'，'8' 或 '8.0' 时阻止 Web 交谈装入的错误。此错误不会影响先前版本上锁定的 Web 交谈。

8.0.0

发布日期: 1 2024 年 4 月

用于 Web 聊天的新 Carbon UI: 该 Web 聊天具有升级的 Carbon UI for AI，Carbon 11，可帮助实现 AI 可解释性，并添加视觉提示，使您的交互 AI 响应。

在升级到 Web 聊天 8.0.0 之前，必须更新 Carbon 设计，因为新的 Carbon UI 与用户定义的响应和可写元素冲突。

此外，新的 Carbon 11 设计系统不支持 Carbon 10 组件。因此，将 Carbon 10 组件添加到与 Carbon 11 设计系统的 Web 聊天中可能会破坏设计样式。但是，您可以将 Carbon 11 组件添加到与 Carbon 10 设计系统的现有 Web 聊天中，因为 Carbon 11 组件与 Carbon 10 组件一起在同一代码库中工作，而不会造成任何设计中断。因此，您可以在现有 Web 交谈中将任何单独的 Carbon 10 组件升级到 Carbon 11 组件，而不中断其余 Carbon 10 组件。

新的更新后的主屏设计不再是立体的重音色，虽然未来的更新会对颜色引入控制。
新建主题配置选项: 现在，您可以在 Web 聊天中使用新的 themeConfig 属性对象来替换 carbonTheme 配置属性。配置对象中提供了以下新选项:
- carbonTheme
  
  根据 Carbon Design System 为窗口小部件选择 Carbon 主题。
- useAITheme
  
  在网页聊天中添加 IBM for AI品牌。
有关更多信息，请参阅 Web 聊天主题配置。
更新消息 API 版本：网络聊天现在使用 2023-06-15 版本的 watsonx Assistant。先前版本为 2021-09-08。有关新API版本watsonx Assistant 行为变化的更多信息，请参阅 watsonx Assistant发布说明。
新的 CSP 需求: 必须将新的 CSP 需求用于 Web 聊天。有关更多信息，请参阅 Web 聊天体系结构安全性。
定制服务台中的更改: 所有定制服务台现在都必须实现 getName() 函数。如果您使用的是没有 getName() 功能的定制服务台，那么必须先更新服务台，然后再升级到 Web 聊天 8.0.0。有关更多信息，请参阅定制服务台 API 详细信息。
页面方向设置中的更改: direction 配置选项现在在 Web 聊天中不可用，因为 Web 聊天现在使用 html 元素中的 dir 属性。此外，缺省情况下，方向配置设置为从左到右。
本机 Carbon 类替换主屏幕帮助类: 本机 Carbon 类现在替换 Web 聊天中的主屏幕帮助类。有关更多信息，请参阅 Web 聊天 CSS 帮助程序类。
不再更新 loadWatsonAssistant.js 文件：从版本 8.0.0 开始，不再更新嵌入脚本用于加载网络聊天的 loadWatsonAssistantChat.js 文件。因此，对于网络聊天版本8.0.0，您必须在嵌入脚本中使用 WatsonAssistantChatEntry.js 文件加载网络聊天，而不是 loadWatsonAssistantChat.js 文件。对于 Web 聊天版本 7.x 和更低版本，您可以继续使用嵌入脚本中的 loadWatsonAssistantChat.js 文件，即使该文件已替换为 WatsonAssistantChatEntry.js 文件也是如此。要对嵌入脚本进行任何更改，请在 Web 交谈设置的 Embed 选项卡中访问完整嵌入脚本。

不推荐使用的窗口方法: 在 Web 聊天版本 8.0.0中，不推荐使用以下窗口方法:

openWindow
closeWindow

toggleOpen

However, watsonx Assistant continues to support these window methods in web chat version 8.0.0. For more information about migrating from window to view methods, see [Migrating from window to view events and methods](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-events#windowviewmigration){: external}.

不推荐使用的事件: 在 Web 聊天版本 8.0.0中，不推荐使用以下事件:

window:pre:open
window:open
window:pre:close

window:close

However, watsonx Assistant continues to support these events in web chat version 8.0.0. For more information about migrating from window to view events, see [Migrating from window to view events and methods](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-events#windowviewmigration){: external}.

7.10.0

发布日期: 2024 年 1 月 31 日

在消息上显示时间戳记: 现在，您可以使用 enableMessageTimestamps 配置选项在 Web 交谈中的消息上显示时间戳记。有关更多信息，请参阅 Web 聊天配置。
新响应类型: 现在，您可以在 Web 聊天中选择呈现新卡，网格，轮播和按钮响应类型。有关更多信息，请参阅响应类型参考。

7.9.0

发布日期: 2023 年 12 月 11 日

增强了会话式搜索的源视图: 在 Web 聊天的会话式搜索功能中，您现在可以在可折叠轮播中访问突出显示的响应文本的源。此外，您可以通过单击响应中每个突出显示的文本来选择并查找其源。有关更多信息，请参阅对话式搜索。
向内置 PDF 查看器添加了错误处理: 如果在其查看器中打开 PDF 文档时发生任何错误，那么现在 Web 交谈会使用本机 PDF 查看器在 Web 浏览器的新选项卡中自动打开该文档。这将充当诸如不受支持的 CORS (跨源资源共享) 之类问题的变通方法。但是，在某些浏览器中，Web 聊天会在打开文档时生成 popup-blocked 错误。
添加了用于禁用内置 PDF 查看器的选项: 现在，您可以通过配置 disablePDFViewer 在 Web 交谈中禁用 PDF 查看器。当 PDF 查看器为 disabled 时，将使用 Web 浏览器中的本机 PDF 查看器在新选项卡中打开文档。有关更多信息，请参阅 Web 聊天配置。
网络聊天状态对象中的新属性：在 getState() 实例方法返回的对象中，新的 userID 属性包含网络聊天的当前 ID。例如，通过使用此功能，您可以获取有关缺省情况下 Web 聊天分配给用户的匿名用户标识的信息 (如果未创建用户标识)。

7.8.0

发布日期: 2023 年 11 月 13 日

添加了内置 PDF 查看器: PDF 文件的内置查看器可用于 watsonx Discovery 中包含 PDF 文档链接的搜索结果。文档链接必须支持 CORS (跨源资源共享) 才能在 Web 聊天中打开。
增强了 Salesforce 集成的路由配置: 从助手传递到 Web 聊天的 additional_routing_info 数据现在具有 button_id 和 button_overrides 属性，可进一步控制 Web 聊天将用户路由到代理程序的方式。不推荐使用 button_ids 属性，而是使用 button_overrides。 additional_routing_info 对象中的所有属性都是可选的。如果未包含房产价值，网络聊天将默认使用watsonx Assistant实时代理设置中的值。有关更多信息，请参阅路由信息。
修改destroySession destroySession 实例方法得到了增强，可以在调用时watsonx Assistant删除会话，并从浏览器内存中删除会话信息。

7.7.1

发布日期: 2023 年 10 月 16 日

错误修订。

7.7.0

发布日期: 5 2023 年 10 月

已向定制响应添加 fullWidth: customResponse 事件包含 fullWidth 属性，可设置此属性以指示要在主窗口中呈现完整宽度的定制响应的 Web 聊天。有关更多信息，请参阅 customResponse 事件。
允许较长的消息输入: 消息输入字段中的最大字符数从 300 增加到 2048。
将文件上载到 Salesforce: Salesforce 集成支持用户在代理程序向用户请求文件时将文件上载到代理程序。如果 Web 站点具有内容安全策略，那么可能需要添加 *.salesforce.com 以允许 Web 聊天连接到用于上载文件的 Salesforce 端点。
重新连接到 Salesforce 代理程序: 如果在用户与代理程序进行对话时重新装入 Web 聊天，那么 Salesforce 集成会自动将用户重新连接到代理程序。
新品牌: IBM 水位标记反映新的 IBM watsonx 品牌。

7.6.0

发布日期: 2023 年 8 月 21 日

向 onError 函数添加了事务标识: 当与 watsonx Assistant 通信时，onError 配置函数中的信息包含 transactionID 属性中的事务标识。有关更多信息，请参阅侦听错误。
修复了将两条消息发送到扩展时发生的错误，而无需等待。
修复了在会话历史记录期间取消 window:open 事件时 Web 聊天启动程序未呈现的错误。
错误修订。

7.5.0

发布日期: 2023 年 7 月 31 日

“体验之旅”Beta 功能的新查看选项: 随着体验之旅向 Web 聊天添加第三个视图 (其他两个视图是启动程序和主窗口)，我们不再使用专注于打开和关闭主窗口的方法和事件。不推荐使用这些事件来支持更通用的视图更改系统，该系统包含新的 instance.changeView 方法以及 view:pre:change 和 view: change 事件。您具有更多灵活性，可以同时打开多个视图。

现有助手支持窗口方法和事件。如果将导览添加到助手，或者正在使用导览，那么窗口事件和方法可能无法按预期工作，并且可能不受支持。如果要向助手添加导览，那么需要更新定制代码以使用新的视图更改方法和事件。

现有 Web 交谈和助手仍支持当前窗口方法和事件，但不推荐使用这些方法和事件，将在将来的版本中除去这些方法和事件。有关更多信息，请参阅从窗口迁移以查看事件和方法。
新的 Genesys Web Messenger 服务台集成:Genesys Web Messenger 的服务台集成不再是 Beta 版，现在包含对更多语言的用户信息字符串的支持。有关更多信息，请参阅与 Genesys Web Messenger 集成。
新的 NICE CXone 服务台集成: 发布了 NICE CXone Digital First 全渠道的服务台集成。有关更多信息，请参阅与 NICE CXone Digital First Omnichannel 集成。
添加了重新启动按钮: 新的 showRestartButton 配置选项指定除了现有 - (最小化) 按钮外，Web 聊天界面是否需要在标题中显示重新启动按钮。客户可以单击此按钮以结束对话或结束与实时代理的任何对话，同时保持交谈处于打开状态。将清除交谈记录，但保留与实时代理的对话的任何记录。有关更多信息，请参阅 showRestartButton。
Carbon charts: Carbon charts 在定制响应中受支持。
与定制服务台集成重新连接:Web 聊天现在提供对定制服务台集成的支持，以允许他们在重新装入 Web 聊天时将用户重新连接到代理程序。有关更多信息，请参阅重新连接会话。
与定制服务台集成的屏幕共享:Web 聊天提供对定制服务台集成的支持，以允许并提供用户选项来同意或停止与服务台的屏幕共享会话。实际屏幕共享功能不是由 Web 聊天提供; 必须由服务台集成提供。屏幕共享。
消息对象中的 history 属性具有新添加的 from_history 属性，用于指示消息是否来自会话历史记录。有关更多信息，请参阅消息对象扩展。

7.4.0

发布日期: 2023 年 6 月 12 日

添加了用于定制启动程序的 CSS 变量: 有关更多信息，请参阅 instance.updateCSSVariables。

7.3.0

发布日期: 2023 年 5 月 30 日

发布了 Genesys Web Messenger 服务台集成测试版，其中当前包含英语用户信息字符串。有关更多信息，请参阅 Genesys Web Messenger。
添加了对使用定制服务台集成进行文件共享的 Beta 支持，该支持当前包含英语用户信息字符串。有关更多信息，请参阅定制服务台。

7.2.2

发布日期: 1 2023 年 5 月

错误修订。

7.2.1

发布日期: 2023 年 4 月 24 日

错误修订。

7.2.0

发布日期: 2023 年 4 月 10 日

添加了对内联 iframe 响应的支持。有关更多信息，请参阅响应类型参考。
重新设计了代理程序对话体验。
错误修订。

7.1.1

发布日期: 2023 年 2 月 13 日

新旅程事件: 新的导览: 开始，导览: 结束和导览: 步骤事件提供有关用户在旅程中的进度的详细信息 (也称为导览)。这些事件可用于在用户开始旅程或到达特定步骤时浏览到特定页面，或者在旅程结束后显示调查。
新的旅程实例方法: 新的教程对象支持提供对旅程的更好控制的实例方法。您可以使用这些方法来开始或结束旅程，或者自动浏览旅程以响应用户操作。
向语言包中添加了旅程字符串: 已将旅程的新字符串添加到语言包中。您可以使用 updateLanguagePack() 实例方法修改语言包中的字符串。有关语言包的更多信息，请参阅语言。

有关体验之旅 Beta 功能的更多信息，请参阅使用体验之旅指导客户。

7.1.0

发布日期: 2023 年 1 月 17 日

已更新 Zendesk 代理程序应用程序: Zendesk 的代理程序应用程序与 Zendesk 工作空间兼容。
在服务台启动工具包中，网络聊天集成的实例被添加到 serviceDeskFactory 参数中，以便自定义服务台实现可以访问它。
新实例方法：新的 elements.getMessageInput() 和 elements.getHomeScreenInput() 实例方法可访问客户用于发送消息的输入字段。您可以使用这些方法来更改输入或在用户输入时执行操作 (例如，实现输入提示功能)。
新事件：新事件 agent:pre:sessionHistory会在消息发送到助手并存储到会话历史记录之前，过滤客户或服务台代理发送的消息中的潜在 PII。
网络聊天状态对象中的新属性：在 getState() 实例方法返回的对象中，新的 isDebugEnabled 属性指示网络聊天调试标志是否设置为 true。

7.0.0

发布日期: 5 2022 年 12 月

简化的实时代理切换: 简化并简化了实时代理切换体验。现在，Web 聊天将显示进入同一窗口中的对话的实时代理，而不是在单独的窗口中打开实时代理聊天。

由于这一更改，updateCustomMenuOptions实例方法反映了单一视图，以及单一的自定义菜单选项列表。如果您只想在即时代理聊天期间自定义菜单选项，可以订阅 agent:pre:startChat 和 agent:endChat 事件来触发自定义。
agent:endChat 更改：如果客户在代理加入之前取消了即时代理请求，agent:endChat事件现在也会触发。如果要仅在实时代理交谈后显示交谈后表单，那么可以在事件上使用新的 requestCancelled 标志来确定是否已取消请求。
新配置选项: 配置对象中提供了以下新选项:
- serviceDesk.availabilityTimeoutSeconds: 指定 Web 聊天在自动取消实时代理程序请求之前等待可用代理程序的时间。
- serviceDesk.disableAgentSessionHistory: 在会话历史记录中禁用实时代理程序交谈的存储。如果此选项设置为 true，那么不会存储实时代理交谈历史记录; 这意味着如果重新装入 Web 交谈，那么会丢失实时代理交谈历史记录。
有关更多信息，请参阅服务台选项。
elements 实例属性: 新的元素实例属性提供可用于将 CSS 样式应用于 Web 聊天所使用的各个元素的方法。 (仅支持主窗口。)
skip_card 旅程选项: 在旅程 Beta 功能中添加了对新 skip_card 属性的支持。您可以使用此属性立即开始旅程，而无需等待客户单击介绍性卡，甚至可以在根本不打开 Web 聊天的情况下从您的 Web 站点开始旅程。有关更多信息，请参阅使用旅程指导客户。
路径更改: 已更改用于与助手进行通信的一些内部路径。如果您具有配置为允许特定路径的防火墙或代理规则，那么可能需要更新配置以允许以下路径:
- /<SUBSCRIPTION_ID>/chat/<INTEGRATION_ID>/config
- /<SUBSCRIPTION_ID>/chat/<INTEGRATION_ID>/message

6.9.0

发布数据: 2022 年 11 月 14 日

现在，您可以创建旅程来指导客户完成他们可以在 Web 站点上完成的任务。旅程是一种交互式多部分响应，可将文本，视频和图像组合在一起，按顺序呈现在 Web 站点上叠加的小窗口中。

“旅程”可作为 Beta 功能提供。有关更多信息，请参阅使用旅程指导客户。

6.8.1

发布日期: 7 2022 年 11 月

错误修订。

6.8.0

发布日期: 2022 年 10 月 31 日

添加了将预交谈信息发送到 Salesforce 集成的支持。

6.7.0

发布日期: 2022 年 10 月 10 日

新建 updateIsTypingCounter() 方法: 新的 updateIsTypingCounter() 实例方法更新用于确定是否显示输入指示符的计数器。有关更多信息，请参阅 instance.updateIsTypingCounter()。
新建 updateBotUnreadIndicatorVisibility() 方法: 新的 updateBotUnreadIndicatorVisibility() 实例方法指定是显示还是隐藏启动程序图标上的未读指示符。有关更多信息，请参阅 instance.updateBotUnreadIndicatorVisibility()。
连接到代理程序和定制卡现在具有圆角。
错误修订。

6.6.2

发布日期: 2022 年 8 月 15 日

错误修订

6.6.1

发布日期: 8 2022 年 8 月

servers 属性现在支持新的 webChatScriptPrefix 选项。使用此属性可在用户浏览器与托管 Web 聊天 JavaScript 代码的 IBM Cloud 服务器之间配置代理。有关更多信息，请参阅设置代理。

6.6.0

发布日期: 2022 年 7 月 25 日

现在，在 Web 聊天配置选项中提供了新的 servers 属性。您可以使用此属性在用户浏览器与 watsonx Assistant之间设置代理。有关更多信息，请参阅设置代理。

6.5.2

发布日期: 2022 年 7 月 11 日

date 响应类型的错误修订。

6.5.1

发布日期: 2022 年 6 月 15 日

Zendesk 集成的错误修订。

6.5.0

发布日期: 6 2022 年 6 月

新代理程序事件: 现在，在与使用服务台集成的实时代理程序的对话期间发送或接收消息时，Web 聊天会触发新事件。有关更多信息，请参阅代理程序事件摘要。
错误修订。

6.4.1

发布日期: 2022 年 5 月 16 日

最小大小: 减小呈示的 Web 交谈窗口的最小允许大小，以满足 Web 内容辅助功能选项准则(WCAG)2.1 标准定义的辅助功能选项需求。
来自 iframe 的弹出窗口和选项卡: 现在，Web 聊天允许从 iframe 响应中呈现的内容打开弹出窗口和新选项卡。
更快的响应: 来自助手的响应会更快地显示，并且没有 ... 输入指示符。

6.4.0

发布日期: 2022 年 4 月 18 日

日期选取器: 如果配置步骤以收集日期客户响应，那么该步骤将使用新的 date 响应类型来请求显示图形日期选取器，以便客户可以选择日期，作为在输入字段中输入日期的替代方法。现有步骤不会自动继承此行为; 如果要使用日期选取器，那么必须删除现有日期响应，然后重新添加该响应。
跳过“连接到代理程序”卡: 提供了新的 serviceDesk.skipConnectAgentCard 配置选项。如果启用了此选项，那么 Web 聊天在收到 连接到代理 响应时将立即连接到代理，而不会首先显示卡并等待用户单击。
“关闭”按钮: 新的 showCloseAndRestartButton 配置选项指定除了现有 - (最小化) 按钮外，Web 聊天界面是否还显示 X (关闭) 按钮。客户可以单击此按钮以关闭 Web 交谈，结束对话，并结束与实时代理的任何对话。还会清除交谈记录，但保留与实时代理的对话的任何记录。

6.3.0

发布日期: 2022 年 3 月 24 日

搜索卡: 搜索卡具有新设计。
新建 restartConversation() 方法: 新的 restartConversation() 实例方法通过清除 Web 交谈记录并启动新会话来重新启动与助手的对话。它还会触发两个新事件 (pre:restartConversation 和 restartConversation)。

有关更多信息，请参阅 instance.restartConversation()、pre:restartConversation 和 restartConversation。
新建 agentEndConversation() 方法: 新的 agentEndConversation() 实例方法立即结束与实时代理的对话，而不请求用户确认。有关更多信息，请参阅 instance.agentEndConversation()。
错误修订。

6.2.0

发布日期: 7 2022 年 3 月

导航: 为 Web 聊天添加了导航功能。例如，新的“后退”和“最小化”按钮使您能够更轻松地在主屏幕，交谈视图和面板之间进行浏览。新的可定制下拉菜单显示在助手和代理程序交谈视图中的头像附近。向 Web 聊天的菜单添加新选项。有关更多信息，请参阅 [updateCustomMenuOptions](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-instance-methods#updatecustommenuoptions {: external}。

还改进了连接到实时代理程序的体验，以更清晰地显示用户如何请求代理程序，返回到与助手交谈以及结束对话。

改进了网络聊天面板的动画，使整个体验更无缝，更有凝聚力。
启动程序: 新的 Web 聊天启动程序在两个不同的场合进行退信，以吸引注意力并鼓励客户参与。有关更多信息，请参阅 Launcher 外观和行为。
Launcher: 添加了支持以控制启动程序向用户问候的文本以及显示问候消息的时间。有关更多信息，请参阅 Launcher。
语言环境: 未配置语言环境时，Web 聊天不再将系统上下文中的语言环境设置为 en-us。仅当为 Web 聊天配置了语言环境时，才会在系统上下文中设置该语言环境。
错误修订。

6.1.0

发布日期: 7 2022 年 2 月

已更新以支持对预览链接功能的内部更改。

6.0.1

发布日期: 2022 年 1 月 24 日

免责声明的错误修订。有关更多信息，请参阅配置选项对象。

6.0.0

发布日期: 2022 年 1 月 19 日

API 版本:Web 聊天现在使用 watsonx Assistant API 的 2021-11-27 版本。先前，它使用了 2020-09-24 API 版本。有关自 2020-09-24 版本以来引入的 API 更改的信息，请参阅 2021 年 11 月 27 日和 2021 年 7 月 16 日的发行说明。
Launcher: 新的 Web 聊天启动程序欢迎客户并与他们互动，以便他们了解在哪里需要帮助。有关更多信息，请参阅 Launcher 外观和行为。
主屏: 使用更现代的外观更新了 Web 聊天主屏。有关更多信息，请参阅配置主屏幕。
代理程序事件: 在使用服务台集成并与实时代理程序交互时触发新事件。如果您使用基于入门套件的自定义服务台集成，则可以在座席升级之前使用这些事件创建一个预聊天表单，在座席对话结束后创建一个后聊天表单，或者指定座席不可用时会发生什么（例如，创建一个工单提交表单）。有关更多信息，请参阅代理程序事件摘要。
Markdown 支持: 现在，Web 聊天完全支持在从助手接收到的消息中使用通用 Markdown 格式。您可能需要查看包含可识别为 Markdown的字符串的现有助手输出。 (例如，以大于 (>) 字符开头的文本行被解释为块引号。)
时区: Web 聊天在上下文中设置的时区不再覆盖助手设置的任何时区。
语言环境: 为 Web 交谈配置的任何语言环境都将作为上下文的一部分发送到助手。
窗口打开事件: window:pre:open 和 window:open 事件现在会在打开交谈窗口的任何时间触发，而不考虑原因。在先前发行版中，仅当客户通过单击内置启动程序打开窗口时，才会触发这些事件。打开交谈窗口的其他方法 (例如，会话历史记录或定制启动程序) 未触发这些事件。

传递到侦听器的事件数据具有新的 reason 属性，用于指示打开窗口的原因。如果要保留先前的行为，那么可以修改处理程序以检查此属性:
```
instance.on({ type: "window:open", handler: event => {
  if (event.data.reason === 'default_launcher') {
    // Previous code.
  }
}});
```
有关更多信息，请参阅窗口打开原因。
hideCloseButton 属性已更名：自定义面板的 hideCloseButton 属性已更名为 hideBackButton。属性的行为不变。有关更多信息，请参阅 customPanel.open()。

5.1.2

发布日期: 2021 年 12 月 11 日

Salesforce 集成的错误修订。

5.1.1

发布日期: 5 2021 年 11 月

“用户正在输入”支持: Web 聊天现在支持显示服务台的“用户正在输入”消息。 Salesforce 和 Zendesk 集成以及实现此功能的任何入门模板工具包集成都支持此功能。
错误修订。

5.1.0

发布日期: 2021 年 10 月 28 日

自定义面板：网络聊天现在支持自定义面板，您可以使用自定义面板来显示任何自定义HTML内容（例如，反馈表单或多步骤流程）。您的代码可以使用实例方法动态填充定制面板，然后打开和关闭该面板。有关更多信息，请参阅定制面板。

5.0.2

发布日期: 4 2021 年 10 月

现在提供了新教程，其中显示了如何使用 Carbon 组件来定制用户定义的响应和可写元素。
错误修订。

5.0.1

发布日期: 2021 年 9 月 20 日

错误修订。

5.0.0

发布日期: 2021 年 9 月 16 日

新的响应类型:Web 聊天现在支持新的 video，audio 和 iframe 响应类型。有关这些响应类型的更多信息，请参阅富响应。
用于启动 Web 聊天的链接: 现在，您可以创建一组 HTML 链接，这些链接直接指向您的 Web 聊天并启动有关特定主题的对话。例如，您可能想要发送电子邮件以邀请客户更新其帐户信息; 您可以包含一个链接，用于在站点上打开 Web 聊天并发送初始消息 I want to update my account。有关更多信息，请参阅创建指向 Web 聊天的链接。
CSS 改进: 改进了 CSS，以更改 Web 聊天在可包含您自己的定制内容 (例如用户定义的响应和可写元素) 的区域中重置样式的方式。新方法可更好地保护定制内容免受意外样式覆盖。有关更多信息，请参阅主题和定制内容。

如果您具有定制内容 (例如用户定义的响应或可写元素)，请验证是否仍在按预期呈现任何样式。请考虑新的 ibm-web-chat--default-样式类，以保持与 Web 聊天缺省样式的一致性。
Carbon 组件支持: 作为新样式支持的一部分，您现在可以在用户定义的响应和 Web 聊天可写元素中使用 Carbon 组件。这些组件将继承您对 Web 聊天进行的任何主题定制。
新建嵌入式脚本: 更新用于将 Web 聊天添加到 Web 站点的嵌入式脚本，以避免在锁定 Web 聊天版本时发生意外的代码更改。先前版本的脚本将继续工作，但现在已不推荐使用。如果要升级现有 Web 聊天部署以使用新脚本，请从 Web 聊天集成设置的嵌入选项卡复制更新后的代码片段。 (请记住重新应用您进行的任何定制。)
除去不推荐使用的方法和事件:
- error 事件将替换为配置对象中的 onError 方法。
- 已除去 getID 方法。
Microsoft Internet Explorer 11 不再是受支持的浏览器。

4.5.1

发布日期: 2021 年 8 月 30 日

交互式启动程序 Beta 功能的错误修订。 (有关更多信息，请参阅 launcherBeta at Configuration options object。)

4.5.0

发布日期：2021 年 7 月 29 日

提供了新的 scrollToMessage 方法，用于将 Web 交谈视图滚动到交谈历史记录中的指定消息。有关更多信息，请参阅 instance.scrollToMessage()。
提供了新的 pre:open 事件。此事件在打开 Web 交谈窗口时触发，但在装入欢迎消息或交谈历史记录之前触发。有关更多信息，请参阅 window:pre:open。
新的交谈历史记录窗口小部件可用于嵌入到服务台代理 UI 中。此新窗口小部件基于标准 Web 聊天窗口小部件的只读视图。有关在使用入门模板工具包构建的集成中使用新的交谈历史记录窗口小部件的信息，请参阅嵌入式代理程序应用程序。

4.4.1

发布日期: 6 2021 年 7 月

错误修订。

4.4.0

发布日期: 2021 年 6 月 25 日

错误修订。

4.3.0

发布日期: 7 2021 年 6 月

搜索建议: 如果为助手配置了搜索技能，那么建议包含新的 查看相关内容 部分，其中包含与用户输入相关的搜索结果。
焦点陷阱: 新的 enableFocusTrap 选项允许在打开 Web 聊天窗口小部件时在该窗口小部件中保持焦点。有关更多信息，请参阅配置选项对象。

4.2.1

发布日期: 6 2021 年 5 月

已更新服务 URL: 已更新 Web 聊天用于与助手服务通信的 URL，以除去对不推荐使用的 watsonplatform.net 域的依赖关系。此更改追溯适用于 V 3.3.0 和所有后续 Web 聊天发行版。请确保托管网络聊天小工具的系统能够访问新的 URL。

4.2.0

发布日期: 2021 年 4 月 27 日

建议中的对话入门模板: 您为主屏幕配置的对话入门模板现在显示为建议。如果启用了建议，那么对话启动者将显示在标题为 人员也对 的新部分中，以便客户可以更改主题或重新开始对话。
onError callback: Web 聊天配置中新的 onError 回调选项使您能够指定在 Web 聊天中发生错误时调用的回调函数; 并使您能够处理 Web 聊天中发生的任何错误或中断。有关更多信息，请参阅侦听错误。
窗口小部件状态中可用的会话标识: getState() 实例方法返回的状态信息现在包含当前对话的会话标识。有关更多信息，请参阅 instance.getState()。
IBM 水位标记: 现在，Web 聊天可以向用户显示 Built with IBM Watson 水位标记。对于轻量套餐上的任何新 Web 聊天集成，将始终启用此水位标记。
对列表项呈现的修订: 更新了 Web 聊天窗口小部件中 HTML 列表项的呈现。

4.1.0

发布日期: 8 2021 年 4 月

主屏幕现已全面推出：在网络聊天窗口中添加主屏幕，让客户轻松进入对话。主屏幕会问候您的客户，并显示对话启动信息，客户可以点击这些信息，轻松开始与助手聊天。
缺省情况下已启用主屏幕: 现在，缺省情况下已对所有新的 Web 聊天部署启用主屏幕功能。
主屏幕上下文支持: 现在可以从主屏幕访问上下文变量。必须使用 conversation_start 节点设置初始上下文。

4.0.0

发布日期: 2021 年 3 月 16 日

会话历史记录现在通常可用: 会话历史记录允许您的 Web 交谈在用户刷新页面或更改为同一 Web 站点上的其他页面时维护对话历史记录和上下文。缺省情况下，它处于启用状态。有关此功能的更多信息，请参阅会话历史记录。

会话历史记录仅在一个浏览器选项卡中持久存储，而不是在多个选项卡中持久存储。此对话框为要在新选项卡或同一选项卡中打开的链接提供了一个选项。有关更多信息，请参阅有关如何格式化要在同一选项卡中打开的链接的此示例。

会话历史记录将保存对具有 pre: receive 事件的消息所作的更改，以便在重新呈现时消息看起来仍然相同。仅保存会话长度的此数据。如果您希望废弃数据，请设置 event.updateHistory = false;，以便在没有在 pre: receive 事件中进行的更改的情况下重新呈现消息。

instance.updateHistoryUserDefined() 提供了一种为任何消息响应保存状态的方法。保存状态后，可以使用同一状态重新呈现响应。此已保存状态在重新装入时消息响应的 history.user_defined 部分中可用。数据在用户会话期间保存。当会话到期时，将废弃数据。

两个新的历史记录事件 history: begin 和 history: end 宣布重新装入的会话的历史记录的开始和结束。这些事件可用于查看正在重新装入的消息。 "history: begin" 事件允许您在显示消息之前对其进行编辑。

有关更多信息，请参阅有关将 customResponse 类型的状态保存在会话历史记录中的此示例。
通道切换: 现在，您可以创建对话响应类型，以便在非 Web 交谈的通道中功能地生成“连接到代理程序”响应。如果用户在 Slack 或 Facebook 等通道中，那么他们可以触发通道传输响应类型。用户会收到一个链接，用于将其转发到您组织的 Web 站点，在该 Web 站点中可以在 Web 聊天中启动与代理程序响应的连接。

3.5.0

发布日期: 2021 年 2 月 17 日

会话历史记录 (Beta):Web 聊天会话历史记录 (Beta) 现在可用。此功能使您能够在客户刷新页面或浏览到同一 Web 站点上的其他页面时维护对话历史记录和上下文。有关更多信息，请参阅会话历史记录(Beta)。

3.4.1

发布日期: 2 2021 年 2 月

对交谈历史记录进行了辅助功能增强。现在，您可以使用键来浏览消息，方法是单击交谈历史记录，然后按 Enter 键和方向键以从一条消息移至下一条消息。
添加了 instance.updateAssistantInputFieldVisibility() 以隐藏或显示文本输入字段。例如，您可以使用 pre:receive 事件来检查是否返回了选项响应类型，如果返回，请隐藏文本字段，以便强制用户仅选取其中一个可用选项。
添加了 instance.getState() 方法。在执行可能依赖于条件为 true 的操作之前，可以使用它来检查特定条件 (例如 isWebChatOpen)。

有关更多信息，请参阅实例方法。

3.3.2

发布日期：2020 年 12 月 17 日

解决了辅助功能问题。

3.3.1

发布日期：2020 年 12 月 3 日

对语言文件中的翻译字符串进行了修订和改进。
现在，如果入局消息随附的 Java Web 令牌 (JWT) 无效，那么将显示错误消息。如果打开网络聊天时第一个 JWT 失败，网络聊天窗口会显示一条错误信息，内容是 There was an error communicating with watsonx Assistant。如果初始 JWT 有效，但后续消息的令牌无效，那么会显示措辞更谨慎的错误消息，以响应不安全的输入。
错误修订。

3.3.0

发布日期：2020 年 11 月 23 日

添加了对将上下文信息从 Web 聊天传递到服务台座席的支持。
现在，可以定制 user_defined 响应类型。有关更多信息，请参阅定制响应类型教程。
错误修订。

3.2.1

发布日期：2020 年 11 月 2 日

错误修订：修复了启用安全性后阻止 Web 聊天集成预览正常运行的错误。

3.2.0

发布日期：2020 年 10 月 26 日

安全性改进：如果启用了安全性，那么在 Web 页面上装入 Web 聊天时，不再需要包含 identityToken 属性。如果最初没有提供令牌，则在首次打开网络聊天时会触发现有的 identityTokenExpired 事件，以便从您的处理程序中获取令牌。
初始工具包更新：自定义网络聊天集成检查是否有服务台代理在线时发生的超时。

3.1.1

发布日期：2020 年 10 月 22 日

辅助功能改进：更改了通知文本生成方式，以阻止通知重复。通知文本是隐藏文本，供屏幕朗读器用于指示发生动态 Web 页面更改的情况。

3.1.0

发布日期：2020 年 10 月 8 日

现在建议允许试错：如果客户选择了一个建议，但发现响应没有什么用，那么客户可以再次打开建议列表来尝试其他建议。

3.0.0

发布日期：2020 年 9 月 22 日

选择何时在建议中包含支持链接：“建议”Beta 功能已移至其自己的选项卡。即使您的网络聊天没有设置为连接到服务台解决方案，您也可以启用建议。您可以控制建议列表中是否以及何时提供连接客户支持的选项。
搜索结果格式更改：为了支持在响应中显示超过 3 个搜索结果的能力，更改了搜索技能响应类型格式。如果要使用 pre:receive 或 receive 处理程序来处理搜索结果，那么可能需要更新代码。 results 属性已替换为 primary_results 和 additional_results 属性。有关搜索技能响应类型格式的更多信息，请参阅 API 参考。
语言包密钥更改：改进后，您可以针对代理可用和不可用的情况分别指定聊天传输信息，因此更新了语言源文件。 agent_chatDescription 已重命名为 default_agent_availableMessage，并添加了另一个键 (default_agent_unavailableMessage)。如果为 agent_chatDescription 键定义了定制字符串，那么必须修改代码以反映此更改。

2.4.0

发布日期：2020 年 9 月 2 日

添加主屏：通过向 Web 聊天窗口添加主屏，使客户轻松进入交谈。主屏会问候客户，并显示客户可以单击以提交给助手的交谈入门模板消息。

2.3.0

发布日期：2020 年 8 月 10 日

介绍建议：启用此测试版功能可在聊天中显示一个助手图标，客户可以单击该图标查看其他主题或连接到代理。
搜索结果现在可展开：在 Web 聊天中显示搜索结果时，用户可以单击显示更多来查看搜索结果文本的更多内容。

2.2.0

发布日期：2020 年 7 月 29 日

引入了 instance.writeableElements() 方法：instance.writeableElements() 方法在 Web 聊天用户界面中为您提供了可以嵌入自己内容的区域。例如，可以将内容添加到标题的末尾，该内容将始终在此位置显示，即使聊天内容更改也不变。或者，可以添加在欢迎节点之前显示的定制内容。有关更多信息，请参阅实例方法。
为发送按钮提供了新外观

已将图标从更改为。
保护 Web 聊天更容易：定义 JWT 时，不再需要指定 acr 声明。认证上下文类引用由 Web 聊天自动进行管理。
提高了非英语翻译的质量。
对一些小错误做了修订。

2.1.2

发布日期：2020 年 7 月 2 日

加载问题：修复了一个问题，该问题会导致网络聊天无法在某些部署中正常加载，而这些部署的 JWT 过期时间较短。

2.1.1

发布日期：2020 年 7 月 1 日

显示服务台座席的首字母缩写：Web 聊天将用户转接到服务台座席后，座席的头像会显示在聊天窗口中，以标识从服务台座席发送的消息。如果代理人没有头像，则显示代理人姓名的首字母。

2.0

发布日期：2020 年 6 月 16 日

网络聊天添加了版本控制功能：更多信息，请参阅版本控制。
添加了双向支持：现在，可以使用 direction 参数来选择在 Web 聊天中是按从右到左还是从左到右的顺序显示文本和元素。有关更多信息，请参阅配置。
引入了 instance.destroySession() 方法：instance.destroySession() 方法用于除去与当前 Web 聊天会话相关的所有 cookie 和浏览器存储内容。可以将此方法用作 Web 站点注销序列的一部分。有关更多信息，请参阅实例方法。

1.5.3

发布日期：2020 年 4 月 14 日

从配置页面中除去了字体系列字段：在聊天窗口中显示的文本使用以下字体：IBMPlexSans, Arial, Helvetica, sans-serif。如果要使用不同的一组字体，可以为 Web 聊天实现定制 CSS。有关更多信息，请参阅 Theming。
实现未指定唯一用户标识时，Web 聊天会使用生成的匿名标识来添加第一方 cookie，以用于标识唯一用户。现在，生成的 cookie 将在 45 天后到期。有关更多信息，请参阅 GDPR 和 cookie 策略。

1.5.2

发布日期：2020 年 4 月 2 日

引入了 learningOptOut 参数：可以添加 learningOptOut 参数并将其设置为 true，以向源自 Web 聊天的每个 X-Watson-Learning-Opt-Out 请求添加 /message 头。有关页眉的更多信息，请参阅数据收集。有关更多信息，请参阅配置。

1.4.0

发布日期：2020 年 3 月 20 日

自定义CSS主题：更多信息，请参阅主题配置。
不再使用影子 DOM：在对话中使用定制响应类型或 HTML 时，可以将 Web 页面中定义的 CSS 样式应用于助手的响应。要覆盖 Web 聊天中的任何缺省样式，必须在 CSS 中指定 !important 修饰符。