crm-ai/docs/plan-a.md

方案 A：bridge 接管 AI 编排（Live chat 优先）

决策

• 使用新 bridge 重写 AI 编排（不复用旧 bridge 代码）
• 先接 Live chat
• 保留 LibreDesk 的 widget JWT + OTP

架构

LibreDesk（渠道/工作台）
  ├─ 关闭该 inbox 的自带 AI 自动分配
  ├─ webhook message.created → bridge /libredesk/webhook
  └─ bridge 通过 Agent API Key 回写消息
Bridge（AI 编排）
  ├─ LLM 调用 + 工具循环
  ├─ RAG / 上下文 / 情绪 / 质量闭环（后续）
  └─ 业务工具（商品/订单/库存/商机/槽位）

Phase 0（已完成）

• 生成 LibreDesk Agent API Key（System 用户）
• 创建 webhook：message.created → http://bridge:4100/libredesk/webhook
• bridge webhook 端点：HMAC 验签、去重、防循环、inbox 过滤
• bridge 通过 API Key 回写 agent 消息
• Live chat 测试：LibreDesk 收到消息 → bridge 占位回复 → 工作台可见
• 测试后恢复 LibreDesk 原有 AI 自动分配

Phase 0 环境变量

LIBREDESK_API_KEY=...
LIBREDESK_API_SECRET=...
LIBREDESK_WEBHOOK_SECRET=...
LIBREDESK_WEBHOOK_INBOX_IDS=1
LIBREDESK_WEBHOOK_ID=1

Phase 1 核心（已完成）

• LLM 客户端（复用旧 DashScope qwen-plus-latest）
• 系统提示词 + 历史消息上下文
• 工具调用循环（5 个工具）
• 工具调用审计日志
• Live chat 实测：LLM 调 search_products，返回真实价格/库存/链接
• 匿名 OTP 模块（SMTP 163 + Redis，发送/校验实测通过）
• 旧 bridge pgvector RAG（vector-only；旧库无 text_tsv/parent_id）
• AI 已实测：search_kb 回答最低起订量 €30 + 引用 URL
• 匿名 OTP 端到端（AI 问邮箱 → 发码 → 客户回码 → verified → 查订单）
• 切流：inbox 1 关闭 LibreDesk AI automation，启用 bridge webhook
• Email / WhatsApp 切 bridge（目前仍由 LibreDesk AI 处理）
• 质量闭环第一步：逐会话指标 + URL/工具审计（bridge_ai_metrics）
• LLM 语义缓存（政策 FAQ，pgvector 余弦 >0.85）
• 上下文摘要/压缩（>24 条，保留最近 16 条）
• Prompt 注入防护（消息检测 + 工具结果信任边界）
• 全量商品页站点地图（www 32,691 / us 22,625，商品页 32,051/22,305）
• Hybrid RAG：text_tsv/parent_id/chunk_type，523 parent + 71 child，向量+全文+RRF+父块扩展
• 购买意向 post-LLM 追问兜底（产品+数量触发，缺公司/联系方式时多语言硬追问）
• 商机补齐：内容指纹去重、跨渠道复用/同步、阶段推进、CRM 故障 fail-closed
• 在线 FAQ/KB 同步（不依赖旧 bridge，sync-kb-online.js）
• Citation Checker / 幻觉标记 / 飞轮样本
• RAG reranker / 三级升级 / 语言硬约束 / 完整会话 Note
• KB 版本列表/回滚、sitemap 类目 KB、A/B 实验、Prometheus /metrics
• search_email_history：已验证客户邮件历史，强制按 verified email scope
• 发送前输出护栏：句子级自动重写 + URL 白名单 + 价格/库存数字必须有工具证据
• Email/WhatsApp 人工接管：Wholesale Support 团队 + assign_team 规则（AI 不再分配）
• 指标告警（错误率/工具错误/未验证 URL/延迟 + 邮件）
• 离线评测（18 条确定性黄金集 + 4 条真实模型 smoke）
• 质量闭环后续：告警、离线评测、飞轮

目前为避免 LibreDesk AI 与 bridge AI 双回复，bridge webhook 已临时停用；等 OTP/RAG 完成后切流（关闭 LibreDesk AI automation + 启用 webhook）。

Phase 2（待做）

• RAG：混合检索 / rerank / 翻译回退
• 情绪检测 / 升级策略
• 质量闭环：引用审计、指标、评测、飞轮
• Email / WhatsApp 接入

开放问题

1. LLM 是否复用旧 DashScope qwen-plus-latest 配置？
2. Phase 1 先只处理已登录 JWT 用户，匿名 OTP 用户后置？
3. RAG 用旧 bridge 的 pgvector 还是 LibreDesk 帮助中心？