Files
group_fqcd_jr/docs/evidence/20260919-t3a-h02a-calc-param-layer.json
张胜宇 5d0becb67d 客服 Agent 重构收口:五出口决策链 + 知识库档位隔离 + 前端入参边界(答辩演示版本)
一、客服 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 生成的本地产物
2026-09-20 14:33:30 +08:00

205 lines
6.1 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"evidence_id": "20260919-t3a-h02a-calc-param-layer",
"step": "H-02a:计算型出口 E2 的**参数层**(纯函数 + 真实语料回归),出口接线留待 H-02b",
"why_split": "申购费算法存在「语料口径 vs D3.7 D-01 判据」冲突,而算法文字会**原样进客户答案**;先定口径再接线,避免接线返工",
"artifacts": {
"app/core/fund_fee_rules.py": {
"bytes": 20985,
"sha256_16": "0fb29ab2d214afc3",
"kind": "纯函数;不 import 模型/数据库/Agent(DoD ②)"
},
"tests/unit/core/test_fund_fee_rules.py": {
"bytes": 9737,
"tests": 41
}
},
"corpus_derived_params": {
"fee_table_categories": [
"货币基金",
"纯债基金",
"混合基金",
"股票基金",
"QDII 基金"
],
"by_category": {
"货币基金": {
"purchase_rates": {
"申购费率(原费率)": 0.0,
"申购费率(官方直销 1 折)": 0.0
},
"redemption_at": {
"5": 0.0,
"20": 0.0,
"240": 0.0,
"365": 0.0,
"540": 0.0,
"730": 0.0
}
},
"纯债基金": {
"purchase_rates": {
"申购费率(原费率)": 0.008,
"申购费率(官方直销 1 折)": 0.0008
},
"redemption_at": {
"5": 0.015,
"20": 0.0075,
"240": 0.001,
"365": 0.0,
"540": 0.0,
"730": 0.0
}
},
"混合基金": {
"purchase_rates": {
"申购费率(原费率)": 0.015,
"申购费率(官方直销 1 折)": 0.0015
},
"redemption_at": {
"5": 0.015,
"20": 0.0075,
"240": 0.005,
"365": 0.0025,
"540": 0.0025,
"730": 0.0
}
},
"股票基金": {
"purchase_rates": {
"申购费率(原费率)": 0.015,
"申购费率(官方直销 1 折)": 0.0015
},
"redemption_at": {
"5": 0.015,
"20": 0.0075,
"240": 0.005,
"365": 0.0025,
"540": 0.0025,
"730": 0.0
}
},
"QDII 基金": {
"purchase_rates": {
"申购费率(原费率)": 0.016,
"申购费率(官方直销 1 折)": 0.0016
},
"redemption_at": {
"5": 0.015,
"20": 0.005,
"240": 0.005,
"365": 0.0025,
"540": 0.0025,
"730": 0.0
}
}
},
"stock_purchase_fee_range": [
0.0015,
0.015
],
"suitability_matrix": {
"C1": {
"R1": "allow",
"R2": "allow",
"R3": "forbidden",
"R4": "forbidden",
"R5": "forbidden"
},
"C2": {
"R1": "allow",
"R2": "allow",
"R3": "allow",
"R4": "forbidden",
"R5": "forbidden"
},
"C3": {
"R1": "allow",
"R2": "allow",
"R3": "allow",
"R4": "disclosure",
"R5": "forbidden"
},
"C4": {
"R1": "allow",
"R2": "allow",
"R3": "allow",
"R4": "allow",
"R5": "disclosure"
},
"C5": {
"R1": "allow",
"R2": "allow",
"R3": "allow",
"R4": "allow",
"R5": "allow"
}
},
"D04_verdict_C1_R3": "forbidden",
"assert_D04_is_forbidden": true
},
"golden_resolvability": {
"D-01": {
"message": "买 10 万股票基金,申购费大概多少?",
"category": "股票基金",
"amount_yuan": 100000,
"range": [
0.0015,
0.015
]
},
"D-02": {
"message": "我持有 20 天赎回混合基金,赎回费多少?",
"category": "混合基金",
"holding_days": 20,
"rate": 0.0075
},
"D-03": {
"message": "持有 8 个月赎回要付费吗?",
"holding_days": 240,
"rate_mixed": 0.005
},
"D-04": {
"message": "我是 C1,能买 R3 的产品吗?",
"verdict": "forbidden",
"expected": "forbidden"
},
"D-05": {
"message": "南方基金客服现在方便联系吗?",
"is_fee_question": false,
"note": "非计算型 → 仍走知识出口(E3),本模块不接管"
}
},
"decisions_pending": [
{
"id": "H-02-D1",
"topic": "申购费算法口径冲突",
"evidence": "D6.2.1 §6.3 示例 1:100,000 × 1.50% = 1,500 元(内扣式,费率乘总额);D3.7 D-01 判据:申购费 = 金额 × 费率 ÷ (1+费率)(外扣式,同组数 = 1,477.83 元)。全语料检索「净申购/外扣/1+费率」→ 0 命中,外扣式**只存在于 D3.7 判据本身**",
"current_impl": "按语料口径(INV-2:数字必须可解析到 chunk)",
"options": [
"A 改语料为外扣法(需重建切片 + 重灌集合)",
"B 改 D3.7 D-01 判据为语料口径(1 处文档改动)"
],
"recommendation": "建议 B(今天可做、零重建);答辩后再考虑 A"
},
{
"id": "H-02-D2",
"topic": "语料内部费率不一致",
"evidence": "单只产品 1.6「南方红利价值股票」赎回费原文『持有<7 天:1.5%;7—365 天:0.50%;1—2 年:0.25%;>2 年:0』⇒ 7—30 天档 = 0.50%;§6.1 总表股票列 7—30 天 = 0.75%。解析器给出 lower_days=[0, 7, 365, 730]",
"impact": "按类别问(D-02/D-03)走总表,不受影响;按**单只产品**问 1.6 会答 0.50%,与总表冲突",
"options": [
"A 改产品 1.6 的 7—365 天为 7—30 天 0.75% + 30—365 天 0.50%",
"B 保留并登记"
],
"recommendation": "建议 A(一处语料行,改完同样需重建;也可与 D1 的重建合成一次)"
}
],
"gates": {
"ruff(app tests tools)": 22,
"mypy(app)": 3,
"pytest_full": "2 failed / 1635 passed / 2 skipped",
"pytest_baseline": "2 failed / 1594 passed / 2 skipped",
"delta": "+41 passed = 本轮新增单测,2 failed 与基线同一组",
"pytest_targeted_new_file": "41 passed"
}
}