简介
聊天组件是专为 AI 对话场景设计的可视化构建模块。它由可高度定制的会话列表和输入区域组成,为开发者提供了开箱即用的 AI 对话界面解决方案。该组件不仅提供直观的用户交互视图,还可以和百炼应用或模型服务无缝集成,使构建 AI 会话系统变得简单高效,适用于各种 AI 对话场景的快速开发和验证。
配置项
分类 | 配置 | 示例 | 说明 |
分类 | 配置 | 示例 | 说明 |
内容 | 信息 | 会话信息数据,可用于受控聊天列表显示的场景。该配置需接受以下对象格式的数组,聊天组件将按照数组顺序从上到下渲染会话内容:
| |
欢迎信息 | 欢迎语配置信息,用于配置聊天组件的欢迎语内容及其样式表现,主要配置内容如下:
| ||
用户内容配置 | 用户内容配置,用于配置会话流中用户角色会话气泡内容及样式表现,主要配置内容如下:
| ||
助理内容配置 | 助理内容配置,用于配置会话流中助理角色会话气泡内容及样式表现,具体配置项与用户内容配置相同。 | ||
操作栏 | 操作栏,用于配置会话气泡 hover 时显示的可交互工具栏区域的内容及其触发行为,操作栏配置由以下属性组成:
| ||
隐藏输入区域 | 隐藏输入区域,是否隐藏聊天组件的输入区域。 | ||
输入区域配置 | 输入区域配置,聊天组件输入区域样式及内容定义,具体配置内容如下:
| ||
显示名称 | 显示名称,是否在会话气泡中显示用户或助手角色的名称。 | ||
开启魔笔增强渲染 | 开启此选项后,会话气泡内容将支持 HTML 标签渲染,但可能会引起与其他组件渲染的冲突。 | ||
开启头像和内容分行显示 | 开启此选项后,头像和聊天内容换行显示 | ||
开启 toc | 开启此选项后,可以在 Markdown 中使用 ## 目录 来生成目录。 | ||
自定义标签 | 可以自定义非标准 HTML 标签的渲染模式,例如 <tag> 、<ref> | ||
交互 | 隐藏 | 隐藏,详情参见通用属性 | |
隐藏时保留布局 | 隐藏时保留布局,详情参见通用属性 | ||
加载 | 加载,聊天组件是否显示加载状态。 | ||
AI 集成操作 | AI 集成操作,用于选择与聊天组件关联“百炼智能体应用集成操作”或“百炼模型集成操作”,详情参见集成百炼应用和集成百炼模型。 | ||
高级选项 | 高级选项,可配置如下属性:
在部分较旧安卓机型,聊天组件「平滑」滚动行为模式下流式回答内容可能出现抖动,若您需要向部分旧机型的安卓设备提供服务,可考虑将滚动行为切换至“无动画”模式。 | ||
样式 | 外边距 | 外边距,详情参见通用属性 | |
模式 | 模式,聊天组件中用户及助手角色的排布方式,可选“文档”或“聊天”两种模式。其中“文档”模式将对助手和用户角色会话内容进行左侧对齐排布。 | ||
背景图片 | 设置一个或者多个背景图像,对应 CSS 属性:background-image,查看 mdn 详细说明 | ||
背景色 | 设置背景色,对应 CSS 属性:background-color,查看 mdn 详细说明 | ||
圆角 | 设置外边框圆角,对应 CSS 属性:border-radius,查看 mdn 详细说明 | ||
边框 | 设置边框属性,对应 CSS 属性:border, 查看 mdn 详细说明 | ||
上边框 | 设置上边框属性,对应 CSS 属性:border-top, 查看 mdn 详细说明 | ||
下边框 | 设置下边框属性,对应 CSS 属性:border-bottom, 查看 mdn 详细说明 | ||
左边框 | 设置左边框属性,对应 CSS 属性:border-left, 查看 mdn 详细说明 | ||
右边框 | 设置右边框属性,对应 CSS 属性:border-right, 查看 mdn 详细说明 |
属性与方法
名称 | 类型 | 示例 | 说明 |
名称 | 类型 | 示例 | 说明 |
chats | Array<{ id: string createAt: number; updateAt:number; role: user | assistant; content: string; parentId?: string; }> |
| 聊天组件会话数据 |
loading | boolean |
| 聊天组件当前加载状态 |
setChats | func |
| 设置聊天组件的会话数据 |
clearChats | func |
| 清空聊天组件的会话数据 |
setLoading | func |
| 设置聊天组件的加载状态 |
clearLoading | func |
| 清空聊天组件的加载状态 |
sendMessage | func |
| 在聊天组件中以用户角色发送一条内容 |
clearMessage | func |
| 清空聊天组件当前会话流 |
stopGenerateMessage | func |
| 停止聊天组件中当前流式返回内容的进程 |
setMessageContent | func |
| 将指定 ID 会话数据的内容变更 |
scrollToBottom | func |
| 将聊天组件会话流滚动至底部 |
事件回调
配置 | 说明 |
配置 | 说明 |
发送内容时触发的事件 | |
回答完成时触发的事件 | |
图片上传成功时触发的事件(仅在图片输入开启时生效) | |
图片上传失败时触发的事件(仅在图片输入开启时生效) | |
图片被删除时触发的事件(仅在图片输入开启时生效) | |
文件上传成功时触发的事件(仅在文件输入开启时生效) | |
文件上传失败时触发的事件(仅在文件输入开启时生效) | |
文件被删除时触发的事件(仅在文件输入开启时生效) |
- 本页导读
- 简介
- 配置项
- 属性与方法
- 事件回调