张胜宇
5d0becb67d
一、客服 Agent 智能增强（正面回应"不智能、动不动就转人工"）
- 决策链由 2 个出口扩到 5 个：E1 澄清 / E2 计算型 / E3 知识直返 / E4 证据约束生成 / E5 分级回退
- 转人工从"默认动作"降为最后一档 E5c，只保留 4 类白名单：
P0 反诈 / P1 账户与个人数据 / P2 写操作与争议 / 用户明确要求人工
- 46 条金标实测（修复前 → 修复后）：
转人工率 43.5% → 10.9%；出口准确率 45.7% → 100%；事实正确率 69.6% → 100%
禁忌违反 1 → 0；档位越权 / 无出处数字 / 误拒 四项零容忍全 0
- 安全不变量 INV-1~INV-5；零容忍规则未删，改的是挂载点
（输出侧字面黑名单 → 检索层档位隔离 + 判定层合规词表 + 输出守护）
二、知识库：档位单点化与物理隔离
- 新增 app/core/knowledge_tier.py 作为档位规则唯一落点（G-03），
knowledge_contracts.py 原定义块改为显式再导出（X as X，非副本）
- 档位过滤由 bool 默认值（fail-open）改为 tiers 必填集合（缺参即 TypeError）
- Milvus 侧四集合按 visibility 分区键物理隔离；双 schema 收敛为一套
- 新增 app/core/actor.py：访客三元组与匿名判定的唯一构造/判定点（G-01/G-01b）
- 新增 app/core/fund_fee_rules.py：费率计算纯函数
三、前端入参边界对齐（本轮 W11 新修，4 处"校验宽于存储"）
- message 加 max_length=8000（与浮窗 widget.js 的 maxlength 一致）
- session_id 加 1—64；idempotency_key 上限 128 → 64（对齐列宽 String(64)）
- feedback_type 加 max_length=32（对齐列宽 String(32)）
- 8 条路径参数补 min_length=1 + max_length=64 + 字符集正则
（{session_id} / {run_id} / {handover_id}）
- 改前超限值会落到 MySQL 才失败（500）；改后一律 422 AGENT_INPUT_INVALID + 字段级定位
- 新增 tests/unit/api/test_frontend_boundaries.py（33 例），含"端点表 ↔ OpenAPI 全量对照"
四、投顾模块整体清除（D4.4 / D4.5）
- 删除投顾相关 controller / schema / model / repository / service 及门户页面
- tools/portal_api_check.py 同步作废 AD003/AD005/AD011/A047 四条用例与 advisor_t 登录
（端点与账号均已不存在，此前稳定报 3 条假红）
五、验证（提交前实测）
- pytest -q：1856 passed / 2 skipped / 0 failed
- ruff check app tools tests：19（= 基线）；mypy app：2（= 基线）
- 前端接口契约体检 portal_api_check.py：38 项，通过 34，失败 0，跳过 4
- 全链路冒烟 e2e_smoke_test.py --read-only：31/31
- HTTP 全链路探针 http_probe.py：11/11 succeeded
- 跨文档一致性 _consistency.py：GATE PASS
- 真机边界复验 12 条：12/12 符合预期
六、纪律与文档
- 可改文件白名单 A-09（docs/46）与底座会签申请单 A-10（docs/47，组 1—组 4 全部受理）
- 零 DDL：未新增/修改任何表结构，89 张业务表与基线一致
- 证据留痕：docs/evidence/**（含 46 条金标 score、快照、清除与重建记录）
- 未提交（刻意排除，见提交说明）：仓库内 客服agent/ 与 开发文档/ 是 2026-09-16 前的
过期副本（Todolist 440 行 vs 权威 D2.1 1167 行），权威正本在仓库外；
_chunks_report.txt 是 tools/build_knowledge_chunks.py 生成的本地产物
88 lines
5.6 KiB
JSON
88 lines
5.6 KiB
JSON
{
|
||
"artifact": "t2b-accept-pipeline",
|
||
"generated_at": "2026-09-18T10:29:36.863390Z",
|
||
"date_local": "2026-09-18",
|
||
"purpose": "D2.1 T2 第二步：受理服务随客服模块清除被剥掉的 4 项能力中，补齐 3 项、有意放弃 1 项",
|
||
"trigger": "T2-1 的基线红测试 test_agent_run_acceptance::test_customer_service_accept_redacts_sensitive_message_before_persistence 查明了原因：受理时的消息脱敏不存在，客户原始凭据明文落库",
|
||
"removed_capabilities_and_disposition": [
|
||
{
|
||
"capability": "受理时消息脱敏 sanitize_customer_service_message",
|
||
"head_reference": "HEAD:app/service/agent_run_application_service.py:149",
|
||
"before": "ConversationMessage.content = request.message（原文）",
|
||
"after": "stored_request = request.model_copy(update={'message': sanitize(...)})；落库与幂等哈希都用脱敏形状",
|
||
"why_hash_too": "幂等哈希若仍用原文，同一请求的两次提交会因「原文 vs 脱敏文本」算出两个哈希而互相冲突",
|
||
"status": "已恢复"
|
||
},
|
||
{
|
||
"capability": "chitchat_streak 服务端覆写",
|
||
"before": "无写入方（Agent 侧 request.metadata.chitchat_streak 恒为 0，收口引导永不触发）",
|
||
"after": "chitchat_streak() 与两张闲聊表从已删的 customer_service_routing.py 收口进 app/core/customer_service_rules.py；受理时用已落库历史重算并覆写",
|
||
"status": "已恢复"
|
||
},
|
||
{
|
||
"capability": "clarification_round 服务端覆写",
|
||
"before": "无写入方；且 Agent 的 E5a 读 context.clarification_round 恒为 0，同话题上限 2 轮失效",
|
||
"after": "受理时取自会话行并夹紧到 le=2（model_copy(update=...) 不校验）；Agent 的 E5a 改读 request.metadata.clarification_round",
|
||
"status": "已恢复"
|
||
},
|
||
{
|
||
"capability": "session_context（Redis 短期上下文）",
|
||
"before": "无消费方",
|
||
"after": "有意不做：Agent 用的是 Worker 侧 request.history（MySQL 且按主体过滤，见 runtime._conversation_history）；恢复 Redis 双写只带来不一致与 TTL 成本。元数据中显式覆写为空元组",
|
||
"status": "有意放弃（留痕）"
|
||
},
|
||
{
|
||
"capability": "MySQL 历史回退读",
|
||
"before": "只按 session_id 取历史、跨主体可读（缺陷本体）",
|
||
"after": "不恢复旧实现；新链路走 ConversationRepository.messages(session_id, user_id, ...)（按 customer_id 过滤），与 Worker 侧同源同口径",
|
||
"status": "以新链路重写（F-01 前置满足）"
|
||
}
|
||
],
|
||
"deliverables": [
|
||
"app/core/customer_service_rules.py（新增 CHITCHAT_MESSAGES / CHITCHAT_PHRASES / is_chitchat_message / chitchat_streak）",
|
||
"app/service/agent_run_application_service.py（stored_request 脱敏、幂等哈希改用脱敏形状、build_outbox_metadata 恢复客服覆写、新增 _recent_user_messages）",
|
||
"app/service/agent/implementations/customer_service.py（E5a 改读 request.metadata.clarification_round）",
|
||
"tests/unit/service/test_agent_run_outbox_metadata.py（新建）",
|
||
"tests/unit/core/test_customer_service_rules.py（补闲聊判定与连续计数用例）"
|
||
],
|
||
"gates": {
|
||
"pytest": "6 failed, 1501 passed, 2 skipped（T0 基线 8/1440/2；上一轮 7/1482/2）",
|
||
"pytest_no_new_failures": true,
|
||
"pytest_fixed_relative_to_baseline": [
|
||
"tests/unit/tools/test_rbac_seed_consistency.py::test_permission_ids_are_consistent_between_seed_and_grant_scripts",
|
||
"tests/integration/test_agent_run_acceptance.py::test_customer_service_accept_redacts_sensitive_message_before_persistence"
|
||
],
|
||
"pytest_remaining_failures_are_baseline_subset": [
|
||
"tests/integration/test_compliance_seed_mysql.py x4",
|
||
"tests/integration/test_profile_snapshot_current_invariant_mysql.py",
|
||
"tests/integration/test_worker_runtime_mysql.py::test_http_accept_worker_commit_query_and_repeat[False]"
|
||
],
|
||
"ruff": "Found 22 errors（与 T0 基线逐项相同）",
|
||
"ruff_changed_files": "All checks passed",
|
||
"mypy": "Found 3 errors in 3 files (checked 231 source files)——与基线 3 项逐项相同，均不在本次改动文件内",
|
||
"check_authoritative_docs": "checked 50 documents, no number collision",
|
||
"audit_schema": "schema audit passed: 89 business tables, no missing or unexpected tables"
|
||
},
|
||
"chitchat_streak_spotcheck": {
|
||
"streak(['你好','谢谢','再见'], '哈喽')": 4,
|
||
"streak(['你好','费率是多少'], '哈喽')": 1,
|
||
"streak([], '费率是多少')": 0,
|
||
"streak(5 x chitchat, '你好')": 5,
|
||
"is_chitchat('你好吗')": false,
|
||
"note": "「你好吗」不是词表成员：一期就是精确匹配，未放宽成前缀匹配"
|
||
},
|
||
"docs_writeback": [
|
||
"开发文档/D1.6-...md 新增 §4.10 第六轮会话记录",
|
||
"客服agent/D2.1-客服Agent执行Todolist.md 新增 v5.7 修订要点",
|
||
"group_fqcd_jr/docs/customer-service-routing-legacy-keywords.md 新增 §六 词表最终落点"
|
||
],
|
||
"open_items": [
|
||
"E2 计算型出口（H-02）未实现",
|
||
"E4 证据约束生成（H-03）未实现",
|
||
"合规种子未跑：agent_negative_word / agent_reply_template 均 0 行 active（C-05 / C-06）",
|
||
"prompt_template_version.customer_service_chitchat 的 system_prompt 仍写旧品牌「南方财富」",
|
||
"P0 拆级（硬级建单 / 凭据级不建单 + 求助问法放行）已批准，待在 C-03 落地",
|
||
"admin / advisor / operator 档位仍收敛为 {public}，待裁定"
|
||
],
|
||
"honesty": "6 项失败全部是 T0 基线失败的子集，无新增；E2/E4 未实现，属能力缺口而非完成。"
|
||
} |