ai-robot-core/spec/mid-agent-runtime-hardening/tasks.md

61 lines
3.4 KiB
Markdown
Raw Permalink Normal View History

# 中台智能体运行时加固MARH任务清单
## Phase 1护栏与超时口径统一
- [x] T-MARH-01 在 `respond` 主流程接入输出护栏强制执行关联AC-MARH-01
- [x] T-MARH-02 护栏触发信息写入 trace 与审计日志关联AC-MARH-02
- [x] T-MARH-03 统一 ReAct 循环上限到 3~5关联AC-MARH-07
- [x] T-MARH-04 统一单工具超时 <=2000ms关联AC-MARH-08
- [x] T-MARH-05 统一全链路超时 <=8000ms 并降级关联AC-MARH-09
## Phase 2打断语义与 KB 默认工具链
- [x] T-MARH-06 实现 interrupted_segments 重规划输入处理关联AC-MARH-03
- [x] T-MARH-07 实现中断异常兜底逻辑关联AC-MARH-04
- [x] T-MARH-08 在 Agent 模式接入默认 KB 检索工具调用关联AC-MARH-05
- [x] T-MARH-09 实现 KB 失败时可观测降级路径关联AC-MARH-06
## Phase 3拟人分段与观测闭环
- [x] T-MARH-10 实现分段策略组件(语义/长度切分关联AC-MARH-10
- [x] T-MARH-11 实现 delay 策略租户化配置关联AC-MARH-11
- [x] T-MARH-12 补齐运行时观测字段与统计关联AC-MARH-12
## Phase 4KB 动态检索工具(元数据驱动)
- [x] T-MARH-13 实现 MetadataFilterBuilder 组件关联AC-MARH-05
- [x] T-MARH-14 实现 kb_search_dynamic 工具并注册到 ToolRegistry关联AC-MARH-05/06
- [x] T-MARH-15 在 Agent 主链路集成 kb_search_dynamic 工具关联AC-MARH-05
- [x] T-MARH-16 添加 KbSearchDynamicResult 数据模型关联AC-MARH-05/06
## Phase 5高风险检测工具元数据驱动
- [x] T-MARH-17 实现 HighRiskCheckTool 工具元数据驱动关联AC-IDMP-05/20
- [x] T-MARH-18 添加 HighRiskCheckResult 数据模型关联AC-IDMP-05/20
- [x] T-MARH-19 注册 high_risk_check 工具到 ToolRegistry关联AC-IDMP-05
- [x] T-MARH-20 在 dialogue 主链路集成 high_risk_check高风险优先关联AC-IDMP-05/20
- [x] T-MARH-21 更新 policy_router 支持高风险检测结果关联AC-IDMP-05/20
## 验收关卡DoD
- [x] openapi.provider.yaml 达到 L2 并可契约测试
- [x] 所有 AC 在 requirements/openapi/design/tasks 可追踪
- [x] 仅中台范围,不引入渠道侧实现耦合
## 实现文件清单
| 文件 | AC 关联 | 说明 |
|------|---------|------|
| `services/mid/output_guardrail_executor.py` | AC-MARH-01/02 | 输出护栏强制执行器 |
| `services/mid/interrupt_context_enricher.py` | AC-MARH-03/04 | 中断上下文增强器 |
| `services/mid/default_kb_tool_runner.py` | AC-MARH-05/06 | KB 默认工具执行器 |
| `services/mid/metadata_filter_builder.py` | AC-MARH-05 | 元数据过滤器构建器 |
| `services/mid/kb_search_dynamic_tool.py` | AC-MARH-05/06 | KB 动态检索工具 |
| `services/mid/high_risk_check_tool.py` | AC-IDMP-05/20 | 高风险检测工具(元数据驱动) |
| `services/mid/segment_humanizer.py` | AC-MARH-10/11 | 分段拟人化组件 |
| `services/mid/runtime_observer.py` | AC-MARH-12 | 运行时观测器 |
| `services/mid/timeout_governor.py` | AC-MARH-08/09 | 超时治理(已更新) |
| `services/mid/policy_router.py` | AC-IDMP-02/05/16/20 | 策略路由器(已更新支持高风险检测) |
| `api/mid/dialogue.py` | AC-MARH-01~12, AC-IDMP-05/20 | 主入口(已集成高风险检测) |
| `models/mid/schemas.py` | AC-MARH-05/11/12, AC-IDMP-05/20 | 数据模型(已更新) |