---
feature_id: FEAT-202606-006-agent-semantic-interaction
title: Agent 语义交互与命令治理
status: designing
owner: 医梦研发团队
created_at: 2026-06-29
updated_at: 2026-07-02
tags:
  - Agent
  - SemanticResponse
  - Command Runtime
  - Presentation
  - FastGPT
---

# Agent 语义交互与命令治理

## 目标

将 AI 中台从“卡片串联 Agent 流程”调整为“任务状态、可信工具结果和受控命令驱动”，
保留卡片的可读性与交互效率，同时解除卡片 JSON 对模型推理、查询和异常处理的约束。

## 优先级结论

本专题是后续批量建设智能体的中台前置能力，优先级高于新增业务智能体。现有
`cardKey/cardData/nextCard` 同时承担输出协议、流程推进和状态判断；如果先按该模式扩展智能体，
后续必须逐个迁移 Agent 工作流、后端编排、终端交互和测试，且新智能体的异常处理与工具规划仍会
被 Card Schema 限制。

因此，在本专题完成验收前：

1. 不按旧链式卡片模式新增或扩展业务智能体；
2. 挂号 Agent 仅作为查询、命令和可选展示的纵向验收样板；
3. 纯知识问答可以进行探索验证，但不得依赖旧卡片协议形成新的生产基线；
4. 达到 [迁移方案](迁移方案.md) 的“批量智能体建设准入门槛”后，再启动规模化智能体建设。

## 架构图

- 改造前：[PNG](assets/agent-architecture-before.png) /
  [SVG](assets/agent-architecture-before.svg) /
  [Excalidraw](assets/agent-architecture-before.excalidraw)
- 改造后：[PNG](assets/agent-architecture-after.png) /
  [SVG](assets/agent-architecture-after.svg) /
  [Excalidraw](assets/agent-architecture-after.excalidraw)

## 文档索引

| 类型 | Doc ID | 文档 | 状态 |
|---|---|---|---|
| 需求录入 | `INT-202606-001` | [需求录入](需求录入.md) | approved |
| 需求 | `PRD-202606-002` | [需求文档](需求文档.md) | approved |
| 概要设计 | `ODS-202606-002` | [概要设计](概要设计.md) | approved |
| 详细设计 | `DDS-202606-004` | [详细设计](详细设计.md) | approved |
| 接口 | `API-202606-004` | [接口说明](接口说明.md) | reviewing |
| 迁移设计 | `DES-202606-003` | [迁移方案](迁移方案.md) | approved |
| 开发进度 | `DEV-202607-001` | [开发进度](开发进度.md) | draft |
| 测试计划 | `TST-202606-001` | [测试计划](测试计划.md) | reviewing |
| 评审记录 | `MTG-202606-002` | [设计交叉评审记录](meeting-notes/设计交叉评审记录.md) | reviewing |
| ADR | `ADR-202606-001` | [从卡片流程迁移到语义响应与命令治理](../../adr/ADR-202606-001-semantic-response-command-runtime.md) | approved |
| OpenAPI | 不适用 | [开放平台接口 v2](../../api/openapi/医梦AI中台开放平台接口-v2.openapi.yaml) | approved |

## 关联专题

- `FEAT-202606-001-unified-entry-client`：原链式卡片挂号方案，被本专题替代。
- `FEAT-202606-002-fastgpt-integration`：首期唯一正式支持的 Agent 引擎接入基线。
- `FEAT-202606-003-sqlite-his-mock-mcp-tools`：挂号纵向样板的 Mock HIS/MCP 工具来源。

## 关联代码模块

- `emoon-openplatform`
- `emoon-ai-agent`
- `emoon-ai-card`（后续迁移为 `emoon-ai-command`）
- `emoon-ai-mcp`
- `emoon-ai-device`
- `emoon-system`
- `emoon-terminal-client`（外部工程）

## 关联决策

- `ADR-202606-001`

## 当前阶段

当前已完成核心需求、设计、ADR、迁移方案与 OpenAPI 的评审确认，接口说明和测试计划仍处于观察/确认阶段。
按照 `MTG-202606-002` 的结论，专题已创建 [开发进度](开发进度.md)，先启动阶段零 FastGPT 能力验证和阶段一查询链任务规划；阶段零未通过前，不进入命令链和 v2 切换。

进入开发前必须完成：

1. 记录目标 FastGPT 部署版本、工具事件格式和阶段零验证结论；
2. 后端、终端和 FastGPT 联调方确认 `API-202606-004`；
3. 开发和测试共同确认 `TST-202606-001`。

## 流程裁剪

| 阶段 | 是否跳过 | 原因 | 风险 | 替代记录 |
|---|---|---|---|---|
| 需求录入 | 否 | 已补齐 | 无 | `INT-202606-001` |
| 需求文档 | 否 | 已补齐 | 无 | `PRD-202606-002` |
| 概要设计 | 否 | 跨模块架构变更 | 无 | `ODS-202606-002` |
| 详细设计 | 否 | 涉及数据、状态机、接口和安全 | 无 | `DDS-202606-004` |
| ADR | 否 | 改变长期模块与接口边界 | 无 | `ADR-202606-001` |
| 接口契约 | 否 | v2 为破坏性接口升级 | 无 | `API-202606-004` |
| 开发进度 | 否 | 已按评审结论启动阶段零验证与阶段一任务规划 | 阶段零未通过则不进入查询链实现 | `DEV-202607-001` |
| 测试结果 | 是 | 尚未实施和执行测试 | 不能声明已完成 | 实施验收后创建 |

## 下一步

按 [开发进度](开发进度.md) 先执行阶段零 FastGPT 能力验证；通过后进入阶段一查询链实现，
再按 [迁移方案](迁移方案.md) 继续推进命令链、可选展示和 v2 单次切换。