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