ai-robot-core/spec/intent-driven-mid-platform/tasks.md

意图驱动智能体中台改造（IDMP）- 任务清单

活跃版本：v0.2.0-0.3.0

---

Phase 1: 记忆服务增强（AC-IDMP-13/14）

Task-1.1: 记忆召回服务（AC-IDMP-13）⏳

验收标准: WHEN 进行记忆读取 THEN 中台 SHALL 在响应前执行 recall 并注入基础属性、事实记忆与偏好记忆

子任务:

• 1.1.1 创建 services/mid/memory_adapter.py - 记忆适配器
• 1.1.2 实现 RecallRequest / RecallResponse 数据模型
• 1.1.3 实现 recall(user_id, session_id) 方法，返回 profile/facts/preferences
• 1.1.4 集成到对话响应流程（响应前调用）
• 1.1.5 实现 recall 失败降级（不阻断主链路）

参考:

• openapi.deps.yaml - /deps/memory/recall
• services/memory.py - 现有 MemoryService

---

Task-1.2: 记忆更新服务（AC-IDMP-14）⏳

验收标准: WHEN 一轮会话完成 THEN 中台 SHALL 异步执行记忆更新（含会话摘要），且不阻塞主响应

子任务:

• 1.2.1 实现 update(user_id, session_id, messages, summary) 方法
• 1.2.2 创建异步任务队列（使用 asyncio.create_task）
• 1.2.3 实现会话摘要生成（可选，由中台异步生成后回写）
• 1.2.4 集成到对话响应流程（响应后异步调用）
• 1.2.5 添加错误处理与重试机制

参考:

• openapi.deps.yaml - /deps/memory/update

---

Phase 2: 工具调用治理（AC-IDMP-15/19）

Task-2.1: 工具调用结构化记录（AC-IDMP-15）⏳

验收标准: WHEN 中台调用工具 THEN 中台 SHALL 以结构化 tool_call/tool_result 记录参数摘要、耗时、结果与错误码

子任务:

• 2.1.1 创建 models/mid/tool_trace.py - ToolCallTrace 数据模型
• 2.1.2 实现 ToolCallRecorder 服务
• 2.1.3 记录字段：tool_name, tool_type, registry_version, auth_applied, duration_ms, status, error_code, args_digest, result_digest
• 2.1.4 集成到 TraceInfo 输出
• 2.1.5 实现敏感参数脱敏（args_digest）

参考:

• openapi.provider.yaml - ToolCallTrace schema

---

Task-2.2: Tool Registry 治理（AC-IDMP-19）⏳

验收标准: WHEN 新增或调用工具能力（含 MCP 工具） THEN 中台 SHALL 通过统一 Tool Registry 完成注册、鉴权、超时策略、版本与启停治理，并将治理结果写入 trace/tool 日志

子任务:

• 2.2.1 创建 services/mid/tool_registry.py - 工具注册表
• 2.2.2 实现 ToolDefinition 数据模型（name, type, version, timeout_ms, auth_required, is_enabled）
• 2.2.3 实现 register_tool() - 工具注册
• 2.2.4 实现 authorize_tool() - 工具鉴权
• 2.2.5 实现 get_timeout_policy() - 超时策略获取
• 2.2.6 实现 is_tool_enabled() - 启停状态检查
• 2.2.7 创建数据库表 tool_registry（可选，支持动态配置）
• 2.2.8 集成 MCP 工具支持

参考:

• openapi.provider.yaml - TraceInfo.tools_used, ToolCallTrace

---

Phase 3: 测试与验证

Task-3.1: 单元测试 ⏳

覆盖路径:

• 成功路径：正常 recall/update，工具调用成功
• 超时路径：recall 超时降级，工具调用超时
• 错误路径：recall 失败降级，工具调用错误
• 降级路径：记忆服务不可用时继续主链路

测试文件:

• tests/test_memory_adapter.py
• tests/test_tool_registry.py
• tests/test_tool_call_recorder.py

---

依赖关系

Task-1.1 (recall) ──┐
                    ├──> Task-1.2 (update) ──> Task-3.1 (tests)
Task-2.1 (trace) ───┘
        │
        └──> Task-2.2 (registry) ──> Task-3.1 (tests)

---

变更文件清单

文件路径	状态	关联 AC
services/mid/__init__.py	待创建	-
services/mid/memory_adapter.py	待创建	AC-IDMP-13/14
services/mid/tool_registry.py	待创建	AC-IDMP-19
services/mid/tool_call_recorder.py	待创建	AC-IDMP-15
models/mid/__init__.py	待创建	-
models/mid/memory.py	待创建	AC-IDMP-13/14
models/mid/tool_trace.py	待创建	AC-IDMP-15
models/mid/tool_registry.py	待创建	AC-IDMP-19
tests/test_memory_adapter.py	待创建	AC-IDMP-13/14
tests/test_tool_registry.py	待创建	AC-IDMP-19
tests/test_tool_call_recorder.py	待创建	AC-IDMP-15