DHTMLX

DHTMLX Chatbot 是什么

DHTMLX Chatbot 是用于构建 AI 聊天界面的 JavaScript 组件，适合客服助手、企业知识问答和多代理对话等 Web 应用。它提供可配置的前端交互层，但不自带大语言模型、知识库、账号系统或托管后端。

开发者需要把组件连接到自己的服务端或模型供应商，再决定鉴权、消息保存、检索增强、内容审核和用量控制方式。因此，它更接近聊天产品的 UI 开发套件，而不是开箱即用的聊天机器人服务。

核心功能

• 提供 blocks、bubbles、cards 和 flow 四种消息呈现方式，可按产品视觉选择。
• 支持纯文本与 Markdown 消息，并能设置逐字显示和流式输入状态。
• 可建立单代理或多代理聊天，侧栏用于新建、选择和删除会话。
• 支持加载既有聊天和消息，便于连接业务数据库恢复历史记录。
• 提供只读模式，适合展示对话记录、审计页面或不可编辑的演示。
• 界面对窄屏和移动浏览器自适应，但它不是独立原生手机应用。
• 组件体积约 65KB，适合嵌入现有网页而不必重建整套聊天布局。

输入、输出与数据结构

代理的响应函数可以直接返回一条消息，也可以返回异步结果。服务端接入时，开发者通常把消息发给自己的接口，再将接口响应交给组件显示。

安装与初始化

1. 选择安装方式，将组件脚本和样式加入项目。
2. 准备一个 HTML 容器，并创建 ChatBot 实例。
3. 配置当前用户、代理、消息格式、布局和侧栏。
4. 编写代理响应函数，将用户消息发送到自己的后端。
5. 在后端安全保存模型密钥，并完成鉴权、限流和错误处理。
6. 把模型响应转换成组件消息，可用追加消息方式实现流式显示。
7. 测试历史记录、删除会话、移动端布局和异常网络状态后再上线。

聊天界面配置

消息布局与格式

render 配置可切换四种消息模板，format 可在 text 与 markdown 之间选择。Markdown 适合代码、列表和富文本回答，但应用仍需对模型输出进行安全处理，避免未经清理的内容进入页面。

多代理与聊天历史

agents、chats、activeAgent 和 activeChat 用于组织多个助手与会话。客服产品可以按部门设置代理，内部助手则可按知识库或任务类型区分。

只读与本地缓存

readonly 可禁止用户修改界面数据，withCache 可把消息保存在浏览器本地。若消息敏感，共用设备或浏览器缓存可能带来泄露风险，开发者应评估是否关闭缓存并改用受控服务端存储。

组件 API 能做什么

• 新增、删除或选择聊天会话。
• 新增消息、向现有消息追加文本以及切换打字状态。
• 向组件提供消息，或在选择会话时请求对应消息。
• 读取和动态更新当前配置。
• 监听或拦截新增消息、删除会话和选择会话等动作。

这里的 API 是前端组件编程接口，不是 DHTMLX 提供的托管 AI 推理接口。调用模型仍需使用模型供应商 API 或企业自己的推理服务。

连接 OpenAI 或其他模型

文档提供了 OpenAI 接入示例，并展示如何把组件历史消息转换为模型需要的对话格式。产品也可连接 Claude、Gemini 或其他支持服务端调用的模型，具体模型能力由对应供应商决定。

1. 前端监听用户新增消息事件。
2. 将必要的会话上下文发送到受保护的业务后端。
3. 后端验证用户身份和额度，再调用模型服务。
4. 过滤或转换响应，并将普通结果或分段结果返回前端。
5. 通过新增或追加消息方法呈现答案，同时处理超时和重试。

演示代码可能为了易读而直接在浏览器调用模型，但生产环境不应把 API 密钥写入前端。否则访问者可以读取密钥并产生未授权费用。

价格与许可证

Chatbot 免费并不等于整套 AI 应用零成本，也不代表其他 DHTMLX 组件均免费。模型调用、服务器、数据库、监控和第三方服务可能分别收费。

MIT 许可证通常允许使用、复制、修改、分发及商业使用，但分发时需要保留许可证和版权声明。团队应以下载包中随附的实际许可证文本完成合规审查。

版本、GitHub 与开源状态

• Chatbot 1.0 于 2024 年发布，当前可核验到的维护版本为 1.0.3。
• 组件可通过 npm、CDN 或静态包获得，并提供公开文档、API 说明和示例。
• DHTMLX 的 GitHub 组织当前未发现 Chatbot 主组件公开源码仓库，不能把组织中的其他示例项目当作该组件源码。
• 组件标注 MIT 许可与是否托管在 GitHub 是两件事，许可证权利应以实际分发包为准。

隐私与安全

DHTMLX Chatbot 本身不提供统一托管的聊天后端，最终聊天数据流向由应用开发者决定。启用本地缓存、调用第三方模型或保存到业务数据库会产生不同的隐私和保存责任。

• 模型密钥只保存在服务端，并为不同环境使用独立凭据。
• 对用户输入和 Markdown 输出进行验证、转义或安全清理。
• 为历史消息设置最小化收集、访问权限、保存期限和删除机制。
• 向用户说明使用的模型供应商、数据用途、跨境传输和人工查看范围。
• 日志中避免记录完整提示词、密钥和敏感个人信息。
• 对模型调用设置身份验证、速率限制、费用上限和滥用检测。

DHTMLX 网站隐私政策涉及下载表单、分析工具、营销、订单和支持数据，并称删除请求会在 30 天内处理。这不自动覆盖使用者自行构建的聊天应用，应用运营者仍需提供自己的隐私说明。

适合用户与场景

• 前端开发者：快速搭建带历史记录和多种消息布局的聊天界面。
• SaaS 团队：将已有模型服务包装成品牌化客服或产品助手。
• 企业研发团队：把内部知识检索后端接入统一对话入口。
• 原型设计者：用 CDN 和模拟响应快速验证聊天交互。
• 教育与技术产品：展示导师、代码助手或多个任务代理。

优势与限制

主要优势

• 免费 MIT 许可，适合个人和商业项目。
• 专注 UI 层，能够替换不同模型和后端。
• 多种消息布局、Markdown、历史记录和多代理能力较完整。
• 安装方式灵活，并提供方法、属性、事件和集成示例。

能力边界

• 不包含模型、知识库、向量检索、内容审核或生产后端。
• 没有现成的用户登录、权限、计费和运营后台。
• 本地缓存会把消息留在浏览器，敏感场景需重新设计存储。
• 模型质量、延迟、费用和数据政策取决于接入方。
• 公开 OpenAI 示例不是可直接照搬的生产安全架构。

常见问题

DHTMLX Chatbot 是完整的 AI 机器人吗？

不是。它主要提供聊天界面和前端 API，模型推理、知识库、后端与账号系统需要开发者接入。

DHTMLX Chatbot 免费吗？

组件免费并采用 MIT 许可证。外部模型 API、服务器和其他商业组件费用不包含在内。

可以用于商业项目吗？

MIT 许可允许商业使用，但再分发时应保留许可证和版权声明。正式上线前应核对实际下载包中的许可文本。

支持哪些大模型？

组件不绑定特定模型，可通过开发者后端连接 OpenAI、Claude、Gemini 或其他系统。是否可用以及价格由相应服务决定。

支持流式回答吗？

可以通过追加消息和打字状态逐步更新界面。真正的流式传输协议和断线恢复需要后端自行实现。

如何安装？

可使用 npm、CDN 或下载静态文件。生产项目宜固定明确版本，避免最新版本更新造成未经测试的变化。

聊天记录保存在哪里？

启用 withCache 时可保存在浏览器本地，否则可由开发者的服务端提供。组件没有替应用统一决定保存期限和删除规则。

能在手机上使用吗？

界面支持响应式窄屏，可嵌入移动网页。它不是由 DHTMLX 提供的独立 iOS 或 Android 应用。

可以把模型密钥放在前端吗？

不应这样做。密钥应保存在后端，由后端完成身份验证、限流和模型调用。

有公开 GitHub 仓库吗？

当前未确认 Chatbot 主组件的公开源码仓库。MIT 授权、可下载分发与 GitHub 托管不是同一概念。

总结

DHTMLX Chatbot 适合已有模型或后端能力、希望快速补齐聊天 UI 的开发团队。它的价值是可配置界面和前端 API，而生产可用性最终取决于团队实现的安全后端、数据治理和模型集成。