卓安Claw Agent 与业务全流程融合方案 v1.0

日期：2026-11-13
状态：原型演示版方案；先定 Agent 在业务中的位置、边界和交互，不铺“万能聊天框”
关联：卓安Claw-全角色业务闭环与案件资料流转-v1.0.md、卓安Claw-录音与案件档案证据链-业务方案-v1.0.md、卓安Claw-用户身份与权限上下文-v1.0.md

0. 一句话

一个 Agent，多个业务上下文；按角色、案件、节点收敛能力和提示词；只读/起草/提议，写入必须律师确认。

不是给每个模块做一个机器人，也不是一个什么都能干的聊天框。

1. 先解决“混乱”的来源

Agent 融合最容易乱在六件事：

1. 入口乱：每个页面一个“AI 按钮”，用户不知道哪个是真的。
2. 上下文乱：Agent 不知道当前是线索、客户还是案件，拿错对象回答。
3. 权限乱：Agent 带着“超级账号”读不该读的案卷/录音。
4. 写入乱：AI 直接改清单、写记录、建任务，事后无法追责。
5. 对象乱：Agent 自己建客户/案件/任务，产生重复和孤儿数据。
6. 角色乱：客服问出承办的答案，运营看到办案信息。

对应原则：

单入口、强上下文、角色继承、只读/提议、人工确认、全审计。

2. 三层结构

2.1 上下文层（Agent 知道什么）

每次请求按顺序注入：

1. 身份：姓名、账号、角色、分所、省份、数据范围、权限。
2. 业务对象：当前线索/客户/案件；案件优先，线索/客户次之。
3. 业务阶段：12 节点当前节点、清单完成度、最近节点记录。
4. 工作对象：预约、任务、沟通录音、文书、时限、复核。
5. 可用资料索引：按权限过滤的文书/录音/知识索引，不默认塞全文。
6. 会话记忆：一案一会话/一线索一会话；切换对象即切换上下文。
7. 输出约束：能做什么、不能做什么、必须引用什么。

2.2 能力层（Agent 能做什么）

• 读工具：身份、案件上下文、清单、文书检索、文书读取、知识检索、任务、预约、沟通录音（后续）。
• 技能路由：按案件类型 + 当前节点收敛技能；刑事案件优先，其他案件类型不误过滤。
• 起草能力：文书草稿、接诊摘要、会谈提纲、结案报告、归档缺项清单。
• 提议能力：改清单、推进节点、建任务；只生成待确认动作。
• 不做：直接写库、签字、审批、报价最终决定、冲突最终判断、建客户/案件。

2.3 动作层（Agent 的输出怎么落地）

Agent 的每个输出必须是以下类型之一：

类型	例子	是否写库	UI
回答	本案争议焦点是什么	否	聊天气泡 + 来源
草稿	会见提纲、结案报告草稿	否	“AI 草稿”卡片，复制/另存
建议	下一步建议、风险提示	否	建议卡，可转任务
待确认动作	改清单、推进节点、建任务	否，等确认	“Agent 待确认”区
已确认写入	律师点确认后的动作	是	写入结果 + 审计

3. Agent 的四种使用模式

3.1 问答

用户主动问，Agent 基于当前上下文回答，必须带来源/时间点；没有依据就明确说“未检索到”。

3.2 副驾建议

工作台/案件页根据角色和节点给出 3 条以内下一步建议；不自动执行。

3.3 起草

生成文书/记录/报告草稿；标记“AI 草稿”，律师确认后才进入正式材料。

3.4 提议

把建议转成待确认动作（清单、节点、任务）；律师确认后写库。

不建议在原型里做“全自动后台 Agent”。所有后台任务只产出草稿/待办，不直接改业务状态。

4. 上下文绑定规则

4.1 对象优先级

当前案件 > 当前线索/客户 > 当前工作台

• 案件页：绑定 case_id，注入案件、节点、清单、任务、录音、文书索引。
• 客户/线索页：绑定 lead_id/client_id，注入线索、跟进、预约、录音；不注入案卷正文。
• 工作台：不绑定具体案件时，只给本人队列/今日建议；不跨案件拼接。
• 切换案件/线索：提示“上下文已切换”，旧会话不串案。

4.2 角色收敛

角色	Agent 默认能力	明确禁止
客服	线索摘要、首联话术、预约建议、缺项提示	读案卷、证据、办案记录；做谈案结论
客户经理	客户跟进摘要、回访话术、异议整理	读证据原件、确认证据、最终报价
谈案律师	接诊摘要、诊断辅助、方案草稿、风险提示	最终冲突判断、承办案件、财务审批
承办律师	案卷检索、文书草稿、庭审准备、复核辅助、归档缺项	代替律师签字/审批、直接改案卷
管理者	经营/质量/风险摘要、分诊建议、评查辅助	越权看非管辖案件、拿 AI 分数直接处罚
财务	合同/回款/退款异常提示	读录音内容、证据正文
运营	渠道线索/转化/成本分析	交付后办案信息、财务明细、案卷

4.3 权限继承

• Agent 继承当前用户 token，不做超级账号。
• 工具调用前按用户角色/数据范围过滤；C 类材料只本地检索。
• Agent 不因为“是 AI”获得额外权限；越权直接拒绝并审计。

5. 12 节点 Agent 工作图

节点	Agent 能做什么	输出类型	必须人工确认
预约	来电/咨询录音摘要、客户意向、下一步跟进、缺项提示	回答/建议/草稿	跟进动作、预约变更
建档	身份/委托材料缺项检查、客户信息抽取、冲突初筛摘要	建议/草稿	建档、冲突结论
分诊	候选律师评分解释、负荷/专长说明、冲突预筛	回答/建议	分诊分配
接诊	接诊摘要、争议点、证据现状、风险告知草稿	草稿/建议	接诊记录、风险告知
检查	证据目录检查、案卷检索、类案检索、证据缺口	回答/草稿	证据确认
诊断	要件对照、争议焦点、证据矩阵、风险等级草稿	草稿/建议	诊断结论
方案	服务方案草稿、阶段报价建议、风险告知、客户解释	草稿/建议	最终报价/方案
办案	会见提纲、阅卷摘要、文书草稿、庭审问题、时限提取	草稿/建议	文书定稿、节点推进
复核	文书体检、引证核验、前后矛盾、格式检查	回答/建议	复核结论/签字
结案	结案报告草稿、结果摘要、未了事项	草稿	结案确认
归档	六类材料缺项、录音索引草稿、归档清单	草稿/建议	归档审核
回访	回访摘要、满意度、复购/转介绍提示	回答/建议	回访记录、二次转化

6. 统一入口与 UI

6.1 一个入口

• 右侧 Agent 副驾是唯一入口；不在每个模块再做独立聊天窗。
• 顶部/上下文条显示：当前角色、当前案件/线索、当前节点、可访问范围。
• 角色切换/案件切换时，Agent 上下文明确切换，不沿用上一个案件的会话。

6.2 输出卡片

• 回答卡：结论 + 来源（文书/页码/知识/录音时间点）。
• 草稿卡：标题 + “AI 草稿”标识 + 复制/另存/送复核。
• 建议卡：3 条以内下一步 + “转任务/忽略”。
• 待确认卡：动作摘要 + 确认写入/取消；确认后进审计。

6.3 不做的 UI

• 不做“AI 自动写入”按钮。
• 不做“AI 一键结案/归档/审批”。
• 不让 Agent 自己创建客户/案件/任务；建任务只走待确认动作。
• 不在多个模块重复放“问 AI”入口。

7. Agent 记忆与知识边界

记忆	范围	用途	禁止
案件会话记忆	单案	连续对话、上下文	跨案拼接
个人执业记忆	单律师	个人经验	共享给全所/其他律师
所内知识	已复盘/已审核	类案、经验引用	未审核草稿、C 类原文
平台知识	脱敏聚合	跨所经验	案卷全文、客户身份

• 知识引用必须带来源和审核状态。
• 复盘知识未审核不得进入 Agent 默认检索。
• C 类材料只本地检索，不送外部模型。

8. 防混乱硬规则

1. 单入口：只有右侧 Agent 副驾，不另起多个机器人。
2. 强上下文：每次请求必须带身份 + 业务对象 + 节点；缺上下文时先问/降级。
3. 角色继承：Agent 权限 ≤ 当前用户权限。
4. 只读/提议：写操作只生成待确认动作。
5. 不建对象：Agent 不创建客户/案件；任务也只走提议。
6. 不跳节点：推进只允许下一节点。
7. 不编来源：没有检索到就说没有；引用必须可回链。
8. 不串案：切换案件/线索即切换会话上下文。
9. 全审计：每次调用记录角色、案件、问题摘要、工具、动作。
10. AI 标识：草稿/建议/已确认三种状态在 UI 必须可见。

9. 原型演示版 P0/P1

P0（已有/补齐）

• 一案一会话、身份上下文、案件节点上下文、清单读取。
• 案卷检索 + 页码引用。
• 清单/节点/任务待确认动作。
• 右侧上下文条 + 三类快捷提示。

P1（演示增强）

• 线索/客户上下文：客服/客户经理页面 Agent 可读线索、跟进、预约、录音摘要。
• 沟通录音检索：search_communications 工具 + 时间点引用。
• 归档缺项清单草稿：Agent 读六类材料/录音索引，输出缺项，不写库。
• 角色化快捷提示：客服/谈案/承办/管理者各 3 条，不再一套提示词。
• Agent 调用审计看板（演示薄版）。

P2（11/27 后）

• 文书草稿卡片与“送复核”。
• 后台摘要任务（录音转写后自动摘要）。
• 质检评分解释、复盘知识引用。
• 多角色评测与采纳率指标。

10. 当前代码差距

1. channel.py 只在有 case_id 时注入案件上下文；线索/客户页没有 Agent 上下文。
2. zhuoan_case 工具只服务案件，没有线索/客户工具。
3. Agent 不能检索沟通录音（zhuoan_comm_record 未接工具）。
4. 快捷提示仍是固定三条，未按角色/节点变化。
5. 待确认动作类型只有清单/节点/任务；没有“草稿送复核/归档缺项”。
6. 节点技能路由只对刑事案件收敛，其他案件类型仍全量技能。
7. 没有 Agent 调用审计看板/采纳率指标。

11. 验收

1. 客服在客户页问“这条线索下一步怎么跟”，Agent 只基于线索/预约/录音回答，不读案卷。
2. 承办在案件页问“本案证据缺口”，Agent 引用文书名+页码，不编造。
3. Agent 提议“创建会见任务”，进入待确认区；律师确认后才出现在任务链。
4. 切换到另一个案件，Agent 不再引用上一个案件内容。
5. 财务/运营账号问案件内容，Agent 拒绝或只给权限内聚合。
6. 每次 Agent 调用在审计中可查：谁、哪个案件、问什么、用了什么工具、是否确认。

12. 原型实现进度（2026-11-13）

已实现：

• 线索/客户上下文：lead_id 服务端注入，含跟进、预约、录音元数据、关联案件状态；不注入案卷正文。
• 线索/客户页「问 Agent」入口、刷新保留、上下文切换。
• 角色化快捷提示：客服/客户经理/谈案/承办/管理者各 3 条。
• 录音检索：zhuoan_case(method=search_communications)，返回沟通类型、时间、时间点与命中片段。
• 工具隔离：线索上下文下移除 case_manager，防止从客户 id 跳到关联案件读卷。
• 测试与边界见 卓安Claw-Agent线索上下文与录音检索-V1-实现说明.md。

仍未实现：

• 归档缺项草稿、Agent 审计看板、ASR worker、录音五维质检、财务/运营角色与线索负责人数据范围。