SDK {{ sdkReady ? '已加载' : '未加载' }}
{{ sdkToken ? 'Token 已获取' : 'Token 未获取' }}
{{ backendOnline === null ? '后端检测中…' : backendOnline ? '后端在线' : '后端离线' }}
📋 参数映射(SDK → 后端)
integrateId → roleId(客服角色 ID)
userId → accountId(外部用户ID)
chatId → 自动管理(从 /conversation/list 获取或自动生成)
🔐 SDK Token 鉴权
获取 Token
调用 POST /open-api/auth/token 换取 SDK Token
Token 只存内存、不落盘;开启自动刷新后 SDK 会在临期前自行续期
设为 300 后开启自动刷新,约 4.5 分钟后可观察到 SDK 自动续期
启用自动刷新(向 SDK 传 getToken / tokenUrl)
expiry(临期 / 401 才取)
always(每请求前都取)
always 模式下每条消息发出前都会取一次 Token(Network 里可见),且不再依赖上方 TTL
对应后端 AiController 的 roleId 参数
对应后端 AiController 的 accountId 参数
resizable 可缩放
streaming 流式
showCategorySwitch
enableRag 知识库
debug 日志
showClear 清空
🚀 初始化 SDK
👁 打开窗口
🙈 关闭窗口
🔄 切换
🗑 清空对话
💥 销毁 SDK
💡 操作提示
1. integrateId 填写客服角色 ID(数字,对应后端 roleId)
2. userId 填写外部用户ID(对应后端 accountId)
3. chatId 自动管理:从 /conversation/list 获取或自动生成
4. SDK 默认启用 RAG 检索;开启 showCategorySwitch 可选择知识库分类