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

3.4 KiB
Raw Blame History

中台智能体运行时加固MARH任务清单

Phase 1护栏与超时口径统一

  • T-MARH-01 在 respond 主流程接入输出护栏强制执行关联AC-MARH-01
  • T-MARH-02 护栏触发信息写入 trace 与审计日志关联AC-MARH-02
  • T-MARH-03 统一 ReAct 循环上限到 3~5关联AC-MARH-07
  • T-MARH-04 统一单工具超时 <=2000ms关联AC-MARH-08
  • T-MARH-05 统一全链路超时 <=8000ms 并降级关联AC-MARH-09

Phase 2打断语义与 KB 默认工具链

  • T-MARH-06 实现 interrupted_segments 重规划输入处理关联AC-MARH-03
  • T-MARH-07 实现中断异常兜底逻辑关联AC-MARH-04
  • T-MARH-08 在 Agent 模式接入默认 KB 检索工具调用关联AC-MARH-05
  • T-MARH-09 实现 KB 失败时可观测降级路径关联AC-MARH-06

Phase 3拟人分段与观测闭环

  • T-MARH-10 实现分段策略组件(语义/长度切分关联AC-MARH-10
  • T-MARH-11 实现 delay 策略租户化配置关联AC-MARH-11
  • T-MARH-12 补齐运行时观测字段与统计关联AC-MARH-12

Phase 4KB 动态检索工具(元数据驱动)

  • T-MARH-13 实现 MetadataFilterBuilder 组件关联AC-MARH-05
  • T-MARH-14 实现 kb_search_dynamic 工具并注册到 ToolRegistry关联AC-MARH-05/06
  • T-MARH-15 在 Agent 主链路集成 kb_search_dynamic 工具关联AC-MARH-05
  • T-MARH-16 添加 KbSearchDynamicResult 数据模型关联AC-MARH-05/06

Phase 5高风险检测工具元数据驱动

  • T-MARH-17 实现 HighRiskCheckTool 工具元数据驱动关联AC-IDMP-05/20
  • T-MARH-18 添加 HighRiskCheckResult 数据模型关联AC-IDMP-05/20
  • T-MARH-19 注册 high_risk_check 工具到 ToolRegistry关联AC-IDMP-05
  • T-MARH-20 在 dialogue 主链路集成 high_risk_check高风险优先关联AC-IDMP-05/20
  • T-MARH-21 更新 policy_router 支持高风险检测结果关联AC-IDMP-05/20

验收关卡DoD

  • openapi.provider.yaml 达到 L2 并可契约测试
  • 所有 AC 在 requirements/openapi/design/tasks 可追踪
  • 仅中台范围,不引入渠道侧实现耦合

实现文件清单

文件 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 数据模型(已更新)