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

61 lines
3.4 KiB
Markdown
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.

# 中台智能体运行时加固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 | 数据模型(已更新) |