# PRD · v2.2.53 AI 配置（对接 WorkBuddy） | 项 | 内容 | |----|------| | 版本 | v2.2.53（文档 V5.1 · 终稿） | | 归属模块 | 对接 WorkBuddy › **授权页**；右上角 › **密钥配置**；设置中心 › 系统设置 › **AI 管理**；设置中心 › **线索设置**；权限管理 › **员工管理** / **岗位管理** | | 需求来源 | 对接 WorkBuddy：OAuth 设备授权绑定、已授权设备管理、AI 每日可获取线索数量控制 | | 状态 | 待评审（原型已完成） | | 原型文件 | `v2.2.53 AI配置.html`（单文件；CRM 页面右侧为改动标注栏，需横向滑动查看） | | 流程参考 | [飞书 · WorkBuddy 对接全流程白板](https://my.feishu.cn/docx/FhsgdklOzolH6JxHn62cnVMInGb)（需权限访问） | **原型深链** | 页面 | 参数 | |------|------| | 授权页 | `?view=oauth-authorize` | | 密钥配置 | `?view=agent-key` | | 系统设置 · AI 管理 | `?view=system&page=ai` | | 线索设置 | `?view=lead-setting` | | 员工管理 | `?view=staff` | | 岗位管理 | `?view=position` | | 需求说明 / 流程图 / 修改记录 | 左侧目录顶部 | --- ## 文档变更记录 | 文档版本 | 日期 | 变更摘要 | |---------|------|----------| | V5.1 | 2026-09-24 | 新增 §4 WorkBuddy 端到端对接流程（管理员配置 Connector → 员工 OAuth → 日常 Skill 调用）；修正标注规则；原型入口标注改挂用户欢迎区 | | V5.0 | 2026-09-24 | 终稿：与最新原型全量对齐；移除 Agent Key 本期能力；密钥配置改为设备列表；补充配额概念与授权跳过逻辑 | | V4.0 | 2026-09-23 | 新增 WorkBuddy 授权页；密钥配置增加第三方应用授权区块 | | V3.0 | — | Agent Key 移至右上角「密钥配置」；补充岗位权限 | | V2.0 | — | 补齐线索设置「AI 可获取线索数」、员工管理「AI 配置」与操作栏调整 | | V1.0 | — | 初稿：AI 管理 › Agent Key 配置（该方案后续已调整，见 §1.3） | --- ## 1. 背景与目标 ### 1.1 背景 系统接入 WorkBuddy 需解决三件事： 1. **OAuth 绑定**：用户在 WorkBuddy 输入指令调用 Skill 时，自动唤起 CRM 授权页；员工确认授权后，WorkBuddy 获取 access_token，无需手抄 Key。 2. **设备管理**：员工可在「密钥配置」查看已授权设备，同一账号多设备分别授权时逐条展示，支持单台撤销。 3. **用量控制**：限制每位员工每日通过 AI 获取线索的上限，支持全局默认 + 员工个人覆盖；并需明确与个人线索池容量、每日获取量的关系。 ### 1.2 本期目标 | # | 目标 | |---|------| | 1 | 提供 **WorkBuddy 授权页**（独立全屏，不含 CRM 导航） | | 2 | 在右上角「**密钥配置**」展示 **WorkBuddy 已授权设备列表**（设备名称、状态、授权时间、单台撤销） | | 3 | 在「线索设置 › 基础线索设置 › 分配设置」新增「**AI 可获取线索数**」及配额概念说明 | | 4 | 在「员工管理 › 线索设置」新增「**AI 配置**」独立开关与个人上限 | | 5 | 在「系统设置」新增「**AI 管理**」子 Tab，迁入「语音转写配置」 | | 6 | 在「岗位管理 › 编辑」功能权限树新增「**密钥配置_列表**」 | ### 1.3 方案取舍（重要） | 方案 | 状态 | 说明 | |------|------|------| | **WorkBuddy OAuth 设备授权** | ✅ 本期 | 授权页 + 密钥配置设备列表 | | **Agent Key 多平台连接** | ⏸ 暂未开放 | 早期规划：生成 Key 后连接多个不同三方平台；本期仅对接 WorkBuddy，**原型不展示** Key 列表、新增 Key、查看 Key 等入口 | > 「暂未开放」指的是 Agent Key 方案，**不是**指「第三方应用授权」区块不可用。 ### 1.4 非目标（本期原型不涉及） - Agent Key 的创建、查看、删除（页面未展示） - 密钥配置页「前往授权页」入口（授权由 WorkBuddy 自动唤起） - 授权确认页「切换账号」 - 授权成功 / 拒绝页展示 `redirect_uri` 回调参数 - WorkBuddy Connector 包开发细节（见 WorkBuddy 开放平台文档，CRM 侧只提供 OAuth 端点与业务 API） - 调用量计费、按次配额 - 线索设置除「基础线索设置」外的子 Tab 详细配置（原型展示空态） - 侧边栏非本版 CRM 菜单功能 --- ## 2. 原型范围与导航 ### 2.1 可访问页面 | 入口 | 路径 | |------|------| | 授权页 | 左侧目录 › 对接 WorkBuddy › **授权页**（独立全屏） | | 系统设置 | 设置中心 › 系统设置 | | 线索设置 | 设置中心 › 线索设置 | | 员工管理 | 权限管理 › 员工管理 | | 密钥配置 | 右上角用户菜单 › 密钥配置 | | 岗位管理 | 权限管理 › 岗位管理 | | 需求说明 / 流程图 / 修改记录 | 左侧目录顶部 | ### 2.2 不可点击菜单（置灰） 本版本未涉及的侧边栏 CRM 菜单均置灰（`nav-off`），包括：公海线索、线索管理、商机管理、客户管理、线索回收站、产品管理、应用、经营中心，以及设置中心下的消息设置、SOP 设置、发布设置、重复线索、标签设置、员工标签设置等。 ### 2.3 改动标注 | 位置 | 规则 | |------|------| | CRM 页面内容 | 红色**数字**水滴（①②③…），对应右侧标注栏说明 | | CRM 左侧导航 | 改动模块挂「**改**」字水滴（仅 `.crm-nav` 内导航项） | | **左侧原型目录** | **不展示**「改」或数字标注（目录仅用于切换预览页面） | | 密钥配置入口 | 标注 **①** 挂在**右上角用户欢迎区**（`欢迎，w_test2`），表示菜单入口位置 | | 标注栏 | 宽 400px，需向右滑动查看 | --- ## 3. 本版本改动清单 | # | 模块 | 改动点 | 类型 | |---|------|--------|------| | A | 对接 WorkBuddy | **授权页**（登录 / 授权确认 / 成功 / 拒绝） | 新增 | | B | 系统设置 | 新增「**AI 管理**」子 Tab；原「语音转写配置」迁入 | 新增/调整 | | C | 右上角 › 密钥配置 | **第三方应用授权**设备列表（设备名称、多设备、单台撤销） | 新增 | | D | 线索设置 › 基础线索设置 › 分配设置 | 新增「**AI 可获取线索数**」及配额概念说明 | 新增 | | E | 员工管理 | 操作栏「**线索设置**」与「更多」内「**奖励设置**」互换位置 | 调整 | | F | 员工管理 › 线索设置面板 | 新增「**AI 配置**」独立区块 | 新增 | | G | 岗位管理 › 编辑 | 功能权限树「系统概览」新增「**密钥配置_列表**」 | 新增 | --- ## 4. WorkBuddy 完整对接流程（端到端） > 技术人员操作指南。可视化白板见 [飞书流程图](https://my.feishu.cn/docx/FhsgdklOzolH6JxHn62cnVMInGb)；WorkBuddy Connector 配置规范见 [WorkBuddy 开放平台 · 连接器](https://open.workbuddy.cn/docs/connector)。 ### 4.1 参与角色 | 角色 | 职责 | |------|------| | **CRM 管理员** | 配置线索 AI 配额；分配岗位权限；向 WorkBuddy 侧提供 OAuth 端点信息 | | **WorkBuddy 企业管理员 / 开发者** | 在 WorkBuddy 创建 CRM Connector，配置 OAuth 2.0 与 MCP/Skill | | **CRM 员工** | 在 WorkBuddy 中触发 Skill，完成浏览器 OAuth 授权；在 CRM「密钥配置」查看/撤销设备 | | **WorkBuddy 客户端** | 检测无 Token 时打开浏览器；用 authorization_code 换 access_token；携带 Token 调 CRM API | | **CRM 服务端** | 提供 OAuth 端点、校验 Token、按配额返回线索 | ### 4.2 阶段一：CRM 侧准备（上线前 · CRM 管理员） | 步骤 | 操作 | 说明 | |------|------|------| | 1 | 线索设置 › 分配设置 | 配置「AI 可获取线索数」全局默认；明确池容量 / 每日获取量关系 | | 2 | （可选）员工管理 › 线索设置 › AI 配置 | 为个别员工开启独立 AI 上限 | | 3 | 岗位管理 › 编辑 | 勾选「系统概览 › **密钥配置_列表**」，员工才能访问密钥配置页 | | 4 | 研发部署 OAuth 端点 | 提供 `/oauth/authorize`、`/oauth/token`；注册 WorkBuddy 的 Redirect URL 白名单 | ### 4.3 阶段二：WorkBuddy 侧配置（企业管理员） 在 WorkBuddy 企业后台创建 **CRM 连接器**，认证方式选择 **OAuth 2.0（Authorization Code）**（参见 [Connector 管理](https://www.workbuddy.cn/docs/enterprise/adminguide/Connector%E7%AE%A1%E7%90%86)）： | 配置项 | 填写内容 | |--------|----------| | Authorization URL | CRM 授权页地址，如 `https://{crm-domain}/oauth/authorize` | | Token URL | CRM 令牌端点，如 `https://{crm-domain}/oauth/token` | | Client ID / Client Secret | CRM 为 WorkBuddy 注册的 OAuth 应用凭证 | | Redirect URL | 使用 WorkBuddy 提供的回调地址，并加入 CRM OAuth 白名单 | | Scopes | 与 CRM 授权页展示的权限一致（读身份、AI 获取线索、查今日已取数） | | MCP Server / Skill | 配置调用 CRM「获取线索」等能力的 MCP 工具及 Skill 说明 | > Connector 发布并分配给员工后，员工才能在 WorkBuddy 中安装并使用 CRM 能力。 ### 4.4 阶段三：员工首次使用 · OAuth 授权 **触发**：员工在 WorkBuddy 输入自然语言指令，Expert 加载 CRM Skill，调用需鉴权的 MCP 工具；WorkBuddy 检测到该员工**尚未授权**（无有效 access_token），自动打开系统浏览器。 ```mermaid sequenceDiagram participant WB as WorkBuddy participant Browser as 浏览器 participant CRM as CRM 授权页 participant API as CRM API WB->>Browser: 打开 /oauth/authorize?client_id&redirect_uri&state&scope alt 员工未登录 CRM CRM->>Browser: 展示登录页 Browser->>CRM: 提交账号密码 end CRM->>Browser: 展示授权确认页 alt 员工点击「授权」 CRM->>Browser: 302 redirect_uri?code=xxx&state=xxx Browser->>WB: 回调携带 code WB->>API: POST /oauth/token（code 换 token） API-->>WB: access_token (+ refresh_token) WB->>Browser: 关闭窗口 / 提示返回 WorkBuddy else 员工点击「拒绝」 CRM->>Browser: 302 redirect_uri?error=access_denied Browser->>WB: 授权失败 end ``` | 场景 | CRM 页面流转 | |------|-------------| | 未授权 · 未登录 | 登录页 → 授权确认页 → 成功 / 已拒绝 | | 未授权 · 已登录 | 授权确认页 → 成功 / 已拒绝 | | **已授权** | **跳过整个授权流程**，WorkBuddy 直接使用已有 Token | 授权成功后： - WorkBuddy 本地保存 Token（按设备维度） - CRM「密钥配置 › 第三方应用授权」**新增一条设备记录**（设备名称、授权时间） - 员工返回 WorkBuddy 继续对话 ### 4.5 阶段四：日常使用 · Skill 获取线索 ```mermaid sequenceDiagram participant User as 员工 participant WB as WorkBuddy participant CRM as CRM API User->>WB: 输入指令（如「帮我获取线索」） WB->>WB: 加载 CRM Skill，选择 MCP 工具 alt 已有有效 Token WB->>CRM: 请求线索（Header: Bearer access_token） CRM->>CRM: 校验 Token + AI 配额 + 线索池容量 alt 配额通过 CRM-->>WB: 返回线索数据 WB-->>User: 展示结果 else 配额不足 / 池已满 CRM-->>WB: 拒绝（明确原因） WB-->>User: 提示已达上限 end else Token 失效 / 已撤销 WB->>User: 引导重新授权（回到阶段三） end ``` **CRM 配额判断顺序**（详见 §10、§11）： 1. 确定 AI 每日上限（员工个人配置 > 全局默认） 2. 判断今日 AI 已取数是否达上限 3. 判断个人线索池累计是否已满 ### 4.6 设备管理与撤销 | 操作 | 位置 | 效果 | |------|------|------| | 查看已授权设备 | CRM › 密钥配置 | 按设备名称逐条展示 | | 撤销单台设备 | 列表「撤销授权」 | 仅解除该设备；WorkBuddy 在该设备上需重新走 OAuth | | 多设备 | 同一 CRM 账号 | 每台设备独立授权、独立展示 | ### 4.7 研发分工速查 | 系统 | 本期需实现 | |------|-----------| | **CRM** | OAuth 授权页；`/oauth/authorize`、`/oauth/token`；业务 API 鉴权；配额校验；密钥配置设备列表 CRUD | | **WorkBuddy** | Connector（OAuth 2.0 配置 + MCP/Skill）；客户端授权跳转与 Token 存储 | | **联调** | Redirect URL 白名单；scope 对齐；授权成功后 Token 可调通获取线索 API | --- ## 5. CRM 授权页（页面规格） ### 5.1 触发与流程 见 §4.4。原型预览入口：左侧目录「对接 WorkBuddy › 授权页」。 ### 5.2 页面特征 - **独立全屏**，不含 CRM 左侧导航、顶栏、页签 - 顶部流程条：WorkBuddy 打开授权页 → 登录 CRM → 确认授权 → 完成 / 拒绝 - 底部演示条可切换四种状态（原型专用） ### 5.3 各状态说明 #### 未登录 | 区域 | 内容 | |------|------| | 标题 | 请先登录您的账号 | | 说明 | 登录后将进入授权确认页 | | 表单 | 账号、密码、「记住我」 | | 操作 | 「登录」→ 授权确认页 | #### 授权确认 | 区域 | 内容 | |------|------| | 标题 | WorkBuddy 请求访问您的 CRM | | 当前账号 | 展示登录员工信息（只读，**不支持切换账号**） | | 权限范围 | 纯文本列表（**非可勾选**） | | 操作 | 「拒绝」/「授权」 | #### 授权成功 / 已拒绝 - 成功：提示返回 WorkBuddy；**不展示** redirect_uri - 拒绝：可「重新授权」回到确认页 ### 5.4 CRM OAuth 端点（研发参考） | 端点 | 说明 | |------|------| | `GET /oauth/authorize` | 展示授权页；未登录则先登录 | | `POST /oauth/authorize` | 用户确认授权，生成 code 并 302 跳转 | | `POST /oauth/token` | WorkBuddy 用 code 换取 access_token | --- ## 6. 右上角 › 密钥配置 ### 6.1 入口与权限 | 项 | 说明 | |----|------| | 入口 | 右上角用户菜单 ›「密钥配置」 | | 权限 | 「系统概览 › **密钥配置_列表**」 | | 原型标注 | 入口说明 **①** 挂在用户欢迎区 | ### 6.2 第三方应用授权 **说明文案**： > 可在此查看与管理已绑定的各设备；同一账号下多台设备授权后将逐条展示设备名称。 ### 6.3 已授权设备列表 | 列 | 说明 | |----|------| | **设备名称** | 已授权设备名称 | | 授权方式 | OAuth 2.0 | | 状态 | 已连接 | | 授权时间 | 该设备首次授权时间 | | 操作 | 「撤销授权」（单台） | ### 6.4 本期不包含（原型未展示） - Agent Key 列表、新增 Key、查看 Key - 「前往授权页」按钮 --- ## 7. 系统设置 › AI 管理 ### 7.1 信息架构 「AI 管理」为系统设置末位子 Tab，本期仅含 **语音转写配置**（自原 Tab 迁入）。密钥配置已移至右上角个人菜单。 ### 7.2 语音转写配置 | 字段 | 原型默认 | |------|----------| | 供应商 | SiliconFlow | | API Key | 占位脱敏值 | | 模型名称 | XingChenAGI/XingChenASR-V3.2 | | 状态 | 开启 | --- ## 8. 线索设置 › 分配设置 **位置**：基础线索设置 › 分配设置（其他子 Tab 为空态）。 | 字段 | 原型演示值 | 说明 | |------|-----------|------| | 每日获取量（公海） | 10 | 常规途径每日限额 | | 新线索数量 | 10 | 常规途径每日限额 | | **AI 可获取线索数** | 10 | 仅 AI 途径每日限额 | | 个人线索池容量 | 500 | 历史累计总上限 | **配额关系**：每日获取量与 AI 可获取线索数互不干涉；累计总数不可超过个人线索池容量。 --- ## 9. 员工管理 ### 9.1 操作栏 - 操作栏：下班 · **线索设置** · 编辑 · 更多 - 更多：奖励设置 · 积分日志 · 修改密码 · 删除 ### 9.2 AI 配置（线索设置抽屉内） | 项 | 内容 | |----|------| | 开关 | 独立「AI 配置」，默认关 | | 字段 | AI 可获取的线索数量（原型默认 10） | | 独立性 | 与分配 / 领取 / 公海可见范围互不联动 | --- ## 10. 岗位管理 岗位编辑 › 功能权限树 › 系统概览 › 新增 **密钥配置_列表**。 --- ## 11. AI 线索数量生效优先级 ``` 员工个人 AI 配置（开启） → 以个人值为准 未开启 → 全局默认（线索设置 › AI 可获取线索数） 值为 0 → 禁止 AI 获取 ``` 同时校验**个人线索池容量**（§8）。 --- ## 12. 验收用例（UAT） | # | 用例 | 预期 | |---|------|------| | T1 | 目录 › 授权页 | 可切换四种授权状态 | | T2 | 授权确认页 | 无「切换账号」；权限为纯文本列表 | | T3 | 授权成功 | 不展示 redirect_uri | | T4 | 授权成功后密钥配置 | 设备列表新增记录 | | T5 | 密钥配置 · 多设备 | 逐条展示；可单台撤销 | | T6 | 密钥配置页 | 无 Agent Key；无「前往授权页」 | | T7 | 密钥配置入口标注 | ① 在用户欢迎区，不在原型目录 | | T8 | 原型目录 | 不展示「改」标注 | | T9 | 线索设置 | 含 AI 配额及概念说明 | | T10 | 员工 AI 配置 | 独立开关可保存 | | T11 | 岗位权限 | 含「密钥配置_列表」 | | T12 | PRD §4 流程 | 研发可按阶段一～四实施与联调 | --- ## 13. 附录 · 原型修改记录摘要 > 完整记录见原型「修改记录」，按日期倒序。 **2026-09-24** 1. 补充 WorkBuddy 端到端流程；PRD V5.1 2. 原型目录移除「改」标注；密钥配置入口标注①挂用户欢迎区 3. 密钥配置文案与设备列表；授权页交互优化 4. 线索配额标注；移除 Agent Key 展示 **2026-09-23** — 新增授权页；三栏布局 **2026-09-21** — 初版原型