多租户 AI 智能客服系统：一套后台，多端接入，AI 全自动接待 + 人工随时介入
以下为系统核心能力：
PC 浮窗（SDK）、H5 全屏页、Android/iOS WebView、微信小程序 web-view，以及企业微信客服（原生会话，客户无需下载 App）。
大模型驱动（OpenAI 兼容协议，可接 DeepSeek/通义/Kimi 等），支持多租户独立模型配置、并发与配额管理。
文档导入 + 向量检索，回答基于企业知识精准生成；支持多知识库、自动更新与相似度调节。
会话列表、客户画像、人工介入（AI↔人工无缝切换）、快捷回复、满意度评价，客服效率一目了然。
会话一键转工单，状态流转与跟进记录完整留痕，适合复杂售后与跨部门协作。
Token 用量、会话量、渠道链路日志全链路排查（回调→拉取→AI→下发，含失败原因与耗时），问题分钟级定位。
对接 ERP、CRM、地图、天气等外部业务系统：平台公共模板 + 租户私有工具 + 密钥加密管理，URL 模板变量实时预览、一键测试接口，AI 可直接查询真实业务数据。
精细化 RBAC 角色权限（菜单/操作级），租户数据完全隔离；密钥 AES-GCM 加密存储、明文永不入库；工具调用全链路审计日志。
离线检索评测集验证问答命中率，支持按类型/问法鲁棒性回归测试；知识库命中溯源，每条 AI 回答都能找到依据文档。
从部署到运营的完整使用路径：平台管理员 / 租户管理员 / 客服 / 终端用户 / 运维可观测
docker compose up -d --build，全部服务约 1~2 分钟健康检查通过{{变量}} 占位符）、入参 Schema、响应提取路径，支持一键测试真实接口并写入响应示例PC / H5 / Android / iOS / 微信小程序 五端接入完整代码，一键复制即用
在管理后台创建租户，获取 app_key 和 app_secret
用 app_key/app_secret 调用 /api/auth/token 换取 access_token
PC 用 SDK 浮窗，移动端用 h5/chat.html 全屏页面
user_id 格式 {tenant_id}:{uid}，同一用户固定不变
加载中...
{tenant_id}:{uid}，否则鉴权失败（如 t_demo:user_12345）cs-chat.js，自动渲染浮窗按钮，体验最好/sdk/cs-chat@2.1.0.js（服务端已配置别名，始终指向当前版本）。SDK 升级后只需修改 URL 中的版本号，即可强制刷新第三方浏览器缓存，避免旧代码残留客户问题直达真实业务数据：ERP 订单、物流、CRM、地图、天气… AI 通过工具实时查询并作答
{{变量}} 占位符（租户凭证）与 {{args.参数}}（AI 入参），测试弹窗实时预览最终请求地址与参数secret://密钥名 引用，AES-GCM 加密存储，明文永不入库、永不回显URL 模板: {{base_url}}/api/v1/orders/query?key={{api_key}}
请求方法: POST
请求体模板: {"order_no":"{{args.order_no}}"}
入参 Schema: {"type":"object","properties":{"order_no":{"type":"string","description":"订单号"}},"required":["order_no"]}
响应提取: if .data==null then "未查询到订单，请核对订单号" else (.data|{order_no:.order_no,status:.status,amount:.amount,logistics:.logistics}) end
租户配置变量: base_url=http://thirddemo:9900 api_key=secret://DEMO_ERP_KEY_2026
客户提问「帮我查下订单 ORD-2026-0001 到哪了」→ AI 自动调用工具 → 返回：
{"order_no":"ORD-2026-0001","status":"已发货","amount":299,"logistics":"顺丰速运 SF1324567890"}扫码或点击按钮，立即体验微信客服端 AI 自动接待
点击下方链接或扫码，立即体验微信客服端对话（AI 自动接待，客户无需加好友、无需安装 App）。
👆 扫码体验微信客服端
https://work.weixin.qq.com/kfid/kfca87e816d5bfc3e60自建接入：管理后台「业务中心 → 渠道管理 → 渠道配置」填入 corpid / secret / open_kfid / token / EncodingAESKey，并将企业微信后台的接入链接复制到「接入链接」栏（kfid/xxx，不可自动生成）保存即可，接入步骤见下。
在企业微信管理后台 → 「应用管理 → 微信客服」开通并创建客服账号，复制页面上的接入链接（形如 https://work.weixin.qq.com/kfid/kfxxx，kf 开头）；open_kfid（wk 开头，API 用）后台不直接显示，可用接口 kf/account/list 获取。
获取 corpid（我的企业 → 企业ID）与 secret（微信客服 API 查看），并在后台配置回调 Token 与 EncodingAESKey（随机生成 43 位密钥）。
登录系统管理后台 → 「业务中心 → 渠道管理 → 渠道配置」，选择微信客服，填入上述 corpid / secret / open_kfid / token / EncodingAESKey 并保存。
回调查收地址填 https://{你的域名}/api/channel/wecom_kf/callback/{租户ID}（配置页自动生成，直接复制），填入企业微信回调 URL；同时将回调域名加入企业微信「可信域名」。
保存后渠道配置页展示接入链接 + 二维码（链接为企业微信后台复制来的 kfid 链接），复制或扫码即可分发给客户。
客户进入会话 → 系统自动拉取消息 → AI 回复；人工可在「会话列表」随时介入。排查问题看「统计管理 → 渠道日志」，完整链路一目了然。
右下角 💬 客服按钮由 SDK 自动渲染，也可直接扫码上面的微信客服入口
右下角 💬客服 按钮由 SDK 自动渲染，点击可体验完整客服对话。下方按钮可测试 SDK API。
接入、知识库、Agent 工具、部署与人工介入的高频问题
A：PC 网站浮窗（SDK）、H5 网页、Android/iOS WebView、微信小程序 web-view，以及企业微信客服原生会话（客户无需下载 App）。
A：通过知识库（RAG）导入企业文档，回答基于向量检索精准生成；系统提供检索评测与命中溯源，可验证每条回答的知识来源。
A：可以。内置 Agent 工具：平台公共模板（如 ERP 订单查询、链接读取）租户填凭证即可用；也可创建租户私有工具对接自有接口，支持 URL 模板变量、密钥加密管理与一键接口测试。
A：Docker Compose 一键部署，包含 Go 网关、Python Agent、向量库 Qdrant、MySQL/PostgreSQL、Redis、Nginx 全栈镜像，并提供阿里云 ACR 打包上传脚本。
A：客服在会话列表可随时接管 AI 对话（AI↔人工无缝切换），支持快捷回复、满意度评价、会话一键转工单，全程留痕可追溯。
A：在企业微信后台开通微信客服并获取 corpid / secret / open_kfid，系统后台「业务中心 → 渠道管理」填入配置并保存，回调查收地址由系统自动生成，扫码或复制链接即可分发。
A：支持。租户「配置中心 → 基础配置」配置语音识别(ASR)与图片识别(OCR)服务（OpenAI 兼容协议，一键测试连通性）；AI 接管时语音自动转写、图片自动识别后回答，人工接管时客服点击「转文字 / 识别文字」按钮触发；微信客服渠道另有渠道级开关，两级开关同时开启才生效。
A：支持 Webhook 异步通知：工单超时未接管、用量阈值告警、渠道异常告警三类事件，RabbitMQ 事件驱动触发 + 60 秒轮询兜底，Redis 幂等防重复推送，同一规则一天最多推送一次。
A：有。语音识别、图片识别、通知推送等 AI 能力调用统一记录调用日志（租户/能力/场景/状态/耗时），RabbitMQ 异步攒批落库，平台管理员全览、租户仅看本租户，「统计管理 → 调用日志」即可排查。