使用说明
本页面向管理员，说明系统的功能定位、核心概念、初始化配置、运行模式、消息处理流程及运维事项。
一、系统概述
基于 Telegram 的 AI 客服系统。监听账号采集客户群与供应商群的文本消息，由 AI 按场景分类并执行该场景的行为闭环，对外发送前统一脱敏。仅处理文本消息，媒体不采集；对接 OpenAI 兼容接口。
客户群 / 供应商群
文本消息
监听账号
采集
AI 客服系统
分类 · 处理 · 脱敏
对外发送
客户 / 供应商 / 管理员
两类账号分工：监听账号负责群消息的采集与收发；机器人（BOT）负责账号绑定与管理员推送。
二、核心概念
规则由四级配置构成，均为全局（配置一次全局生效），逐级细化；绑定关系作为路由表。
策略
生效范围
场景
分类单元
行为
执行动作
AI 性格
措辞语气
- 策略
- 选择本套生效的场景，并维护忽略人员名单。可创建多套，同一时间仅一套生效；未启用任何策略时不处理任何消息。
- 场景
- AI 分类的目标单元。包含话术文件
skill.md、有序行为闭环、引用的 AI 性格，以及类型：普通 与 代付（代付受余额闸门约束，见第六节）。 - 行为
- 场景闭环中的执行单元，定义动作、限制条件及结果输出模板。模板支持
{场景}{要点}{播报}{货币}等占位符。 - AI 性格
- 对外措辞的语气风格，供场景引用。
- 绑定关系
- 供应商与客户的路由表：确定某客户某场景转询时对应的供应商，并指定该路由使用的 AI 接口。
三、初始化配置
按以下顺序配置，各步骤对应左侧菜单页面。
接入
Telegram · AI 接口
基础数据
货币·通道·供应商·客户
规则配置
性格·行为·场景·策略
路由绑定
绑定关系
运行模式
即时案例
- 接入 Telegram 与 AI 接口。系统设置中配置 BOT Token 与 Telegram 应用（API ID / Hash / 手机号，并完成验证码登录启动监听账号）；AI 接口配置中填写接口地址、密钥、模型名称及 token 单价。（系统设置仅 admin 可访问。）
- 录入基础数据。货币管理录入币种，通道管理新增通道并关联货币；供应商管理、客户管理录入群组（填群 ID，群名自动获取）。供应商可配置余额相关项（是否校验余额、阈值、手动维护、默认余额）。
- 配置规则（全局）。在规则管理中依次创建 AI 性格、行为、场景，再创建策略并启用。
- 建立绑定路由。在绑定关系中按场景配对供应商与客户，并指定该路由使用的 AI 接口。
- （可选）配置缓存与余额。缓存配置中设置缓存开关、有效期、冷却时长及余额闸门，未确认可保持默认。
- 选择运行模式。在即时案例页右上角切换模式。新部署建议先以学习或 Beta 观察，稳定后切换至生产。
四、运行模式
全局设置，在即时案例页右上角切换，二次确认后生效，作为对外发送的统一门控。
生产模式
自动外发，无需人工介入。适用于话术稳定的正式运行。
Beta 模式
生成后挂起约 60 秒待确认，管理员 Good 放行、Bad 拦截；超时转入历史未处理案例。适用于话术验证。
学习模式
不对外发送，仅采集样本；可标记 Good / Bad 供后续归纳。适用于上线初期。
兜底：未启用策略或未命中生效场景时不处理；学习模式下任何情况均不对外发送。
五、消息处理流程
客户群消息的处理流程如下：
客户群收到消息
发送者是否在忽略名单内
是 → 丢弃，不处理
否
AI 将消息分类至场景
该场景是否需要转询供应商
是向对应供应商群发问（命中缓存则复用）→ 汇总并脱敏
否按场景话术与 AI 性格生成回复
当前运行模式
生产 · 立即发送
Beta · 挂起待确认
学习 · 仅记录
按模式对客户发送，全程留痕
供应商群消息用于回填等待中的客户问询；单条回复可同时回填多个等待相同结果的客户。
六、缓存、余额与学习机制
- 缓存
- 命中有效期内的回复直接复用，不重复向供应商发问；冷却期内的在途询问合并等待同一结果，避免对同一供应商的并发重复打扰。有效期与冷却时长在缓存配置中设置。
- 余额闸门
- 仅作用于 代付 类场景。供应商处于手动维护，或有效余额低于阈值时，对客户一律按“代付维护”处理。余额与状态可在缓存配置中查看、手动调整或清除缓存。
- 归纳学习
- 无检索库。管理员的 Good / Bad（可附更正）累积为待归纳样本；在场景管理执行“归纳”后写入该场景话术文件并保留历史版本。未处理或超时案例见历史未处理案例。
七、运维与账号安全
- 仅处理文本
- 图片、视频、文件等媒体不下载、不入库。
- 忽略人员
- 在策略管理中维护，填写 Telegram 用户 ID 或机器人 ID，多个以逗号分隔；命中者的消息不识别、不归纳、不学习。
- 对外脱敏
- 对外内容统一过滤群名、群 ID 及身份信息。
- 账号权限
- 登录需绑定谷歌验证器（TOTP）。系统设置，以及新增/删除账号、修改他人密码、解绑他人 Telegram、重置他人验证器，仅 admin 可执行；绑定/解绑本账号 Telegram 由本人操作（私聊机器人发送
/bind 令牌）。 - 日志审计
- 操作日志、错误日志、AI 对话日志与用量统计可供审计与排查。