MerCry
/
ai-robot-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ai-robot-core/spec/intent-driven-mid-platform/requirements.md

7.3 KiB
Raw Blame History

feature_id title status version active_version version_history owners last_updated source
IDMP 意图驱动智能体中台改造（仅中台侧）需求规范 draft 0.3.0 0.2.0-0.3.0
version ac_range description
0.3.0 AC-IDMP-19~20 MCP/Tool Registry治理与高风险场景最小集显式化
version ac_range description
0.2.0 AC-IDMP-11~18 ReAct约束、记忆分层、工具治理与灰度回滚补充
version ac_range description
0.1.0 AC-IDMP-01~10 中台协议统一与智能编排首版
product
backend
2026-03-03
type ref
conversation 仅中台侧改造文档生成

意图驱动智能体中台改造（仅中台侧）（IDMP）

1. 背景与目标

  • 背景：当前中台能力与渠道协同语义不统一，打断重入、模式归因、护栏接管等关键路径缺少标准化契约。
  • 目标：建立中台统一响应协议、决策编排与治理框架，在不改动渠道实现细节的前提下提升稳定性与可观测性。
  • 非目标：不覆盖渠道发送实现、不覆盖管理端页面改造、不覆盖模型替换。

2. 模块边界（Scope）

  • 覆盖：中台会话响应、模式切换、消息上报、元数据检索、工具编排与记忆服务调用。
  • 不覆盖：渠道端 SegmentDispatcher/InterruptManager/DeliveredHistoryStore 具体实现。

3. 依赖盘点（Dependencies）

  • 渠道侧服务（请求入口与响应消费）
  • 元数据服务（KB/Intent/Flow/Prompt）
  • 记忆服务（recall/update）

4. 用户故事（User Stories）

  • [US-IDMP-01] 作为渠道调用方，我希望中台返回统一 segments[] + trace，以便稳定消费并做打断重入。
  • [US-IDMP-02] 作为平台治理方，我希望中台能基于策略选择 agent/micro_flow/fixed/transfer，以便平衡效果与合规。
  • [US-IDMP-03] 作为运维方，我希望关键链路有完整可观测字段和指标，以便快速归因与回滚。
  • [US-IDMP-04] 作为产品方，我希望高风险场景被微流程强接管，以避免不受控回复。
  • [US-IDMP-05] 作为架构方，我希望 Agent 运行有明确循环与超时上限，以避免时延失控。
  • [US-IDMP-06] 作为平台方，我希望记忆能力分层可管控，以提升连续会话质量。
  • [US-IDMP-07] 作为平台治理方，我希望 MCP/Tool Registry 被纳入统一注册与策略治理，以便工具扩展可控。
  • [US-IDMP-08] 作为业务方，我希望高风险场景最小集有明确口径，以便实施和验收一致。

5. 验收标准（Acceptance Criteria, EARS）

v0.1.0

  • [AC-IDMP-01] WHEN 渠道调用会话响应接口 THEN 中台 SHALL 返回 segments[]，每个分段包含 segment_id/text/delay_after。
  • [AC-IDMP-02] WHEN 中台返回会话响应 THEN 中台 SHALL 同时返回 trace.mode，且其值属于 agent|micro_flow|fixed|transfer。
  • [AC-IDMP-03] WHEN 请求包含已送达历史 THEN 中台 SHALL 仅基于已送达历史进行上下文推理，不依赖未送达内容。
  • [AC-IDMP-04] WHEN 会话处于发送中发生用户新输入 THEN 中台 SHALL 支持打断重入并以最新请求代际结果为准。
  • [AC-IDMP-05] WHEN 进入退款/投诉/隐私承诺/转人工等高风险场景 THEN 中台 SHALL 强制切换到 micro_flow 或 transfer。
  • [AC-IDMP-06] WHEN Agent 工具调用超时或失败 THEN 中台 SHALL 按策略降级到 fixed 或 transfer 并给出 fallback_reason_code。
  • [AC-IDMP-07] WHEN 中台执行一次响应 THEN 中台 SHALL 记录 session_id/request_id/generation_id/mode/intent/tool_calls/guardrail_triggered 等审计字段。
  • [AC-IDMP-08] WHEN 渠道上报人工或机器人消息 THEN 中台 SHALL 接收并落库，保证会话闭环数据完整。
  • [AC-IDMP-09] WHEN 渠道发起会话模式切换 THEN 中台 SHALL 更新会话模式状态并影响后续编排路径。
  • [AC-IDMP-10] WHEN 执行元数据检索 THEN 中台 SHALL 执行 intent -> target_kbs -> metadata_filter -> vector_search -> rerank 固定链路。

v0.2.0

  • [AC-IDMP-11] WHEN Agent 进入 ReAct 推理 THEN 中台 SHALL 限制循环次数在 3~5 次内，超限必须触发降级。
  • [AC-IDMP-12] WHEN 发生工具调用 THEN 中台 SHALL 约束单工具超时 ≤2s 且全链路超时 ≤8s。
  • [AC-IDMP-13] WHEN 进行记忆读取 THEN 中台 SHALL 在响应前执行 recall 并注入基础属性、事实记忆与偏好记忆。
  • [AC-IDMP-14] WHEN 一轮会话完成 THEN 中台 SHALL 异步执行记忆更新（含会话摘要），且不阻塞主响应。
  • [AC-IDMP-15] WHEN 中台调用工具 THEN 中台 SHALL 以结构化 tool_call/tool_result 记录参数摘要、耗时、结果与错误码。
  • [AC-IDMP-16] WHEN 意图置信度低或关键信息缺失 THEN 中台 SHALL 回退到 micro_flow 或 fixed，不得继续自由 Agent 输出。
  • [AC-IDMP-17] WHEN 系统进入灰度发布 THEN 中台 SHALL 支持按会话级开关启停 Agent 链路并支持回滚到传统链路。
  • [AC-IDMP-18] WHEN 采集运行指标 THEN 中台 SHALL 提供任务达成率、槽位完整率、误转人工率、无召回率、平均时延等指标。

v0.3.0

  • [AC-IDMP-19] WHEN 新增或调用工具能力（含 MCP 工具） THEN 中台 SHALL 通过统一 Tool Registry 完成注册、鉴权、超时策略、版本与启停治理，并将治理结果写入 trace/tool 日志。
  • [AC-IDMP-20] WHEN 判定高风险场景接管范围 THEN 中台 SHALL 以“退款/投诉升级/隐私与敏感承诺/转人工”作为最小强接管场景集，且该集合可配置但不得缺省为空。

6. 追踪映射（Traceability）

AC ID Endpoint 方法 operationId 备注
AC-IDMP-01 /mid/dialogue/respond POST respondDialogue 分段协议
AC-IDMP-02 /mid/dialogue/respond POST respondDialogue trace 模式
AC-IDMP-03 /mid/dialogue/respond POST respondDialogue 已送达历史
AC-IDMP-04 /mid/dialogue/respond POST respondDialogue 打断重入/代际
AC-IDMP-05 /mid/dialogue/respond POST respondDialogue 高风险接管
AC-IDMP-06 /mid/dialogue/respond POST respondDialogue 降级策略
AC-IDMP-07 /mid/dialogue/respond POST respondDialogue 审计观测
AC-IDMP-08 /mid/messages/report POST reportMessages 全量上报
AC-IDMP-09 /mid/sessions/{sessionId}/mode POST switchSessionMode 模式切换
AC-IDMP-10 /deps/metadata/query POST queryMetadata 元数据链路
AC-IDMP-11 /mid/dialogue/respond POST respondDialogue ReAct 循环上限
AC-IDMP-12 /mid/dialogue/respond POST respondDialogue 超时治理
AC-IDMP-13 /deps/memory/recall POST recallMemory 记忆读取
AC-IDMP-14 /deps/memory/update POST updateMemory 异步记忆更新
AC-IDMP-15 /mid/dialogue/respond POST respondDialogue 工具调用结构化记录
AC-IDMP-16 /mid/dialogue/respond POST respondDialogue 低置信度回退
AC-IDMP-17 /mid/dialogue/respond POST respondDialogue 灰度与回滚
AC-IDMP-18 /mid/dialogue/respond POST respondDialogue 运行指标输出
AC-IDMP-19 /mid/dialogue/respond POST respondDialogue MCP/Tool Registry 治理
AC-IDMP-20 /mid/dialogue/respond POST respondDialogue 高风险最小场景集