系统使用文档

涵盖：平台管理员后台使用说明 + 企业（租户）接入说明，帮助不同角色快速上手。

一、系统角色总览

角色	登录入口	主要职责
平台管理员	登录后进入「平台后台」	管理所有租户、套餐、订单、平台品牌与默认大模型、审计日志
企业管理员（租户）	登录后进入「座席工作台」顶部切到「企业后台」	配置品牌与欢迎语、管理坐席团队、搭建知识库、接入自己的大模型、查看数据
坐席	登录后进入「座席工作台」	实时接待访客、转接、关闭会话
访客（终端用户）	你的网站悬浮窗 / 聊天页	咨询问题，无需登录

二、平台管理员后台使用说明

2.1 租户管理

• 查看全部租户：名称、企业标识(slug)、套餐、状态、坐席数、未关闭会话。
• 支持按关键词 / 状态 / 套餐筛选，列表分页。
• 可新增、编辑租户（名称、slug、套餐、坐席配额、是否启用 AI、到期时间）。
• 可一键「停用 / 恢复」租户；删除租户需二次确认（级联清理其坐席与知识库）。

2.2 套餐管理

• 定义可用套餐：slug、名称、坐席配额、是否含 AI、价格（元，存储为分）、计费周期、描述。
• 可上架 / 下架（toggle）、编辑、删除。内置免费套餐 trial 不可删除。
• 套餐用于租户购买与价格展示页实时渲染。

2.3 订单管理

• 查看所有订单：订单号、租户、套餐、金额、渠道、状态、时间。
• 对未支付订单可操作「确认已付 / 退款 / 作废」，确认支付即激活对应套餐。

2.4 平台配置

• 按分组维护：平台品牌（站名、Logo、favicon、版权）、大模型（应答/向量的 base_url、api_key、模型名）、推送(uni-push)、支付渠道配置。
• 品牌 Logo / favicon 支持真实上传。这些值作为「平台默认」，当租户未自定义时兜底。
• 启用大模型多模型请在「大模型管理」中维护 provider 并点击「设为默认」。

2.5 大模型管理（多模型）

• 新增/编辑模型 Provider：名称、base_url、api_key、应答模型、向量模型（可选），全部走 OpenAI 兼容接口。
• 多模型并存可切换：可「设为默认」决定应答用哪个；「启停」控制是否可用。
• 提供「连通性测试」：填写地址/密钥/模型后真实调用返回模型原文，验证配置无误再保存。

2.6 审计日志

• 记录平台与租户的关键操作（新建/更新配置、下单、删除等），支持关键词搜索与分页，便于追踪与防控。

三、企业（租户）接入与后台说明

3.1 快速接入三步走

3.2 接入配置

• 品牌：品牌显示名、Logo（真实上传）、主题色（取色器）、图标。悬浮窗与聊天页自动跟随主题色渲染，不写死。
• 欢迎文案：欢迎标题、欢迎语。
• 企业信息：企业名称、地址、电话、邮箱、营业时间、客服语言。
• 功能开关：是否展示坐席头像、是否允许访客传文件、结束评价。
• 服务条款 / 隐私政策链接、悬浮窗自定义菜单。
• 保存后页面即时渲染「品牌预览」，所见即所得。

3.3 坐席团队

• 新增坐席（可填写姓名/账号/角色/状态），编辑、删除、启停，二次确认。
• 坐席数受当前套餐配额限制（配额提升需升级套餐）。
• 坐席使用同一登录名登录后进入「座席工作台」接待。

3.4 知识库与 AI 应答

• 在「知识库」上传文档 → 点击「向量化」→ 即可被语义检索。
• 配置好大模型后，在「接入配置」开启 bot_enabled，当访客咨询且无在线坐席时，AI 会自动应答；支持知识库检索增强回答。
• 「AI 用量」页可查看 AI 调用统计。

3.5 会话 / 看板

• 「看板」展示会话总量、访客数、待办等统计。
• 「会话」页可按状态 / 关键词查看会话与消息详情。

3.6 开放 API 与凭证

• 「接入配置」中可「重新生成 API token」，用于你的服务端调用 /api/openapi/* 接口，把客服能力接入自有 CRM / 工单系统。

四、座席工作台（实时接待）

• 左侧实时会话列表：自动更新，显示状态、客户名、最后消息、未读角标；支持状态筛选与关键词搜索。
• 点击会话右上「接入」开始接待；可「转接」给团队成员；处理完毕「关闭」会话。
• 访客发图/发文件可实时预览与下载；座席输入框回车即可发送。
• 聊天支持多会话在右侧并行查看并切换。

五、访客侧（终端用户）使用

• 访客在你的网站右下角看到品牌定制悬浮窗，点击后弹出聊天窗口。
• 支持发送文字、图片、文件；如无人工坐席在线且企业开启 AI，将得到 AI 自动答复。
• 也支持跳转全屏聊天页（/chat.html?slug=你的slug）或在小程序/App 内嵌 kefuChat 组件。