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 限制。

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

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

架构图

改造前：PNG / SVG / Excalidraw
改造后：PNG / SVG / Excalidraw

文档索引

类型	Doc ID	文档	状态
需求录入	`INT-202606-001`	需求录入	approved
需求	`PRD-202606-002`	需求文档	approved
概要设计	`ODS-202606-002`	概要设计	approved
详细设计	`DDS-202606-004`	详细设计	approved
接口	`API-202606-004`	接口说明	reviewing
迁移设计	`DES-202606-003`	迁移方案	approved
开发进度	`DEV-202607-001`	开发进度	draft
测试计划	`TST-202606-001`	测试计划	reviewing
评审记录	`MTG-202606-002`	设计交叉评审记录	reviewing
ADR	`ADR-202606-001`	从卡片流程迁移到语义响应与命令治理	approved
OpenAPI	不适用	开放平台接口 v2	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 的结论，专题已创建开发进度，先启动阶段零 FastGPT 能力验证和阶段一查询链任务规划；阶段零未通过前，不进入命令链和 v2 切换。

进入开发前必须完成：

记录目标 FastGPT 部署版本、工具事件格式和阶段零验证结论；
后端、终端和 FastGPT 联调方确认 API-202606-004；
开发和测试共同确认 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`
测试结果	是	尚未实施和执行测试	不能声明已完成	实施验收后创建

下一步

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

专题索引.md 5.0 KB Cronologia Originale