系统概览
在这里查看系统状态并快速跳转到各配置页。
快速开始
- 前往 「模型配置」 选择厂商并填入 API Key
- 点击 「测试连接」 验证 Key 可用
- 前往 「知识文档」 上传并入库文档
- 在 「聊天预览」 立即体验
当前模型
向量库
知识文档
模型配置
配置智能客服使用的 AI 模型。修改后立即生效，无需重启。
💬 对话模型（生成回答）
/chat/completions🧬 向量模型（文档 Embedding）
用于把文档和问题转成向量。多数厂商的 embedding 接口与对话接口同一个 Key 和 Base URL。
{base}/embeddings向量库配置
修改向量库需要重启后端服务（SQLite + Chroma 持久化已开箱即用）。
基础设置
RAG 设置
检索增强生成的参数调优。
检索参数
回答策略
文本切分
[常见问题]，
让模型知道这段话的出处
知识文档
上传 txt / docx / xlsx / pdf 文档，自动解析 → 切分 → 向量化 → 入库。
上传新文档
📤
拖拽文件到这里，或 点击选择
支持 .txt / .md / .docx / .xlsx / .pdf，单文件 ≤ 20MB
已上传文档
客服信息
设置客服的名称、欢迎语、联系方式等。
用户信息
管理登录后台的账号：修改用户名、昵称、邮箱和登录密码。
👤 账号资料
🔑 修改密码
💡 修改密码后，其他设备上的登录会立即失效，需要用新密码重新登录；当前这台设备会自动续期，不会掉线。
聊天预览
在这里直接测试 RAG 问答效果。预览用 iframe 隔离，与真实嵌入到网站的效果一致。
嵌入指南
把你的智能客服嵌入到任何网站、小程序或桌面应用中。
方式 1：<script> 标签嵌入（最简单）
把 customer-service.js 部署到你的 CDN，然后在目标页面加入：
<script src="https://your-cdn.com/customer-service.js?v=1"></script>
<script>
CustomerService.init({
apiUrl: 'http://localhost:8000',
accent: '#0a66c2',
position: 'right',
});
</script>
💡 客服名称、头像、欢迎语不用写在这里 —— 组件会自动读取「客服信息」页的配置，
改一次对所有已嵌入的站点生效。
💡 更新组件后把 ?v=1 递增（?v=2…），否则用户浏览器会继续用缓存的旧版本。
💡 访客上传（enableUpload）默认关闭：知识文档接口需要管理员登录，访客点了只会得到 401。入库请在「知识文档」页面做。
方式 2：iframe 嵌入（完全隔离）
<iframe src="http://localhost:8000/embed"
style="position:fixed;right:20px;bottom:20px;
width:400px;height:636px;border:0;background:transparent;">
</iframe>
400×636 是面板展开后需要的尺寸（面板 360×540 + 按钮位 76 + 边距 20），
给小了面板会被裁掉；background:transparent 避免多余区域露出白底。
方式 3：微信 / 支付宝小程序
小程序不支持 <script> 注入，用 <web-view> 组件加载远端页面：
<web-view src="https://your-chat-host.com/?api=http://localhost:8000" />Widget 配置文件
直接下载：customer-service.js （19KB · 零依赖）
