doc_id: DDS-202606-002 feature_id: FEAT-202606-002-fastgpt-integration type: detailed-design title: 医梦 AI 中台接入 FastGPT 设计与技术方案 status: reviewing owner: 医梦研发团队 created_at: 2026-06-13 updated_at: 2026-06-13 reviewers: [] related_docs:

ODS-202606-001 related_modules:
emoon-openplatform
emoon-ai-agent
emoon-ai-mcp
emoon-ai-file tags:
FastGPT
Agent Adapter
MCP Gateway
知识库 ---

医梦 AI 中台接入 FastGPT 设计与技术方案

项目	内容
文档定位	公司评审版设计 + 技术方案
适用范围	医梦 AI 开放平台、AI Agent、FastGPT Adapter、MCP Gateway、Card Runtime、File Service、知识库运行副本、计量审计
目标读者	公司管理层、商务谈判团队、架构评审人员、后端开发、初级工程师
FastGPT 源码基线	`/Users/destiny/dev/emoon/projects/FastGPT`，本地 checkout `ga6885b339`（基于 `v4.15.0-beta`，上游 `Latest` 稳定 release 为 `v4.14.24`；另有 `v4.15.0-beta4` 预发布）
emoon 工程基线	Java 17 / Spring Boot 3 / Maven 多模块，AI 能力按 `emoon-ai-*` 分层模块落位
版本	v2.0
更新时间	2026-06-13

0. 阅读结论

本方案的核心结论是：

FastGPT 可以作为医梦 AIAgent 的实现层之一接入，
但不能替代医梦 AI 中台，也不能成为医院业务系统的入口。

正确架构是：

外部入口 / 终端 / 医生端 / 患者端 / 医院系统
        ↓
医梦 OpenPlatform + 医疗智能体应用控制层
        ↓
医梦 FastGPT Adapter
        ↓
FastGPT AI 能力层

错误架构是：

外部入口 / 医生端 / 患者端 / HIS / LIS / EMR / 设备
        ↓
FastGPT

FastGPT 在本项目中的定位是“后方 AI 能力底座”，主要承接：

LLM 生成；
Workflow 子流程；
RAG 检索；
OCR / 多模态理解；
Embedding / Rerank；
知识库运行副本；
AI 调用日志和资源消耗数据。

医梦必须保留并强化：

外部入口和统一鉴权；
医疗场景路由；
任务状态机；
卡片运行时；
医梦 MCP Gateway；
HIS / LIS / EMR / PACS / 支付 / 叫号等医院系统适配；
文件源资产和敏感数据控制；
医生反馈闭环；
知识库源资产管理；
计量、账本、审计、合同和运营闭环。

1. 本文修正 Claude 初稿的关键点

Claude 初稿提供了有价值的方向，但有几处需要在公司评审前修正。

初稿说法	本文修正	原因
FastGPT 版本口径混用	本地 checkout `ga6885b339`，基于 `v4.15.0-beta`；上游 `Latest` 稳定 release 为 `v4.14.24`，另有 `v4.15.0-beta4` 预发布	文档必须同时标注本地源码基线、稳定版能力和 beta 能力差异
`~/dev/emoon/project/FastGPT`	`/Users/destiny/dev/emoon/projects/FastGPT`	实际目录为 `projects`，不是 `project`
Dify 尚未进入代码，切换成本极低	emoon 已存在 `DifyAgentEngine`、`DifyKnowledgeEngine`、Dify 意图识别和多处 `dify` 硬编码	切换不是零成本，需要双引擎并存和逐步迁移
FastGPT OpenAI-compatible，可直接复用 DirectLLM 协议	只能复用部分请求/流式解析思想，不能完全当作 OpenAI API	FastGPT `model/temperature` 等参数由编排决定，API 参数不按 OpenAI 语义生效
FastGPT `usage` 可直接用于计量	不可信任默认 `usage`	v1 接口默认 `usage` 为占位值，需要 `detail=true.responseData` 或日志归集
FastGPT 社区版能力完整	必须区分社区版、商业版、云服务版	运行日志看板、应用评测、内容审核、SSO、多租户等能力与商业版相关
很多 emoon 模块无需修改	对外入口不改，但知识库、意图识别、引擎配置、计量归集、健康探活都需要适配	当前代码存在 Dify 语义绑定

2. 背景与决策问题

2.1 业务背景

甲方本周明确提出希望底层 AI 中台替换为 FastGPT。考虑到 FastGPT 与 Dify 都提供通用 AI 应用构建、Workflow、RAG、工具调用和模型编排能力，医梦不能把二期和三期规划整体推倒重来。

更合理的理解是：

Dify / FastGPT / DirectLLM / Mock
都是 AgentEngine 的实现层。
医梦 AI 中台的医疗业务控制层不能被替换。

2.2 评审要回答的问题

本方案需要回答四类问题：

FastGPT 现有能力是什么，哪些能力可用，哪些能力有版本或商业限制；
Dify 与 FastGPT 在产品、工程接入、医疗业务闭环上的差异；
相比原 Dify 规划，接入 FastGPT 会产生哪些限制和新问题；
emoon 应如何分阶段接入 FastGPT，并控制风险、边界和工程复杂度。

2.3 总体建议

建议采用“FastGPT 主接入 + Dify 过渡保留”的策略：

新增 engineType=fastgpt，不要删除 engineType=dify；
新项目优先验证 FastGPT；
已经跑通的 Dify 链路不立即强拆；
管理后台、Agent 配置、知识库配置、意图识别配置逐步从硬编码 dify 改为可配置引擎；
计量、审计、卡片、文件和 MCP 网关坚持由 emoon 控制。

3. FastGPT 能力全景

本节基于本地 FastGPT 源码和文档目录校准，不默认把商业版能力算入 P0。

3.1 产品定位

FastGPT 是一个 AI 应用构建平台，核心能力包括：

应用编排；
智能体对话；
Workflow；
知识库；
MCP 工具集；
HTTP 工具集；
OpenAPI 调用；
分享和嵌入；
模型配置；
部署运维。

技术栈：

Node.js / TypeScript；
Next.js；
MongoDB；
Docker / Sealos 部署体系。

3.2 应用类型

本地源码中 AppTypeEnum 关键值如下：

类型	源码枚举值	说明	emoon 用法
简易对话	`simple`	FAQ、普通问答	P0 可用
对话智能体	`chatAgent`	带工具和上下文的对话	P0 可用
Workflow	`advanced`	高级编排	P0/P1 主能力
Workflow Tool	`plugin`	可复用插件流程	P1 可用
MCP ToolSet	`toolSet`	MCP 工具集	P1 重点验证
HTTP ToolSet	`httpToolSet`	HTTP 工具集	P1/P2 可选
文件夹	`folder` / `toolFolder`	管理组织结构	管理后台可见

初级工程师注意：

FastGPT 的 workflow 类型在源码枚举中叫 advanced。
不要只看 UI 文案写死字符串。

3.3 对话能力

核心接口：

POST /api/v1/chat/completions
POST /api/v2/chat/completions
POST /api/v2/chat/stop

本文 P0 建议先接 v1，原因是现有文档和源码中的兼容性说明更充分。后续可在 P1 评估 v2。

v1 请求关键字段：

{
  "chatId": "emoon-conversation-id",
  "stream": true,
  "detail": true,
  "responseChatItemId": "emoon-message-id",
  "variables": {
    "traceId": "trace_xxx",
    "sceneCode": "OUTPATIENT_TRIAGE"
  },
  "messages": [
    {
      "role": "user",
      "content": "我头疼应该挂什么科"
    }
  ]
}

重要差异：

点	说明	emoon 影响
`model`	FastGPT v1 文档说明 `model` 等参数无效，实际应用由鉴权和编排决定	不要用 `model` 表达 FastGPT App ID 的唯一来源
`temperature`	由 FastGPT 编排配置决定	emoon 不应在运行时假设可覆盖
`chatId`	不传时不使用 FastGPT 上下文；传入时 FastGPT 会按 chatId 取历史	emoon 应传自己的会话 ID 或映射 ID
`detail`	返回节点执行过程和 responseData	计量、审计、调试建议开启或按环境开启
`usage`	v1 默认响应里可能是占位值	不能直接入账

3.4 流式 SSE 能力

FastGPT stream=true 时返回 SSE。普通增量类似：

data: {"choices":[{"delta":{"content":"您"},"finish_reason":null}]}
data: {"choices":[{"delta":{"content":"好"},"finish_reason":null}]}
data: [DONE]

当 detail=true 时，还会出现流程节点结果事件。emoon 需要做两层归一化：

FastGPT SSE → AgentResponse；
AgentResponse → OpenPlatform 对外 SSE 事件。

emoon 对外仍保持：

message_delta
message_completed
journey_updated
task_updated
card_created
completed
error

FastGPT 原始 SSE 事件不能直接暴露给终端厂商。

3.5 知识库能力

FastGPT 知识库能力包括：

创建知识库；
查询知识库列表和详情；
文件集合管理；
文档导入；
分段管理；
检索测试；
训练订单；
图片和多模态相关增强能力。

需要区分版本：

能力	社区版	商业版/云服务版	emoon 建议
基础知识库	支持	支持	P1 可接
文档导入	支持	支持	P1 可接
知识库索引增强	受限	支持	不作为 P0 承诺
Web 站点同步	受限	支持	不作为 P0 承诺
第三方知识库同步	受限	支持	商务确认后再排期
图片知识库	受限	支持	医疗影像/舌象不能直接依赖

医梦的原则：

emoon 保存知识库源资产。
FastGPT 保存运行副本。
医生反馈先进入 emoon，再决定是否更新 FastGPT 知识库。

3.6 MCP 能力

FastGPT 源码中 packages/service/core/app/mcp.ts 使用：

@modelcontextprotocol/sdk；
StreamableHTTPClientTransport；
SSEClientTransport；
listTools；
callTool；
工具调用超时约 300 秒；
isInternalAddress() 内网地址防护；
JSON Schema $ref 解析时禁用 file/http，降低 SSRF 风险。

这是 FastGPT 相比 Dify 的重要优势，但也带来边界风险。

医梦规定：

FastGPT MCP Client 只能连 emoon MCP Gateway。
FastGPT 不能直接连 HIS / LIS / EMR / PACS / 支付 / 叫号 / 设备平台。

3.7 版本能力

FastGPT 源码存在：

/api/core/app/version/list
/api/core/app/version/publish
/api/core/app/version/detail
/api/core/app/version/latest
/api/core/app/version/update

能力可用于版本列表、发布、详情、最新版本和更新。但 emoon 不应完全依赖 FastGPT 作为医疗场景版本事实源。

emoon 需要额外保存：

agentId；
fastgptAppId；
fastgptVersionId；
FastGPT App 快照；
emoon 输出 Schema 版本；
生效状态；
灰度策略；
回滚指针。

3.8 运营和日志能力

FastGPT 可提供应用运行数据和模型调用数据，但公司评审要注意：

能力	风险
运行日志看板	商业版能力，不应默认进入 P0
应用评测	商业版/云服务版能力更完整
内容审核	商业版能力，不应替代 emoon 医疗安全规则
模型日志	可用于辅助对账，但不能替代 emoon 计量账本
用户反馈	可用作辅助标注，但医生反馈主链路必须在 emoon

3.9 emoon 主调用 FastGPT API 清单

完整 FastGPT route 明细见附录 A。正文只保留 emoon 需要纳入架构评审、接口设计和工程排期的主调用接口族；这些接口必须经由 FastGPT Adapter 封装，业务模块不得直接散落调用 FastGPT。

功能域	接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
对话运行	`POST /api/v1/chat/completions`	FastGPT OpenAI 风格主对话入口，支持同步/流式输出、`chatId`、`variables`、`detail` 等运行参数	是，P0	是，作为 `FastGptAgentEngine` 主入口
对话运行	`POST /api/v2/chat/completions`	v2 对话入口，能力随 FastGPT 版本演进，适合后续评估替换 v1	暂不 P0	否，先以 v1 稳定接入为准
对话运行	`POST /api/v2/chat/stop`	停止运行中的会话任务，用于前端取消生成或超时熔断	是，P1	需要，SSE/长任务体验完善后接入
对话详情	`POST /api/core/chat/getResData`	获取运行详情、节点响应、引用数据等，用于弥补默认 `usage` 占位问题	是，P0	是，计量、审计、问题排查必须使用
对话详情	`POST /api/core/chat/record/getResData`	按历史记录查询单次响应明细	是，P1	需要，用于医生反馈回放和审计抽查
对话记录	`POST /api/core/chat/getPaginationRecords`	查询会话分页记录	可选	当前不作为事实源，仅用于排查
对话记录	`POST /api/core/chat/record/getPaginationRecords`	查询记录级分页列表	可选	当前不作为事实源，仅用于后台诊断
对话恢复	`POST /api/core/chat/resume`	恢复中断的对话运行	可选	仅在 FastGPT 工作流存在人工中断/恢复场景时接入
文件上传	`POST /api/core/chat/file/presignChatFilePostUrl`	获取聊天文件上传预签名地址	谨慎对接	仅允许 emoon File Service 代办，医生端/患者端不得直传 FastGPT
文件下载	`POST /api/core/chat/file/presignChatFileGetUrl`	获取聊天文件下载预签名地址	谨慎对接	仅用于受控回放和审计，不作为长期文件地址
反馈	`POST /api/core/chat/feedback/updateUserFeedback`	写入用户反馈、点赞点踩或纠错信息	是，P1	需要，但医生反馈仍须先落 emoon 反馈表
应用详情	`POST /api/core/app/detail`	获取 FastGPT 应用完整配置详情	是，P0	是，用于配置校验和版本映射
应用信息	`POST /api/core/app/getBasicInfo`	获取应用基础信息	是，P0	是，用于健康检查和后台展示
应用权限	`POST /api/core/app/getPermission`	查询应用访问权限	是，P1	需要，用于发布前校验
应用列表	`GET /api/core/app/list`	查询应用列表	可选	管理后台可用，运行链路不依赖
应用版本	`GET /api/core/app/version/list`	查询应用版本列表	是，P0	是，支撑 emoon 版本映射和回滚
应用版本	`GET /api/core/app/version/detail`	查询指定应用版本详情	是，P0	是，发布审计和差异比对需要
应用版本	`GET /api/core/app/version/latest`	查询最新版本	是，P0	是，但不能自动替换 emoon 生效版本
应用发布	`POST /api/core/app/version/publish`	发布 FastGPT 应用版本	谨慎对接	仅允许 emoon 管理后台受控触发，不允许运营直接绕过版本映射
应用日志	`POST /api/core/app/logs/list`	查询应用运行日志	是，P1	需要，用于联调、灰度和线上问题定位
应用日志	`POST /api/core/app/logs/exportLogs`	导出应用日志	可选	审计导出场景需要，默认不进入 P0
MCP 工具	`POST /api/core/app/mcpTools/getTools`	查询应用可用 MCP 工具	是，P1	需要，用于验证 FastGPT 只能看到 emoon MCP Gateway 暴露的工具
MCP 工具	`POST /api/core/app/mcpTools/getChildren`	查询 MCP 工具子级/明细	是，P1	需要，用于工具权限巡检
MCP 工具	`POST /api/core/app/mcpTools/create`	在 FastGPT 内创建 MCP ToolSet 应用，绑定远端 MCP Server URL、请求头密钥和工具列表	是，P1	需要，但只能注册 emoon MCP Gateway 或其受控代理地址
MCP 工具	`POST /api/core/app/mcpTools/update`	更新 FastGPT MCP ToolSet 的 URL、密钥和工具列表	是，P1	需要，必须由 emoon 发布流程触发并记录版本
MCP 工具	`POST /api/core/app/mcpTools/runTool`	通过 FastGPT 临时调用远端 MCP 工具，常用于配置验证和调试	谨慎对接	当前只用于验收测试，不进入生产业务主链路
MCP Server	`GET /api/support/mcp/list`	查询 FastGPT 对外暴露的 MCP Server 配置	可选，P2	当前不作为医梦医疗工具入口，只用于评估 FastGPT 应用被外部调用
MCP Server	`POST /api/support/mcp/create`	将若干 FastGPT 应用包装成 MCP Server 工具对外暴露	可选，P2	非 P0；不能替代 emoon 医疗工具网关
MCP Server	`PUT /api/support/mcp/update`	更新 FastGPT MCP Server 名称和绑定应用列表	可选，P2	非 P0；如使用必须纳入版本审计
MCP Server	`DELETE /api/support/mcp/delete`	删除 FastGPT MCP Server 配置	可选，P2	非 P0
MCP Server	`POST /api/mcp/app/[key]/mcp`	FastGPT 提供的 MCP 协议端点，外部 MCP Client 可通过 key 调用被绑定的 FastGPT 应用工具	可选，P2	只适合把 FastGPT 应用暴露给 emoon 或内部工具，不面向医院系统
OpenAPI Key	`POST /api/support/openapi/create`	创建 FastGPT OpenAPI Key	谨慎对接	建议由部署/运维初始化，生产运行不频繁调用
OpenAPI Key	`GET /api/support/openapi/list`	查询 OpenAPI Key 列表	是，P1	需要，用于配置巡检和密钥轮换检查
健康探活	`GET /api/support/openapi/health`	OpenAPI 健康检查	是，P0	是，作为 Adapter 健康探活基础接口
知识库	`GET /api/core/dataset/list`	查询知识库列表	是，P0	是，用于运行副本映射和配置校验
知识库	`POST /api/core/dataset/create`	创建知识库	是，P1	需要，限管理后台/交付工具调用
知识库	`GET /api/core/dataset/detail`	查询知识库详情	是，P0	是，用于副本状态核验
知识库	`POST /api/core/dataset/update`	更新知识库配置	是，P1	需要，但必须由 emoon 知识资产发布流程触发
知识检索	`POST /api/core/dataset/searchTest`	对知识库执行检索测试	是，P1	需要，用于验收、召回质量评测和排障
知识集合	`POST /api/core/dataset/collection/create/fileId`	基于已上传文件创建知识集合	是，P1	需要，前提是文件先进入 emoon File Service 并完成脱敏/审计
知识集合	`POST /api/core/dataset/collection/list`	查询知识集合列表	是，P1	需要，用于同步状态和问题排查
知识分段	`POST /api/core/dataset/data/list`	查询知识分段数据	是，P1	需要，用于抽检、医生纠错和知识治理
训练队列	`GET /api/core/dataset/training/getDatasetTrainingQueue`	查询知识库训练队列	是，P1	需要，用于发布进度展示和失败重试
训练错误	`GET /api/core/dataset/training/getTrainingError`	查询训练错误	是，P1	需要，用于运维告警和交付排障
模型配置	`GET /api/core/ai/model/list`	查询 FastGPT 可用模型	是，P1	需要，用于环境验收，不作为业务模型事实源
模型测试	`POST /api/core/ai/model/test`	测试模型连通性	是，P1	需要，用于部署验收和健康诊断

对正文主调用接口的结论：P0 只覆盖对话主链路、应用版本映射、健康探活和知识库状态核验；P1 再补充文件受控流转、日志、反馈、训练队列、MCP ToolSet 注册、MCP 工具巡检和模型验收；FastGPT 自身的 MCP Server 暴露能力不进入医疗工具 P0，附录中大量用户、团队、市场、插件、初始化、迁移、商业版管理接口不应由 emoon 业务运行链路直接依赖。

3.10 emoon 调用 FastGPT 的功能价值评估

功能域	emoon 是否调用	优先级	调用价值	边界与注意事项
对话生成 `/v1/chat/completions`	是	P0	替代 Dify 承接 Agent 推理和 Workflow 子流程	只由 `FastGptAgentEngine` 调用，不暴露给终端
SSE 流式	是	P0	支撑统一入口客户端实时反馈	必须归一成 emoon SSE 事件
`detail=true.responseData`	是	P0	获取节点级用量和调试信息	默认 usage 不可信，需二次归集
应用详情/探活	是	P0/P1	验证 FastGPT App 和 API Key 可用	不作为业务配置事实源
应用版本	是	P1	支撑灰度、回滚、审计	emoon 仍保存版本映射和快照
应用日志	可选	P1	traceId 排障和计量对账辅助	不能替代 emoon 审计
知识库 CRUD	是	P1	同步知识库运行副本	emoon 保存源资产，FastGPT 只运行检索副本
知识库检索测试	是	P1	验证 RAG 效果	不直接面向医院用户
MCP 工具集	可选	P1	验证 FastGPT 能调用 emoon MCP Gateway	不允许连接医院原始系统
OpenAPI Key 管理	可选	P1	交付和运维时创建/检查 Key	生产运行建议用预置密钥和 emoon 配置管理
用户/团队	否	-	FastGPT 平台内部能力	emoon 自己维护医院项目和授权
外链发布	否	-	FastGPT 自有发布渠道	医生端、患者端、终端入口必须走 emoon
插件市场	否	P2/P3	远期模板参考	医疗工具必须经 emoon 安全审查
沙箱/Skill	否	P2/P3	开发增强	不承载医疗生产业务代码
FastGPT 文件接口	谨慎	P1/P2	只用于 FastGPT 内部临时文件	医疗敏感文件必须先入 emoon File Service

3.11 emoon 模块依赖 FastGPT 接口族架构图

下面的图只表达接口依赖关系，不表示所有接口都会进入 P0。实线是运行主链路，虚线是管理、运维、验证或后续增强链路。

flowchart TB
    Open["emoon-openplatform\n外部 API / SSE / 鉴权"]
    Agent["emoon-ai-agent\nFastGptAgentEngine / OutputNormalizer"]
    System["emoon-system / emoon-admin\n引擎配置 / 管理后台"]
    File["emoon-ai-file\n文件事实源 / 短期 URL"]
    Card["emoon-ai-card\nCard Runtime / Card Action"]
    Mcp["emoon-ai-mcp\nMCP Gateway / HIS Adapter"]
    Meter["emoon-ai-meter / billing\nUsage 归集 / 账本"]
    Audit["Audit / Operation\n审计 / 运营分析"]

    ChatApi["FastGPT 对话接口\n/v1/chat/completions"]
    ChatRead["FastGPT 会话/记录接口\n/core/chat/*"]
    AppApi["FastGPT 应用/版本/日志接口\n/core/app/*"]
    DatasetApi["FastGPT 知识库接口\n/core/dataset/*"]
    McpApi["FastGPT MCP/OpenAPI 接口\n/support/mcp/* /support/openapi/*"]
    PlatformApi["FastGPT 平台接口\nuser/team/outLink/plugin/admin/common/system"]

    Open --> Agent
    Agent --> ChatApi
    Agent -.断线恢复/排障.-> ChatRead
    System -.配置校验/版本映射.-> AppApi
    Agent -.应用版本/日志辅助.-> AppApi
    System -.知识库运行副本管理.-> DatasetApi
    Agent -.RAG 效果验证.-> DatasetApi
    File -.短期 URL / 脱敏摘要.-> Agent
    Agent --> Card
    Card --> Mcp
    ChatApi -.工具调用只能经网关.-> Mcp
    System -.OpenAPI Key / MCP 配置验证.-> McpApi
    McpApi -.只允许指向.-> Mcp
    Agent --> Meter
    ChatApi -.responseData / usage 明细.-> Meter
    Agent --> Audit
    AppApi -.运行日志辅助对账.-> Audit
    PlatformApi -.默认不接入医梦生产链路.-> System

模块依赖结论：

emoon-ai-agent 是运行时唯一直接调用 FastGPT 对话接口的模块；
emoon-system / emoon-admin 只做配置、探活、版本映射和知识库运行副本管理；
emoon-ai-file 不调用 FastGPT，只给 Agent 提供可控文件引用；
emoon-ai-card 不调用 FastGPT，只消费 Agent 归一后的卡片建议；
emoon-ai-mcp 是 FastGPT 工具调用唯一可达的医院系统网关；
emoon-ai-meter / billing 不读取 FastGPT 默认 usage 扣费，只消费 Adapter 提取后的节点用量和 emoon 自身事件；
FastGPT 用户、团队、外链、插件市场、初始化迁移接口不进入当前医梦医疗生产链路。

4. Dify vs FastGPT 对比

4.1 产品能力对比

能力	Dify	FastGPT	结论
Workflow	成熟，生态大	支持 advanced Workflow	基本对等
Agent	支持	支持 chatAgent	基本对等
RAG	成熟	成熟，中文文档友好	基本对等
MCP	非原生或需适配	原生 MCP ToolSet	FastGPT 优势
HTTP 工具	支持	支持 httpToolSet	基本对等
OpenAPI 调用	自有协议	OpenAI-like	FastGPT 工程接入更接近标准
版本管理	发布/回滚语义较完整	有版本 API，但需校准	Dify 更成熟
社区生态	更大	国内中文生态较强	取决于客户偏好
部署	依赖更多组件	MongoDB 为主，部署相对轻	FastGPT 部署较轻
开源协议	Apache 2.0	Apache 2.0 + 附加条件	Dify 更宽松

4.2 工程接入对比

维度	Dify 接入	FastGPT 接入	emoon 决策
对话请求	`/v1/chat-messages`	`/api/v1/chat/completions`	新增 `FastGptAgentEngine`
输入变量	`inputs`	`variables`	`AgentRequest.inputs` 映射到 `variables`
会话 ID	Dify `conversation_id`	FastGPT `chatId`	emoon conversationId 仍为事实源
流式格式	Dify 自有事件	OpenAI-like SSE + detail 事件	统一由 Adapter 归一
用量	metadata.usage	v1 usage 默认占位	FastGPT 需特殊归集
知识库 API	已有 `DifyKnowledgeEngine`	需新增 `FastGptKnowledgeEngine`	P1 做
健康探活	`/parameters` 可探	无统一稳定 health 端点	用最小对话或应用详情探活
意图识别	已有 `DifyIntentClient`	需抽象成可配置 Intent Client	P1 做

4.3 医疗业务影响对比

医梦能力	使用 Dify	使用 FastGPT	是否改变 emoon 责任
OpenPlatform 鉴权	emoon 控制	emoon 控制	不变
设备场景	emoon 控制	emoon 控制	不变
TaskState	emoon 控制	emoon 控制	不变
Card Runtime	emoon 控制	emoon 控制	不变
MCP Gateway	emoon 控制	emoon 控制	不变
计量账本	emoon 控制	emoon 控制	不变，但 FastGPT usage 解析更复杂
医生反馈	emoon 控制	emoon 控制	不变
知识库源资产	emoon 控制	emoon 控制	不变
Workflow 子流程	Dify 执行	FastGPT 执行	实现层改变

5. emoon 当前 Dify 接入现状

5.1 已存在的 Dify 代码

当前工程已经不是“尚未接入 Dify”的状态。已发现的关键点：

类型	位置	说明
对话引擎	`emoon-ai-agent` 中 `DifyAgentEngine`	已实现同步和 SSE
知识库引擎	`emoon-ai-agent` 中 `DifyKnowledgeEngine`	已实现知识库、文档、分段、检索等大量 API
意图识别	`DifyIntentClient`	AgentRouter 可调用 Dify 意图智能体
管理后台连通性	`AiEngineConnectivityClient`	当前支持 `mock` 和 `dify`
OpenPlatform 旧客户端	`emoon-openplatform/dify/*`	仍有 DifyApiClient 和领域对象
知识库调用	`KnowledgeBaseServiceImpl` / `KnowledgeBaseController`	多处硬编码 `dify`
应用对话服务	`AgentChatApplicationServiceImpl`	存在固定 Dify Agent ID 和 `getEngine("dify")`

5.2 当前切换成本判断

切换成本不是零，但仍可控。

低成本部分：

AgentEngine 已是可插拔接口；
AgentRequest / AgentResponse 可以复用；
AgentEngineFactory 可自动收集新实现；
Card Runtime、Device、MCP、Meter 的目标边界已经存在；
Maven 模块分层已为新实现预留位置。

中等成本部分：

知识库接口大量 Dify 语义需要抽象；
意图识别需要从 DifyIntentClient 泛化；
连通性测试和配置脱敏需要支持 FastGPT；
OpenPlatform 中固定 Dify 逻辑需要迁移到领域层或配置层；
FastGPT usage 不能直接入账。

高风险部分：

如果让 FastGPT 直接连接医院系统，会破坏医梦中台边界；
如果把 FastGPT Workflow 当作医疗主状态机，会导致审计、计量、回滚、人工确认不可控；
如果直接删除 Dify，会影响已有联调链路。

6. 目标架构与边界

6.1 五层架构

flowchart TB
    Entry["外部入口层\n小程序 / 医生端 / 终端 / 医院门户 / 第三方系统"]
    Open["医梦 OpenPlatform\n鉴权 / 限流 / 签名 / SSE / 对外契约"]
    Control["医梦医疗智能体应用控制层\n路由 / TaskState / Card / File / Meter / Audit"]
    Adapter["FastGPT Adapter\n输入裁剪 / API 调用 / SSE 归一 / 输出校验"]
    FastGPT["FastGPT AI 能力层\nLLM / Workflow / RAG / OCR / MCP Client"]
    Mcp["医梦 MCP Gateway\nHIS / LIS / EMR / PACS / 支付 / 叫号适配"]
    Hospital["医院业务系统\nHIS / LIS / EMR / PACS / 支付 / 叫号 / 物联平台"]

    Entry --> Open
    Open --> Control
    Control --> Adapter
    Adapter --> FastGPT
    Control --> Mcp
    FastGPT -.仅允许调用.-> Mcp
    Mcp --> Hospital

6.2 正确职责划分

层级	归属	职责
外部入口	emoon / 医院入口接 emoon	用户入口、终端入口、医生端入口
OpenPlatform	emoon	鉴权、签名、SSE、幂等、traceId、对外接口
医疗控制层	emoon	场景、任务、卡片、文件、工具、计量、审计
FastGPT Adapter	emoon	适配 FastGPT API，控制输入输出
AI 能力层	FastGPT / 深信服	Workflow、RAG、OCR、模型调用
医院系统层	医院 / 厂商，经 emoon 接入	HIS、LIS、EMR、支付、叫号等

6.3 禁止事项

以下行为禁止：

终端、医生端、患者端直接调用 FastGPT；
FastGPT 直接调用 HIS / LIS / EMR / PACS / 支付 / 叫号；
FastGPT 直接持有医院系统密钥；
FastGPT Workflow 直接执行挂号、支付、签到、写 EMR 等高风险动作；
将医疗主状态只保存在 FastGPT；
将完整病历、身份证、舌象原图等敏感数据无控制地传给 FastGPT；
用 FastGPT 默认 usage 直接扣费；
在 emoon-openplatform 新增 FastGPT 业务实现逻辑。

6.4 emoon-backend 内部系统与 FastGPT 调用关系

FastGPT 在 emoon-backend 中只有一个直接调用入口：

emoon-ai-agent / FastGPT Adapter

其他模块通过 emoon 内部 API、Facade、领域服务与 emoon-ai-agent 协作，不直接调用 FastGPT。

flowchart LR
    subgraph Entry["入口模块"]
        Open["emoon-openplatform\nOpenAPI / SSE / 鉴权 / 幂等"]
        Admin["emoon-admin\n管理后台入口"]
    end

    subgraph Api["API 契约层"]
        AgentApi["emoon-ai-agent-api\nAgentRequest / AgentResponse"]
        CardApi["emoon-ai-card-api"]
        DeviceApi["emoon-ai-device-api"]
        FileApi["emoon-ai-file-api"]
        MeterApi["emoon-ai-meter-api"]
        McpApi["emoon-ai-mcp-api"]
        SystemApi["emoon-system-api\nAiAgentEngineConfig"]
    end

    subgraph Domain["医梦 AI 领域实现层"]
        Agent["emoon-ai-agent\nAgentRouter / TaskState / FastGptAgentEngine"]
        FastAdapter["FastGPT Adapter\n输入裁剪 / SSE 归一 / 输出校验 / Usage 提取"]
        Card["emoon-ai-card\nCard Runtime / Card Action"]
        Device["emoon-ai-device\nDevice Registry / Scene Profile"]
        File["emoon-ai-file\n文件元数据 / 短期 URL / 审计"]
        Meter["emoon-ai-meter\nMeterEvent / Usage 归集"]
        Billing["emoon-ai-billing\n账单 / 能力值"]
        Audit["审计日志\ntraceId / 输入输出摘要"]
        Mcp["emoon-ai-mcp\nMCP Gateway / HIS Adapter"]
        System["emoon-system\n引擎配置 / 管理后台 CRUD"]
    end

    FastGPT["FastGPT\nWorkflow / RAG / OCR / LLM / MCP Client"]
    Hospital["医院系统\nHIS / LIS / EMR / PACS / 支付 / 叫号 / 物联"]

    Open --> AgentApi --> Agent
    Admin --> SystemApi --> System
    System --> Agent
    Agent --> FastAdapter --> FastGPT
    Agent --> CardApi --> Card
    Agent --> DeviceApi --> Device
    Agent --> FileApi --> File
    Agent --> MeterApi --> Meter
    Meter --> Billing
    Agent --> Audit
    Card --> McpApi --> Mcp
    FastGPT -.仅允许工具调用.-> Mcp
    Mcp --> Hospital
    File -.短期受控 URL / 脱敏摘要.-> FastAdapter
    FastAdapter -.节点 usage / responseData.-> Meter

调用顺序按一次终端对话请求拆解如下：

顺序	发起方	接收方	调用内容	说明
1	终端 / 医生端 / 患者端	`emoon-openplatform`	`/agent/chat/stream` 等 P0 接口	外部只接 emoon，不接 FastGPT
2	`emoon-openplatform`	`emoon-ai-agent-api`	统一 Agent 命令	入口层只做鉴权、签名、SSE、幂等
3	`emoon-ai-agent`	`emoon-ai-device`	查询设备场景和允许能力	限定 allowedAgents / allowedCards
4	`emoon-ai-agent`	`emoon-ai-file`	获取短期文件 URL 或脱敏摘要	FastGPT 不接收文件事实源
5	`emoon-ai-agent`	`FastGPT Adapter`	组装 FastGPT 请求	裁剪输入，注入 traceId、任务、动线、设备上下文
6	`FastGPT Adapter`	FastGPT	`/api/v1/chat/completions`	唯一直接调用 FastGPT 的运行链路
7	FastGPT	`emoon-ai-mcp`	MCP 工具调用，可选	只能调用 emoon MCP Gateway
8	`emoon-ai-mcp`	医院系统	HIS/LIS/EMR/PACS/支付/叫号适配	医院系统不感知 FastGPT
9	FastGPT	`FastGPT Adapter`	SSE / JSON / responseData	Adapter 做输出校验和 usage 提取
10	`emoon-ai-agent`	`emoon-ai-card`	创建卡片实例	FastGPT 只返回卡片建议
11	`emoon-ai-agent`	`emoon-ai-meter` / Audit	写计量事件和审计摘要	不使用 FastGPT 默认 usage 直接扣费
12	`emoon-openplatform`	外部终端	`message_delta` / `card_created` / `completed`	对外事件格式保持 emoon 稳定契约

各内部系统与 FastGPT 的关系：

emoon 内部系统	是否直接调用 FastGPT	与 FastGPT 的关系	关键注意事项
`emoon-openplatform`	否	入口层通过 Agent API 间接触发	不写 FastGPT HTTP 客户端，不保存 FastGPT 业务状态
`emoon-admin`	否	管理后台配置引擎、Agent、知识库映射	只调用 emoon 管理服务，不绕过领域层
`emoon-system`	有限	可做 FastGPT 配置校验、App/版本元数据读取	只做管理面，不进入运行主链路
`emoon-ai-agent`	是	唯一运行时直接调用 FastGPT 的领域模块	放置 `FastGptAgentEngine`、输出归一、usage 提取
`emoon-ai-card`	否	消费 FastGPT 归一后的卡片建议	卡片实例和动作状态仍在 emoon
`emoon-ai-device`	否	提供设备和场景上下文给 Agent	不把设备配置同步给 FastGPT 做事实源
`emoon-ai-file`	否	提供短期 URL 或脱敏摘要	医疗敏感文件事实源在 emoon
`emoon-ai-mcp`	被 FastGPT 间接调用	作为 FastGPT MCP Client 唯一可连工具网关	工具风险分级、鉴权、幂等、审计必须在此层
`emoon-ai-meter`	否	消费 FastGPT 节点用量和 emoon 调用事件	默认 usage 不可信，账本以 emoon 归集为准
`emoon-ai-billing`	否	基于 Meter 事件生成账单	不读取 FastGPT 账单作为事实源
`emoon-ai-operation`	否	运营统计可引用 FastGPT 日志摘要	指标口径以 emoon 事件为准

7. 模块级接入设计

7.1 模块归属

遵循 AI中台工程约束.md：

能力	落位模块	说明
FastGPT 对话引擎	`emoon-ai-agent`	新增 `FastGptAgentEngine`
FastGPT 输出归一	`emoon-ai-agent`	新增 `FastGptOutputNormalizer`
FastGPT 知识库运行副本	`emoon-ai-agent` 或后续独立知识库适配	新增 `FastGptKnowledgeEngine`
FastGPT 配置管理	`emoon-system` + API 契约	扩展 `AiAgentEngineConfig` 语义
Card Runtime	`emoon-ai-card`	不放到 FastGPT
MCP Gateway	`emoon-ai-mcp`	医院系统唯一工具网关
文件事实源	`emoon-ai-file`	敏感文件先入 emoon
计量账本	`emoon-ai-meter` / `billing`	不信任 FastGPT 默认 usage
对外入口	`emoon-openplatform`	只做入口适配，不写 FastGPT 业务逻辑

7.2 新增 `engineType=fastgpt`

ai_agent_engine_config.engine_type 增加：

fastgpt

建议配置结构：

{
  "baseUrl": "http://fastgpt:3000",
  "apiKey": "fastgpt-xxxx",
  "appId": "fastgpt-app-id",
  "detailMode": "metering",
  "timeout": {
    "connectMs": 10000,
    "readMs": 120000,
    "sseIdleMs": 300000
  },
  "fallbackPolicy": {
    "onTimeout": "preset_reply",
    "onError": "preset_reply",
    "presetReply": "AI 服务暂时不可用，请稍后再试"
  },
  "outputSchemaVersion": "emoon-card-output-v1"
}

字段说明：

字段	必填	说明
`baseUrl`	是	FastGPT 服务地址，不含末尾 `/`
`apiKey`	是	FastGPT 应用级 API Key
`appId`	建议	用于 emoon 侧映射和审计；实际调用可能由 API Key 鉴权决定
`detailMode`	是	`off` / `debug` / `metering`，控制是否请求 `detail=true`
`timeout`	是	连接、读取、SSE 空闲超时
`fallbackPolicy`	是	超时或异常时的降级策略
`outputSchemaVersion`	是	FastGPT 输出必须满足的 emoon Schema

7.3 `FastGptAgentEngine`

新增实现：

emoon-infra/emoon-modules/emoon-ai/emoon-ai-agent
└── src/main/java/com/emoon/ai/agent/infrastructure/fastgpt/
    ├── FastGptAgentEngine.java
    ├── FastGptApiClient.java
    ├── FastGptEngineConfig.java
    ├── FastGptOutputNormalizer.java
    └── FastGptUsageExtractor.java

职责：

实现 AgentEngine；
getEngineType() 返回 fastgpt；
同步对话调用 /api/v1/chat/completions；
流式对话解析 FastGPT SSE；
AgentRequest.inputs 映射到 FastGPT variables；
conversationId 映射到 FastGPT chatId；
将 FastGPT 输出归一成 AgentResponse；
将节点用量写入 metadata，供计量层消费。

不要做：

不在 Engine 内创建卡片实例；
不在 Engine 内直接调 MCP；
不在 Engine 内写计量账本；
不在 Engine 内操作 HIS；
不把 FastGPT 原始异常直接暴露给终端。

7.4 请求映射

AgentRequest 到 FastGPT 请求映射：

`AgentRequest`	FastGPT 字段	说明
`agentId`	metadata / variables	用于追踪，不直接依赖 `model`
`conversationId`	`chatId`	emoon 会话 ID 或外部映射 ID
`query`	`messages[-1].content`	用户输入
`userId`	`customUid` / variables	视 FastGPT 鉴权方式决定
`inputs`	`variables`	场景、设备、任务、动线、traceId 等
`files`	message content 中的 `image_url` / `file_url`	只能传 emoon File Service 生成的受控 URL

示例请求：

{
  "chatId": "conv_20260613_0001",
  "stream": true,
  "detail": true,
  "responseChatItemId": "msg_20260613_0001",
  "variables": {
    "traceId": "trace_20260613_0001",
    "projectId": "1",
    "deviceType": "kiosk",
    "sceneCode": "OUTPATIENT_TRIAGE",
    "taskType": "TRIAGE",
    "journeyStage": "WAITING_CHECKIN"
  },
  "messages": [
    {
      "role": "user",
      "content": "我头疼、发烧，应该挂什么科？"
    }
  ]
}

7.5 输出 Schema

FastGPT Workflow 最终输出必须满足 emoon 输出 Schema。建议 P0 使用：

{
  "reply": "建议您优先挂发热门诊或全科门诊，由医生进一步判断。",
  "cards": [
    {
      "cardKey": "department-selection",
      "cardData": {
        "departments": [
          {
            "deptId": "dept_fever",
            "name": "发热门诊",
            "reason": "存在发热症状"
          }
        ]
      }
    }
  ],
  "riskLevel": "MEDICAL_ADVICE",
  "scenarioCode": "OUTPATIENT_TRIAGE"
}

归一化规则：

如果输出是纯文本，全部作为 reply；
如果输出是 JSON，必须校验 reply/cards/riskLevel/scenarioCode；
cardKey 必须在 emoon 卡片定义中存在；
cardData 必须通过卡片 Schema 校验；
riskLevel 为高风险时，必须触发人工确认或降级；
输出中不得包含未脱敏身份证、手机号、完整病历原文、接口密钥。

8. 数据、文件与隐私设计

8.1 数据最小化

FastGPT 只接收完成当前 AI 子任务所需的最小上下文。

错误示例：

{
  "patientName": "张三",
  "idCard": "4403...",
  "phone": "138...",
  "fullEmrText": "完整病历原文..."
}

正确示例：

{
  "age": 45,
  "gender": "FEMALE",
  "chiefComplaint": "头痛伴发热 1 天",
  "abnormalItems": [
    {
      "code": "WBC",
      "name": "白细胞计数",
      "value": "12.3",
      "flag": "HIGH"
    }
  ]
}

8.2 文件处理原则

所有医疗敏感文件必须先进入 emoon File Service。

终端 / 医生端 / 患者端
        ↓
emoon /files/upload
        ↓
emoon 文件元数据、审计、脱敏、访问控制
        ↓
短期受控 URL 或脱敏摘要
        ↓
FastGPT

原因：

文件上传需要幂等；
文件删除需要审计；
舌象、面诊、报告、身份证等属于敏感数据；
FastGPT 不能成为文件源资产；
后续医生反馈和知识库更新需要引用 emoon 文件 ID。

8.3 FastGPT 文件 URL 注意事项

FastGPT 对话文档示例支持 image_url 和 file_url，但这不代表可以直接传长期公网 URL。

要求：

URL 必须短期有效；
URL 必须可审计；
URL 不应暴露真实 OSS bucket 结构；
URL 不应包含永久 token；
URL 最好绑定 traceId / fileId / projectId；
高敏文件应优先传结构化摘要，不传原文件。

9. 知识库设计

9.1 源资产与运行副本

医梦知识库分两层：

层级	事实源	职责
知识库源资产	emoon	原始文件、医生反馈、审核状态、版本、发布记录
知识库运行副本	FastGPT	向量化、RAG 检索、Workflow 引用

原则：

医生反馈不能直接写入 FastGPT 知识库。
必须先进入 emoon 审核，再同步到 FastGPT 运行副本。

9.2 新增 `FastGptKnowledgeEngine`

当前已有 DifyKnowledgeEngine，FastGPT 接入需要新增：

list datasets；
get dataset；
create dataset；
update dataset；
upload document；
update document；
delete document；
list segments；
create / update / delete segments；
retrieve / searchTest；
indexing status。

9.3 迁移策略

不要一次性把所有知识库从 Dify 迁移到 FastGPT。

建议步骤：

选一个非生产知识库验证创建、上传、检索；
建立 emoon 本地知识库 ID 与 FastGPT datasetId 的映射；
只同步已审核文档；
验证同一问题在 Dify 和 FastGPT 中的检索效果；
再切换单个 Agent 的知识库运行副本；
保留 Dify 副本一段时间，支持回退。

10. MCP 与医院系统设计

10.1 总原则

你的总体设计思路是合理的，并且应作为本文档的正式边界：

FastGPT 负责“AI 怎么调用工具”。
医梦负责“工具到底是什么、能不能调、调哪些数据、是否需要医生确认、调用结果如何进入医疗业务闭环”。

FastGPT 的 MCP 能力是优势，但必须被医梦约束。无论深信服交付的 FastGPT 版本是否包含完整 MCP Server 构建能力，医院系统都不能直接暴露给 FastGPT。医梦必须统一对接各家医院，把 HIS、LIS、EMR、PACS、慢病平台、物联平台、支付、叫号等系统封装成标准化、可鉴权、可审计、可限流、可脱敏、可幂等的医疗工具 API。

允许：

FastGPT Workflow / Agent
        ↓
FastGPT MCP ToolSet / HTTP ToolSet
        ↓
emoon MCP Gateway / Tool Server
        ↓
HIS / LIS / EMR / PACS / 慢病平台 / 物联平台 / 支付 / 叫号

禁止：

FastGPT → HIS / LIS / EMR / PACS
FastGPT → 支付 / 挂号 / 叫号原始接口
FastGPT → 设备平台原始接口

10.2 FastGPT 当前 MCP 能力

基于本地源码 /Users/destiny/dev/emoon/projects/FastGPT，当前 FastGPT MCP 能力需要分成两类理解。

能力	本地源码证据	作用	对医梦的意义	是否进入 P0
MCP Client / MCP ToolSet	`packages/service/core/app/mcp.ts`、`/api/core/app/mcpTools/*`	FastGPT 作为 MCP Client 连接外部 MCP Server，执行 `listTools` 和 `callTool`	可把 emoon MCP Gateway 注册成 FastGPT 工具集，让 Workflow/Agent 调用受控医疗工具	是，作为工具调用主方案
Streamable HTTP + SSE 兼容	`MCPClient` 先尝试 `StreamableHTTPClientTransport`，失败后回退 `SSEClientTransport`	支持两类 MCP 传输方式	emoon MCP Gateway 应优先实现 Streamable HTTP，同时可提供 SSE 兼容端点	是，联调需验证
工具列表读取	`/api/core/app/mcpTools/getTools`	按 URL 和 headerSecret 拉取远端 MCP 工具 schema	emoon 可用于注册前校验 FastGPT 看到的工具是否被裁剪	是，P1
MCP ToolSet 创建/更新	`/api/core/app/mcpTools/create`、`/api/core/app/mcpTools/update`	在 FastGPT 内创建或更新 MCP ToolSet 应用	emoon 管理后台可受控注册项目级工具集	是，P1
MCP 工具试运行	`/api/core/app/mcpTools/runTool`	直接通过 FastGPT 调用远端 MCP 工具	只适合联调验收，不应成为生产业务调用入口	否，生产不走
Workflow/Agent 工具调用	`dispatch/child/runTool.ts`、`dispatch/ai/agent/sub/tool/*`	FastGPT Workflow/Agent 在运行中调用已绑定 MCP 工具	AI 编排层可决定何时调用工具，但不能绕过 emoon 权限	是
私网地址防护	`assertMCPUrlNotInternal(url)`	阻止 MCP URL 指向内网地址	emoon Gateway 需要提供 FastGPT 可访问且受控的域名，或由部署方案明确放行代理	是，部署风险
FastGPT MCP Server	`/api/support/mcp/*`、`/api/mcp/app/[key]/mcp`	把 FastGPT 应用包装成 MCP Server，对外暴露为工具	可供 emoon 或内部平台调用 FastGPT 应用，但不能替代医疗工具网关	否，P2
MCP Server 绑定限制	`McpAppsBodySchema` 最多 50 个应用，创建端限制每团队最多 100 个 MCP 服务	限制 FastGPT 对外暴露工具规模	不适合承载医院全量工具目录	否，P2

结论：

FastGPT 具备“调用外部 MCP Server”的能力，这正好适合调用 emoon MCP Gateway。
FastGPT 也具备“把自身应用暴露成 MCP Server”的能力，但它暴露的是 FastGPT 应用，不是医院业务系统适配层。
医疗工具 API 的定义、授权、脱敏、幂等、审计、确认和业务闭环必须在医梦完成。
如果深信服交付版本裁剪掉 MCP ToolSet，则医梦仍提供 Tool Server，FastGPT 通过 HTTP ToolSet 调用；如果连 HTTP ToolSet 也不可用，则工具动作退化为 FastGPT 输出结构化意图，由 emoon Card Runtime 执行。

10.3 推荐架构

flowchart TD
    Doctor["医生端 / 患者端 / 终端设备"] --> Open["emoon-openplatform\n统一入口 / 鉴权 / SSE"]
    Open --> Control["医疗智能体应用控制层\n场景路由 / 会话 / 卡片 / 任务状态"]
    Control --> Adapter["FastGPT Adapter\nengineType=fastgpt"]
    Adapter --> FastGPT["FastGPT\nAgent / Workflow / RAG / MCP ToolSet"]

    FastGPT -->|"listTools / callTool\n只允许访问受控地址"| Mcp["emoon MCP Gateway / Tool Server\n工具目录 / 鉴权 / 脱敏 / 限流 / 审计 / 幂等"]
    Mcp --> His["HIS"]
    Mcp --> Lis["LIS"]
    Mcp --> Emr["EMR"]
    Mcp --> Pacs["PACS"]
    Mcp --> Chronic["慢病平台"]
    Mcp --> Iot["物联平台"]
    Mcp --> Pay["支付 / 叫号"]

    FastGPT -.禁止.-> His
    FastGPT -.禁止.-> Lis
    FastGPT -.禁止.-> Emr
    FastGPT -.禁止.-> Iot

    Mcp --> Audit["emoon Audit / Meter / Tool Ledger"]
    Mcp --> Card["Card Runtime\n人工确认 / 业务闭环"]

这张图表达三个事实：

FastGPT 可以编排工具，但不能拥有医院接口主权。
医梦 MCP Gateway 是医院系统唯一可达的 AI 工具网关。
L3 以上写动作必须回到 Card Runtime 或医生确认流程，不能由模型直接提交。

10.4 三种交付模式

模式	前提	调用方式	医梦职责	FastGPT 职责	适用优先级
A. FastGPT MCP ToolSet 主方案	深信服交付版本保留 `/core/app/mcpTools/*` 和 Workflow MCP 工具调用	FastGPT MCP Client → emoon MCP Gateway	提供 MCP Server、工具目录、权限、审计、脱敏、幂等、确认策略	注册 MCP ToolSet，在 Workflow/Agent 中选择工具	P0/P1 主方案
B. HTTP ToolSet 兜底	FastGPT 无 MCP ToolSet，但保留 HTTP ToolSet	FastGPT HTTP ToolSet → emoon Tool Server REST API	提供 REST Tool Server，接口能力与 MCP 工具一致	在 Workflow 中配置 HTTP 工具调用	P1 兜底
C. 结构化意图兜底	FastGPT 无 MCP/HTTP 工具能力或医院环境不允许 FastGPT 主动访问工具	FastGPT 输出 JSON 意图 → emoon 解析 → Card Action/Tool Executor	执行全部工具动作和闭环	只生成建议、参数和解释	P0 安全兜底

公司评审应以 A 为目标、B 为技术兜底、C 为安全兜底。不能因为 FastGPT 支持 MCP，就把医院接口直接交给 FastGPT 配置。

10.5 医梦 MCP Gateway 职责

emoon MCP Gateway 需要提供：

能力	说明
工具目录	按租户、医院、项目、科室、设备、Agent 场景返回可见工具
工具 schema	为 FastGPT 提供稳定的 inputSchema、description、枚举、必填项、示例
鉴权	校验 FastGPT Adapter 签发的 token、租户、项目、Agent、会话、设备、医生或患者身份
授权	决定当前场景能否看到工具、能否调用工具、是否需要人工确认
限流	按租户、项目、工具、设备、会话限流，防止模型循环调用
脱敏	请求进入医院系统前做最小化，响应返回 FastGPT 前去除非必要敏感字段
幂等	对写动作要求 `idempotencyKey`，防重复签到、重复挂号、重复支付
审计	记录 traceId、requestId、conversationId、agentVersion、toolName、参数摘要、结果摘要、耗时、调用人、确认人
错误归一	把 HIS/LIS/EMR/PACS 等异构错误转成统一错误码和可解释文本
降级	医院系统不可用时返回可恢复错误，不让 FastGPT 编造结果
确认编排	对 L3 以上动作返回 `requiresConfirmation=true`，交由 Card Runtime 创建确认卡片

MCP Gateway 的工具命名建议使用稳定业务语义，不暴露医院厂商或表结构：

hospital.schedule.search
hospital.queue.status.get
patient.report.summary.get
patient.emr.summary.get
appointment.intent.prepare
appointment.confirmed.create
device.vital.latest.get
chronic.followup.plan.suggest

10.6 工具风险分级

风险等级	示例	FastGPT 是否可直接调用	控制方式
L0 公共查询	科室介绍、楼层位置	可通过 emoon Gateway	审计 + 限流
L1 普通业务查询	排班、候诊状态	可通过 emoon Gateway	项目授权 + 脱敏
L2 敏感查询	报告、病历摘要	谨慎开放	身份授权 + 最小化
L3 业务写入	签到、锁号、挂号	不允许模型直接执行	Card Action 人工确认
L4 财务动作	支付、退款	P0 不开放	专项风控
L5 医疗正式写入	EMR、处方、诊断	不开放自动写	医生确认 + 审计

补充约束：

L0/L1 可以让 FastGPT 在 Workflow 中直接调用，但结果仍要进入 emoon 审计。
L2 必须最小化返回，优先返回摘要、结论、引用 ID，不返回完整病历或完整报告原文。
L3 不能由模型直接完成，FastGPT 最多生成“待确认动作建议”，由 Card Runtime 创建确认卡片。
L4/L5 默认不开放；确需开放时必须单独 ADR、安全评审、医院书面确认和专项风控。

10.7 FastGPT MCP 配置规则

FastGPT 侧只能注册医梦提供的 MCP/Tool 地址：

允许：
https://ai-gateway.{hospital-domain}/mcp/{tenant}/{project}
https://ai-gateway.{hospital-domain}/tools/http/{tenant}/{project}

禁止：
http://his.internal.local
http://lis.xxx.hospital
http://emr-service:8080
http://device-platform.private

配置要求：

配置项	要求
URL	只能是 emoon MCP Gateway 或 emoon Tool Server 的受控域名；如果 FastGPT 私网地址防护阻断，需要通过受控公网/专线代理解决，不允许关闭边界控制后直连 HIS
Header Secret	由 emoon 管理后台生成短期或可轮换 token，不能手工散落在 FastGPT 多个应用中
ToolList	由 emoon 生成项目级裁剪结果，再写入 FastGPT MCP ToolSet
Workflow 使用	FastGPT Workflow 可以选择工具，但不能新增未授权工具
版本映射	MCP ToolSet 配置必须纳入 emoon agentVersion / FastGPT appVersion 映射
漂移检测	定期比对 FastGPT ToolSet 中的 URL、toolName、schema 与 emoon 发布快照

10.8 标准调用流程

查询类工具：

sequenceDiagram
    participant FG as FastGPT Workflow
    participant MCP as emoon MCP Gateway
    participant Auth as emoon Auth/Policy
    participant HIS as Hospital System
    participant Audit as Audit/Meter

    FG->>MCP: callTool(toolName, params, trace headers)
    MCP->>Auth: 校验租户/项目/Agent/会话/身份/工具风险
    Auth-->>MCP: allow + dataScope
    MCP->>HIS: 调用医院系统适配器
    HIS-->>MCP: 原始结果
    MCP->>MCP: 脱敏 / 摘要 / 错误归一
    MCP->>Audit: 写工具调用审计
    MCP-->>FG: 返回受控结果

写入类工具：

sequenceDiagram
    participant FG as FastGPT Workflow
    participant MCP as emoon MCP Gateway
    participant Card as Card Runtime
    participant User as 医生/患者
    participant HIS as Hospital System
    participant Audit as Audit/Meter

    FG->>MCP: callTool(appointment.intent.prepare, params)
    MCP-->>FG: requiresConfirmation=true + cardSuggestion
    FG-->>Card: 输出卡片建议
    Card->>User: 展示确认卡片
    User->>Card: 确认
    Card->>MCP: confirmed action + idempotencyKey
    MCP->>HIS: 执行业务写入
    HIS-->>MCP: 写入结果
    MCP->>Audit: 写确认人、幂等键、结果
    MCP-->>Card: 业务闭环结果

10.9 医梦 MCP 工具 API 契约

所有医疗工具都必须具备统一元数据：

字段	说明
`toolName`	稳定工具名，例如 `hospital.queue.status.get`
`riskLevel`	L0-L5 风险等级
`tenantId/projectId/hospitalId`	多租户和医院边界
`agentId/agentVersion`	AI 应用版本
`conversationId/requestId/traceId`	全链路追踪
`operatorType/operatorId`	医生、患者、设备、系统任务
`idempotencyKey`	L3 以上写动作必填
`dataScope`	数据授权范围
`requiresConfirmation`	是否需要卡片确认
`expiresAt`	工具调用上下文过期时间

工具返回值必须避免把医院原始响应直接交给模型：

{
  "success": true,
  "toolName": "patient.report.summary.get",
  "riskLevel": "L2",
  "traceId": "trace-xxx",
  "data": {
    "summary": "血常规提示白细胞略高，需结合症状判断。",
    "references": [
      {
        "type": "report",
        "refId": "report-123",
        "displayName": "血常规",
        "sensitive": false
      }
    ]
  },
  "requiresConfirmation": false,
  "auditId": "audit-xxx"
}

10.10 FastGPT MCP Server 能力的边界

FastGPT 的 /support/mcp/* 和 /mcp/app/[key]/mcp 可以把 FastGPT 应用包装成 MCP Server。这个能力的定位是：

让 emoon 或内部平台把某个 FastGPT 应用当作 AI 工具调用；
让多个 FastGPT 应用之间复用“AI 应用工具”；
为非医疗生产链路提供 AI 能力封装。

它不能承担：

医院 HIS/LIS/EMR/PACS 的统一适配；
医疗工具的最终鉴权和审计；
医生确认和业务写入闭环；
多医院接口差异治理；
医疗数据脱敏与最小化授权。

因此，即使 FastGPT 有 MCP Server 构建能力，医梦仍要建设 MCP Gateway / Tool Server。FastGPT MCP Server 只作为“AI 应用对外工具化”的可选能力，不作为“医院工具网关”的实现。

11. 卡片与任务状态设计

11.1 FastGPT 不创建卡片实例

FastGPT 只返回卡片建议：

{
  "cardKey": "department-selection",
  "cardData": {
    "departments": []
  }
}

真正创建卡片实例的是 emoon Card Runtime：

FastGPT 输出卡片建议
        ↓
FastGPTOutputNormalizer 校验
        ↓
Card Runtime 创建 ai_card_instance
        ↓
OpenPlatform SSE 发送 card_created
        ↓
终端执行 Card Action
        ↓
emoon 执行业务动作

11.2 FastGPT 不维护医疗主状态

医疗任务状态保存在 emoon：

conversationId；
taskId；
taskType；
currentStep；
journeyState；
cardInstanceId；
traceId；
toolInvokeId；
auditId。

FastGPT 可辅助判断下一步，但不能成为状态事实源。

12. 计量、账本与审计设计

12.1 不能信任默认 usage

FastGPT v1 响应 Schema 中 usage 可能固定为：

{
  "prompt_tokens": 1,
  "completion_tokens": 1,
  "total_tokens": 1
}

这只是占位值，不能进入能力值扣费。

12.2 FastGPT 用量归集策略

P0 建议：

对需要计量的请求设置 detail=true；
从 responseData 中提取各节点 tokens、price、model、moduleName；
归一成 emoon MeterEvent；
同时记录 FastGPT 原始 responseData 摘要，便于排障；
计费仍由 emoon 账本决定。

P1 增强：

对接 FastGPT 应用日志或模型日志；
建立 traceId 对账；
增加差异告警；
形成项目、设备、智能体、场景维度统计。

12.3 审计字段

每次 FastGPT 调用至少记录：

字段	说明
`traceId`	全链路追踪 ID
`projectId`	项目
`tenantId`	租户
`agentId`	emoon 智能体 ID
`engineType`	`fastgpt`
`fastgptAppId`	FastGPT 应用 ID
`fastgptVersionId`	FastGPT 版本 ID
`conversationId`	emoon 会话 ID
`fastgptChatId`	FastGPT chatId
`messageId`	emoon 消息 ID
`fastgptResponseItemId`	FastGPT 响应 ID
`inputSummary`	脱敏输入摘要
`outputSummary`	脱敏输出摘要
`usageDetail`	节点用量摘要
`errorCode`	错误码
`durationMs`	耗时

13. 版本、灰度与回滚

13.1 版本事实源

FastGPT 有版本能力，但 emoon 必须维护医疗场景发布事实。

建议新增或扩展映射数据：

agentId
engineType
fastgptAppId
fastgptVersionId
emoonOutputSchemaVersion
snapshotJson
status
grayPolicy
publishedBy
publishedAt
rollbackFrom

13.2 发布流程

1. FastGPT 中完成 Workflow 调整
2. FastGPT 发布版本
3. emoon 拉取版本详情或保存快照
4. emoon 执行测试问题集
5. 输出 Schema 校验
6. 工具权限校验
7. 计量字段校验
8. 灰度到指定项目/设备/Agent
9. 监控错误率与人工反馈
10. 全量切换或回滚

13.3 回滚策略

优先级：

切回上一 FastGPT versionId；
切回上一 emoon AgentEngine 配置；
切回 Dify；
切回 Mock / 模板回复；
关闭高风险能力，只保留导诊 FAQ。

14. 分阶段落地计划

阶段 0：技术验证与商务边界确认

目标：

确认 FastGPT 部署版本；
确认社区版/商业版能力边界；
确认许可证和 LOGO/版权要求；
验证 /api/v1/chat/completions；
验证 detail=true 的用量字段；
验证 MCP 能否连接 emoon Gateway；
验证知识库创建、上传、检索。

交付物：

FastGPT API 验证报告；
社区版/商业版能力清单；
接口样例；
风险确认表。

阶段 1：FastGptAgentEngine

目标：

新增 engineType=fastgpt；
打通同步对话；
打通 SSE；
支持 FastGPT 输出归一；
支持卡片建议；
支持基础异常降级；
支持连通性测试。

验收：

/agent/chat 可通过 FastGPT 返回文本；
/agent/chat/stream 可返回 message_delta 和 completed；
FastGPT 返回卡片 JSON 后，emoon 创建卡片实例；
异常时返回统一错误，不泄露 FastGPT 内部错误。

阶段 2：FastGptKnowledgeEngine

目标：

新增 FastGPT 知识库运行副本；
建立 emoon 知识库 ID 与 FastGPT datasetId 映射；
支持文档上传和检索；
保持 emoon 为知识源资产。

验收：

指定 Agent 可引用 FastGPT 知识库；
同一问题可对比 Dify/FastGPT 检索效果；
删除或回滚不丢失 emoon 源资产。

阶段 3：MCP Gateway 接入

目标：

建设 emoon MCP Gateway / Tool Server，封装 HIS、LIS、EMR、PACS、慢病平台、物联平台、支付、叫号等医院系统；
FastGPT MCP ToolSet 只注册 emoon MCP Gateway 或受控代理地址；
如果深信服交付版本不支持 MCP ToolSet，则降级为 FastGPT HTTP ToolSet 调 emoon Tool Server；
如果 MCP/HTTP 工具均不可用，则 FastGPT 只输出结构化工具意图，由 emoon Card Runtime / Tool Executor 执行；
工具目录按租户、项目、医院、设备、Agent 场景和风险等级裁剪；
L0/L1 查询工具可跑通；
L2 工具只返回脱敏摘要和引用 ID；
L3 以上写工具必须通过 Card Action 和幂等键确认。

验收：

FastGPT 不能拿到医院原始系统地址；
FastGPT ToolSet 中只能看到 emoon 发布快照内的工具；
未授权工具不可见且不可调用；
MCP ToolSet 的 URL、headerSecret、toolList 能被 emoon 巡检和漂移告警；
L3 以上动作不能由模型直接执行；
工具调用有审计记录，并能关联 requestId、conversationId、agentVersion、toolName、riskLevel、operatorId、idempotencyKey。

阶段 4：Dify/FastGPT 并存灰度

目标：

同一 emoon Agent 可配置 Dify 或 FastGPT；
按项目、设备、场景灰度；
低风险场景先切；
保留 Dify 回退路径；
灰度期间并行埋点 usage、日志、版本映射和健康状态，精细计量不作为首批灰度切流的前置阻塞项。

验收：

导诊 FAQ、轻分诊、报告解读入口至少一个场景完成灰度；
FastGPT 异常可切回 Dify 或模板；
指标包括成功率、平均耗时、卡片创建率、人工接管率、用户反馈、计量差异；
灰度过程不改变 emoon 会话、卡片、任务状态事实源。

阶段 5：计量、审计、版本与健康探活补强

目标：

detail=true.responseData 用量归集；
FastGPT 调用审计；
应用版本映射；
回滚指针；
健康探活；
错误率监控；
在扩大灰度范围前完成计量账本、审计报表和版本漂移告警闭环。

验收：

不再使用 FastGPT 默认 usage 扣费；
可按 traceId 回放输入、输出、卡片、工具、计量；
版本切换可回滚；
FastGPT 不可用时可降级；
FastGPT 管理后台配置漂移能够被发现、告警并进入人工复核。

阶段 6：公司评审、联调验收、上线准入

目标：

公司内评审通过；
商务边界确认；
医院联调环境验证；
上线准入清单完成。

验收：

架构边界无争议；
P0 能力和非 P0 能力明确；
合同/报价不默认包含商业版能力；
初级工程师能按任务拆解执行。

15. 风险矩阵

编号	风险	概率	影响	等级	应对
R1	FastGPT usage 为占位值导致错误扣费	高	高	高	P0 禁止直接用默认 usage，必须从 detail 或日志归集
R2	FastGPT 直连医院系统导致边界失控	中	高	高	只允许连接 emoon MCP Gateway，工具按风险分级
R3	商业版能力被误认为社区版能力	中	高	高	文档、报价、验收清单中明确版本边界
R4	Dify 已有代码被直接删除导致回归	中	高	高	双引擎并存，灰度迁移
R5	FastGPT Workflow 输出格式不稳定	中	中	中	OutputNormalizer + JSON Schema + 降级
R6	文件 URL 泄露敏感数据	中	高	高	File Service 生成短期受控 URL，优先传摘要
R7	MongoDB 运维经验不足	中	中	中	部署前补备份、监控、恢复演练
R8	MCP 内网地址被 FastGPT SSRF 防护阻断	中	中	中	用服务名、网关域名或明确放行策略
R9	FastGPT 版本升级 API 不兼容	中	中	中	锁版本，建立兼容测试
R10	医疗主状态落入 FastGPT	低	高	高	TaskState、Card、Audit 均以 emoon 为事实源
R11	运营人员绕过 emoon 版本映射直接修改 FastGPT 应用或 Workflow	中	高	高	FastGPT 管理后台只允许交付/运维角色操作；生产发布必须回写 emoon 版本映射和快照；定期比对 FastGPT versionId/snapshot 与 emoon 生效配置，发现漂移自动告警

16. 初级工程师实现指南

16.1 为什么不能让 FastGPT 直连 HIS

因为 HIS 调用不是普通工具调用。它涉及：

医院接口密钥；
患者身份；
业务状态；
写操作幂等；
审计；
失败补偿；
医疗风险；
商业计量。

FastGPT 只能做 AI 推理和工具编排，不能成为医院系统网关。

16.2 为什么不能相信 FastGPT 默认 usage

FastGPT v1 接口默认 usage 可能固定为 1。这个值只是 OpenAI-compatible 响应格式的占位，不代表真实 token 或成本。

正确做法：

开启 detail=true；
解析 responseData；
提取节点级 tokens / price / model；
由 emoon 计量模块归集；
由 emoon 账本扣费。

16.3 为什么文件必须先进入 emoon File Service

医疗文件属于敏感数据。emoon File Service 提供：

上传幂等；
文件元数据；
删除审计；
保留策略；
权限控制；
traceId；
短期访问 URL；
后续医生反馈引用。

FastGPT 只能拿到运行所需的短期 URL 或脱敏摘要。

16.4 为什么卡片动作必须由 emoon 执行

卡片动作通常是确定性业务动作，例如：

挂号；
签到；
建档；
支付引导；
报告确认；
医生审核。

这些动作需要：

用户确认；
幂等键；
状态机；
审计；
失败处理；
权限校验。

FastGPT 可以建议创建卡片，不能执行卡片动作。

16.5 为什么 Dify 和 FastGPT 要先并存

因为当前工程已有 Dify 代码和配置：

对话引擎；
知识库引擎；
意图识别；
管理后台连通性；
OpenPlatform 历史客户端；
知识库 Controller 硬编码。

直接删除 Dify 会造成不可控回归。正确做法是：

新增 fastgpt → 小场景验证 → 灰度切换 → 保留回滚 → 稳定后再清理旧链路

17. 公司评审问题清单

评审前需要明确以下问题。

17.1 商务与合作边界

深信服提供的是 FastGPT 平台、模型、算力和运维，还是还包括医疗场景实施？
社区版、商业版、云服务版分别进入报价的哪些部分？
是否允许私有化商用？
多租户 SaaS 场景是否需要 FastGPT 商业授权？
FastGPT 控制台 LOGO 和版权信息是否能保留或修改？

17.2 产品与交付范围

P0 是否只承诺对话、SSE、卡片输出和基础 RAG？
图片知识库、Web 同步、应用评测、内容审核是否属于 P1/P2？
医生端反馈闭环是否由 emoon 完整承接？
FastGPT 是否只作为运行副本，不保存医梦知识源资产？

17.3 技术与安全边界

FastGPT 是否部署在医院内网、深信服环境还是医梦环境？
FastGPT 如何访问 emoon MCP Gateway？
是否允许 FastGPT 访问内网服务名？
文件 URL 有效期和访问审计如何做？
FastGPT 日志中是否会保存敏感输入输出？

17.4 运维与上线

MongoDB 谁负责备份、监控、恢复？
FastGPT 版本谁负责升级？
API 不兼容时谁负责修复？
FastGPT 不可用时是否允许切回 Dify？
上线前是否完成压测和断线恢复测试？

18. 后续 ADR 建议

建议后续新增 ADR：

ADR	决策
ADR-014	FastGPT 作为 AIAgent 实现层接入，而非替代医梦 AI 中台
ADR-015	FastGPT Adapter 落位 `emoon-ai-agent`，OpenPlatform 不沉淀实现逻辑
ADR-016	FastGPT MCP 只能连接 emoon MCP Gateway
ADR-017	FastGPT usage 不直接用于扣费，计量由 emoon 归集
ADR-018	知识库源资产在 emoon，FastGPT 只保存运行副本
ADR-019	Dify 与 FastGPT 过渡期并存，按 Agent/项目灰度

19. 最终结论

FastGPT 接入是可行的，而且在中文生态、MCP 原生支持、私有化部署轻量化方面有优势。但公司评审必须坚持以下底线：

FastGPT 是 AI 能力层，不是医疗业务控制层；
医梦继续掌握入口、状态、卡片、工具、文件、反馈、计量和审计；
医院业务系统只接医梦 MCP Gateway；
医疗敏感文件和知识源资产不交给 FastGPT 做事实源；
FastGPT 默认 usage 不能用于计费；
社区版与商业版能力要在合同和验收中分清；
Dify 不立即删除，先与 FastGPT 并存灰度。

按这个边界推进，FastGPT 可以成为医梦 AI 中台的可插拔 AgentEngine，实现甲方偏好的同时，不牺牲医梦在医疗业务闭环中的核心控制权。

附录 A FastGPT 当前源码 API 明细

本节接口清单来自本地源码：

/Users/destiny/dev/emoon/projects/FastGPT/projects/app/src/pages/api

说明：

下表按 Next.js API route 路径枚举，路径中的 [token]、[key]、[...path] 表示动态参数；
本节不展开参数和返回值，只说明主要功能、emoon 是否需要对接、当前系统环境是否需要对接；
“emoon 是否需要对接”表示长期方案是否有接入价值；
“当前系统环境是否需要对接”表示在现阶段 FastGPT 接入、二三期中台建设和公司评审范围内是否应进入实施计划；
对 FastGPT 用户、团队、外链、插件市场、初始化迁移等平台内部接口，默认不进入医梦医疗生产链路。

A.1 对话、语音与会话

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/core/chat/chatTest`	测试对话 FastGPT 会话。	否，P2	当前不接
`/core/chat/clearHistories`	清空历史 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/delHistory`	删除历史 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/feedback/adminUpdate`	管理员更新 FastGPT 对话反馈，用于点赞、差评、管理员标记或反馈闭环。	可选，P1/P2	当前不作为事实源，只做反馈副本评估
`/core/chat/feedback/closeCustom`	关闭自定义反馈 FastGPT 对话反馈，用于点赞、差评、管理员标记或反馈闭环。	可选，P1/P2	当前不作为事实源，只做反馈副本评估
`/core/chat/feedback/getFeedbackRecordIds`	查询反馈记录 ID FastGPT 对话反馈，用于点赞、差评、管理员标记或反馈闭环。	可选，P1/P2	当前不作为事实源，只做反馈副本评估
`/core/chat/feedback/updateFeedbackReadStatus`	更新反馈已读状态 FastGPT 对话反馈，用于点赞、差评、管理员标记或反馈闭环。	可选，P1/P2	当前不作为事实源，只做反馈副本评估
`/core/chat/feedback/updateUserFeedback`	提交用户反馈 FastGPT 对话反馈，用于点赞、差评、管理员标记或反馈闭环。	可选，P1/P2	当前不作为事实源，只做反馈副本评估
`/core/chat/file/presignChatFileGetUrl`	生成对话文件读取预签名 URL FastGPT 对话侧文件临时访问。	谨慎，P1/P2	当前不直接用于医疗文件，优先 emoon File Service
`/core/chat/file/presignChatFilePostUrl`	生成对话文件上传预签名 URL FastGPT 对话侧文件临时访问。	谨慎，P1/P2	当前不直接用于医疗文件，优先 emoon File Service
`/core/chat/getHistories`	查询历史列表 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/getPaginationRecords`	分页查询记录 FastGPT 会话。	可选，P1	当前可作为排障/断线恢复储备
`/core/chat/getResData`	查询响应详情 FastGPT 会话。	可选，P1	当前可作为排障/断线恢复储备
`/core/chat/helperBot/completions`	发起对话 FastGPT 辅助机器人数据。	否，P2	当前不接
`/core/chat/helperBot/deleteRecord`	删除记录 FastGPT 辅助机器人数据。	否，P2	当前不接
`/core/chat/helperBot/getFilePresign`	获取文件预签名 FastGPT 辅助机器人数据。	否，P2	当前不接
`/core/chat/helperBot/getFilePreviewUrl`	获取文件预览 URL FastGPT 辅助机器人数据。	否，P2	当前不接
`/core/chat/helperBot/getRecords`	处理 FastGPT 辅助机器人数据。	否，P2	当前不接
`/core/chat/history/batchDelete`	批量删除 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/clearHistories`	清空历史 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/delHistory`	删除历史 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/getHistories`	查询历史列表 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/getHistoryStatus`	查询历史状态 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/markRead`	标记已读 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/history/updateHistory`	更新历史 FastGPT 会话历史。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/init`	初始化 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/inputGuide/countTotal`	统计总数 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/create`	创建 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/delete`	删除 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/deleteAll`	删除全部 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/list`	查询列表 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/query`	查询 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/inputGuide/update`	更新 FastGPT 输入引导。	否，P2	当前不接
`/core/chat/outLink/init`	初始化 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/recentlyUsed`	查询最近使用 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/record/delete`	删除 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/record/getCollectionQuote`	查询集合引用 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/record/getPaginationRecords`	分页查询记录 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前可作为排障/断线恢复储备
`/core/chat/record/getQuote`	查询引用 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/record/getRecords_v2`	查询新版记录 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/record/getResData`	查询响应详情 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前可作为排障/断线恢复储备
`/core/chat/record/getSpeech`	查询语音结果 FastGPT 对话记录、引用、响应详情或语音结果。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/resume`	恢复会话 FastGPT 会话。	可选，P1	当前可作为排障/断线恢复储备
`/core/chat/team/init`	初始化 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/core/chat/updateHistory`	更新历史 FastGPT 会话。	可选，P1	当前优先 emoon 会话事实源，必要时用于补偿查询
`/v1/audio/transcriptions`	执行音频转文字，面向语音输入场景。	可选，P2	当前不接，终端语音能力后置
`/v1/chat/completions`	发起 FastGPT v1 对话，触发应用编排、Workflow、RAG、模型生成和流式输出，是 emoon P0 主链路。	是，P0	当前必须规划并优先接入
`/v2/chat/completions`	发起 FastGPT v2 对话，属于新版协议候选，需在 v1 稳定后评估。	后续评估	当前不接，待 v1 稳定后评估
`/v2/chat/stop`	停止 v2 对话生成任务，用于中断长回答或异常生成。	后续评估	当前不接，待 v1 稳定后评估

A.2 应用、Workflow 与版本

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/core/app/copy`	复制 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/create`	创建 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/del`	删除 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/detail`	查询详情 FastGPT 应用配置、基础信息、权限或工作流。	可选，P0/P1	当前用于配置校验和探活评估
`/core/app/folder/create`	创建 FastGPT 应用文件夹或路径。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/folder/path`	查询路径 FastGPT 应用文件夹或路径。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/getBasicInfo`	查询基础信息 FastGPT 应用配置、基础信息、权限或工作流。	可选，P0/P1	当前用于配置校验和探活评估
`/core/app/getPermission`	查询权限 FastGPT 应用配置、基础信息、权限或工作流。	可选，P0/P1	当前用于配置校验和探活评估
`/core/app/httpTools/create`	创建 FastGPT HTTP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/httpTools/getApiSchemaByUrl`	按 URL 解析 API Schema FastGPT HTTP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/httpTools/runTool`	运行工具 FastGPT HTTP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/httpTools/update`	更新 FastGPT HTTP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/list`	查询列表 FastGPT 应用配置、基础信息、权限或工作流。	可选，P0/P1	当前用于配置校验和探活评估
`/core/app/logs/exportLogs`	处理 FastGPT 应用运行日志，用于排障、审计辅助和对账。	可选，P1	当前用于审计对账辅助评估
`/core/app/logs/getLogKeys`	处理 FastGPT 应用运行日志，用于排障、审计辅助和对账。	可选，P1	当前用于审计对账辅助评估
`/core/app/logs/getUsers`	处理 FastGPT 应用运行日志，用于排障、审计辅助和对账。	可选，P1	当前用于审计对账辅助评估
`/core/app/logs/list`	查询列表 FastGPT 应用运行日志，用于排障、审计辅助和对账。	可选，P1	当前用于审计对账辅助评估
`/core/app/logs/updateLogKeys`	处理 FastGPT 应用运行日志，用于排障、审计辅助和对账。	可选，P1	当前用于审计对账辅助评估
`/core/app/mcpTools/create`	创建 FastGPT MCP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/mcpTools/getChildren`	获取子工具 FastGPT MCP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/mcpTools/getTools`	获取工具列表 FastGPT MCP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/mcpTools/runTool`	运行工具 FastGPT MCP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/mcpTools/update`	更新 FastGPT MCP 工具集。	可选，P1	当前仅交付验证，不进入业务主链路
`/core/app/resumeInheritPermission`	恢复继承权限 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/template/detail`	查询详情 FastGPT 应用模板。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/template/list`	查询列表 FastGPT 应用模板。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/tool/getPreviewNode`	获取预览节点 FastGPT 工具节点、系统工具模板或路径。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/tool/getSystemToolTemplates`	获取系统工具模板 FastGPT 工具节点、系统工具模板或路径。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/tool/path`	查询路径 FastGPT 工具节点、系统工具模板或路径。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/transitionWorkflow`	转换工作流 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/update`	更新 FastGPT 应用配置、基础信息、权限或工作流。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/app/version/detail`	查询详情 FastGPT 应用版本，用于发布、回滚、灰度和版本映射。	是，P1	当前需要纳入版本映射设计
`/core/app/version/latest`	查询最新版本 FastGPT 应用版本，用于发布、回滚、灰度和版本映射。	是，P1	当前需要纳入版本映射设计
`/core/app/version/list`	查询列表 FastGPT 应用版本，用于发布、回滚、灰度和版本映射。	是，P1	当前需要纳入版本映射设计
`/core/app/version/publish`	发布 FastGPT 应用版本，用于发布、回滚、灰度和版本映射。	是，P1	当前需要纳入版本映射设计
`/core/app/version/update`	更新 FastGPT 应用版本，用于发布、回滚、灰度和版本映射。	是，P1	当前需要纳入版本映射设计
`/core/workflow/debug`	调试 FastGPT Workflow。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/workflow/getSandboxPackages`	查询沙箱包 FastGPT Workflow。	可选，P2	当前不自动化管理 FastGPT 应用
`/core/workflow/optimizeCode`	优化代码 FastGPT Workflow。	可选，P2	当前不自动化管理 FastGPT 应用

A.3 知识库、集合、分段与训练

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/core/dataset/apiDataset/getCatalog`	查询目录 FastGPT API 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/apiDataset/getPathNames`	查询路径名称 FastGPT API 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/apiDataset/list`	查询列表 FastGPT API 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/apiDataset/listExistId`	查询已存在 ID FastGPT API 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create`	创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/apiCollection`	创建 API 集合 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/apiCollectionV2`	创建 API 集合 V2 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/backup`	创建备份集合 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/fileId`	按文件 ID 创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/images`	按图片创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/link`	按链接创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/localFile`	按本地文件创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/reTrainingCollection`	重训集合 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/template`	按模板创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/create/text`	按文本创建 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/delete`	删除 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/detail`	查询详情 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/export`	导出 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/list`	查询列表 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/listV2`	处理 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/paths`	查询路径 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/read`	读取 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/scrollList`	滚动查询列表 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/sync`	同步 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/trainingDetail`	查询训练详情 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/collection/update`	更新 FastGPT 知识库集合。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/create`	创建 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/createWithFiles`	通过文件创建 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/delete`	删除 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/detail`	查询详情 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/getQuoteData`	查询引用数据 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/index/create`	创建 FastGPT 知识库分段索引。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/index/delete`	删除 FastGPT 知识库分段索引。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/index/update`	更新 FastGPT 知识库分段索引。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/insertData`	插入数据 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/insertImages`	插入图片数据 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/list`	查询列表 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/pushData`	推送数据 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/update`	更新 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/data/v2/list`	查询列表 FastGPT 知识库分段数据。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/delete`	删除 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/detail`	查询详情 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/exportAll`	导出全部 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/file/getPreviewChunks`	获取文件预览分块 FastGPT 知识库文件上传、预览或检索测试。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/file/getSearchTestImagePreviewUrls`	获取检索测试图片预览 URL FastGPT 知识库文件上传、预览或检索测试。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/file/presignDatasetFilePostUrl`	生成知识库文件上传预签名 URL FastGPT 知识库文件上传、预览或检索测试。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/file/presignSearchTestImage`	生成检索测试图片预签名 URL FastGPT 知识库文件上传、预览或检索测试。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/folder/create`	创建 FastGPT 知识库文件夹。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/getPermission`	查询权限 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/list`	查询列表 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/paths`	查询路径 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/resumeInheritPermission`	恢复继承权限 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/searchTest`	检索测试 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/deleteTrainingData`	删除训练数据 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/getDatasetTrainingQueue`	查询训练队列 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/getTrainingDataDetail`	查询训练数据详情 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/getTrainingError`	查询训练错误 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/rebuildEmbedding`	重建向量索引 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/training/updateTrainingData`	更新训练数据 FastGPT 知识库训练任务。	是，P1	当前需要用于知识库运行副本设计
`/core/dataset/update`	更新 FastGPT 知识库。	是，P1	当前需要用于知识库运行副本设计
`/support/wallet/usage/createTrainingUsage`	创建训练用量订单 FastGPT 知识库训练成本归集。	可选，P1	当前仅用于训练成本对账参考

A.4 AI 模型、Skill 与沙箱

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/core/ai/agent/createQuestionGuide`	生成问题引导 FastGPT 应用问题引导。	否，P2/P3	当前不进入医疗主链路
`/core/ai/agent/v2/createQuestionGuide`	生成问题引导 FastGPT 应用问题引导。	否，P2/P3	当前不进入医疗主链路
`/core/ai/model/delete`	删除 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/detail`	查询详情 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/getConfigJson`	查询配置 JSON FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/getDefaultConfig`	查询默认配置 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/getMyModels`	查询我的模型 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/list`	查询列表 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/test`	测试 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/update`	更新 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/updateDefault`	更新默认配置 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/model/updateWithJson`	用 JSON 更新 FastGPT 模型配置。	可选，P1	当前用于环境能力展示/连通性验证
`/core/ai/optimizePrompt`	优化 Prompt FastGPT AI 辅助能力。	否，P2/P3	当前不进入医疗主链路
`/core/ai/record/getRecord`	查询 AI 记录 FastGPT AI 调用记录。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/checkExist`	检查是否存在 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/download`	下载 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/fileOp`	执行文件操作 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/getHtmlPreviewLink`	获取 HTML 预览链接 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/list`	查询列表 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/listRecursive`	处理 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/read`	读取 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/sandbox/write`	写入 FastGPT 沙箱资源。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/apps`	查询 Skill 应用 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/copy`	复制 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/create`	创建 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugChat`	处理 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugSession/chatItem/delete`	删除 FastGPT Skill 调试会话。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugSession/delete`	删除 FastGPT Skill 调试会话。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugSession/list`	查询列表 FastGPT Skill 调试会话。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugSession/records`	处理 FastGPT Skill 调试会话。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/debugSession/stop`	停止 FastGPT Skill 调试会话。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/delete`	删除 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/detail`	查询详情 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/edit`	编辑 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/export`	导出 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/folder/create`	创建 FastGPT Skill 文件夹或路径。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/folder/path`	查询路径 FastGPT Skill 文件夹或路径。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/import`	导入 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/list`	查询列表 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/resumeInheritPermission`	恢复继承权限 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/save-deploy`	保存并部署 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/update`	更新 FastGPT Skill 应用。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/version/list`	查询列表 FastGPT Skill 版本。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/version/switch`	切换 FastGPT Skill 版本。	否，P2/P3	当前不进入医疗主链路
`/core/ai/skill/version/update`	更新 FastGPT Skill 版本。	否，P2/P3	当前不进入医疗主链路

A.5 插件、市场与模板

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/core/plugin/admin/installWithUrl`	通过 URL 安装 FastGPT 插件管理资源。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/pkg/confirm`	确认 FastGPT 插件包。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/pkg/upload`	上传 FastGPT 插件包。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/app/create`	创建 FastGPT 插件工具关联应用。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/app/systemApps`	查询系统应用 FastGPT 插件工具关联应用。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/app/update`	更新 FastGPT 插件工具关联应用。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/delete`	删除 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/detail`	查询详情 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/list`	查询列表 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/runtimeConfig/detail`	查询详情 FastGPT 插件工具运行配置。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/runtimeConfig/reset`	重置 FastGPT 插件工具运行配置。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/runtimeConfig/update`	更新 FastGPT 插件工具运行配置。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/tag/create`	创建 FastGPT 插件工具标签。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/tag/delete`	删除 FastGPT 插件工具标签。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/tag/update`	更新 FastGPT 插件工具标签。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/tag/updateOrder`	更新排序 FastGPT 插件工具标签。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/update`	更新 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/updateOrder`	更新排序 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/admin/tool/versions`	查询版本 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/team/toggleInstall`	切换安装状态团队 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/team/tool/detail`	查询详情团队 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/team/tool/list`	查询列表团队 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/team/tool/versions`	查询版本团队 FastGPT 插件工具。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/core/plugin/toolTag/list`	查询列表 FastGPT 插件工具标签。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/marketplace/[...path]`	访问 FastGPT 市场资源代理。	否，P2/P3	当前不接，医疗插件须经 emoon 审查
`/support/marketing/fetchWorkflow`	处理 FastGPT 市场工作流模板。	否，P2/P3	当前不接，医疗插件须经 emoon 审查

A.6 MCP、OpenAPI Key 与外链发布

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/mcp/app/[key]/mcp`	提供 FastGPT MCP 协议访问端点。	可选，P2	仅用于把 FastGPT 应用暴露给 emoon 或内部平台，不作为医院工具网关
`/support/mcp/create`	创建 FastGPT MCP Server 配置。	可选，P2	非医疗工具主链路；不能替代 emoon MCP Gateway
`/support/mcp/delete`	删除 FastGPT MCP Server 配置。	可选，P2	非医疗工具主链路；按需用于清理 FastGPT 应用工具暴露
`/support/mcp/list`	查询列表 FastGPT MCP Server 配置。	可选，P2	非医疗工具主链路；按需用于配置巡检
`/support/mcp/server/toolCall`	调用工具 FastGPT MCP Server 工具。	可选，P2	仅用于 FastGPT 应用工具暴露验证，不进入医院系统调用路径
`/support/mcp/server/toolList`	查询工具列表 FastGPT MCP Server 工具。	可选，P2	仅用于 FastGPT 应用工具暴露验证，不进入医院系统调用路径
`/support/mcp/update`	更新 FastGPT MCP Server 配置。	可选，P2	非医疗工具主链路；如启用必须纳入 emoon 版本审计
`/support/openapi/create`	创建 FastGPT OpenAPI Key。	可选，P1	当前由运维/交付配置，不进运行链路
`/support/openapi/delete`	删除 FastGPT OpenAPI Key。	可选，P1	当前由运维/交付配置，不进运行链路
`/support/openapi/health`	健康检查 FastGPT OpenAPI Key。	可选，P1	当前可作为 OpenAPI Key 健康检查
`/support/openapi/list`	查询列表 FastGPT OpenAPI Key。	可选，P1	当前由运维/交付配置，不进运行链路
`/support/openapi/update`	更新 FastGPT OpenAPI Key。	可选，P1	当前由运维/交付配置，不进运行链路
`/support/outLink/create`	创建 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/delete`	删除 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/dingtalk/[token]`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/feishu/[token]`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/list`	查询列表 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/offiaccount/[token]`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/playground/config`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/playground/update`	更新 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/update`	更新 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/wechat/logout`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/wechat/qrcode/generate`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/wechat/qrcode/status`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon
`/support/outLink/wecom/[token]`	处理 FastGPT 外链发布渠道。	否	当前不接，外部入口必须走 emoon

A.7 用户、团队与额度

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/support/user/account/checkPswExpired`	检查密码过期 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/loginByPassword`	密码登录 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/loginout`	退出登录 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/preLogin`	登录前检查 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/resetExpiredPsw`	重置过期密码 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/tokenLogin`	Token 登录 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/update`	更新 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/account/updatePasswordByOld`	用旧密码改密 FastGPT 用户账号。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/limit/datasetSizeLimit`	查询知识库容量限制 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/limit/exportDatasetLimit`	查询知识库导出限制 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/limit/webSyncLimit`	查询 Web 同步限制 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/plan/getTeamPlanStatus`	查询团队套餐状态 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/thirtdParty/checkUsage`	检查使用量 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系
`/support/user/team/update`	更新 FastGPT 团队、套餐、额度或第三方能力。	否	当前不接，emoon 自有用户/团队/文件体系

A.8 文件、系统与通用资源

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/common/file/presignAvatarPostUrl`	生成头像上传预签名 URL FastGPT 通用文件资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/common/file/presignTempFilePostUrl`	生成临时文件上传预签名 URL FastGPT 通用文件资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/common/file/read/[filename]`	处理 FastGPT 通用文件资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/common/system/getInitData`	处理 FastGPT 通用系统任务。	否	当前不接，emoon 自有用户/团队/文件体系
`/common/system/unlockTask`	解锁任务 FastGPT 通用系统任务。	否	当前不接，emoon 自有用户/团队/文件体系
`/common/tracks/push`	上报埋点 FastGPT 埋点数据。	否	当前不接，emoon 自有用户/团队/文件体系
`/invoke/fileUpload`	文件上传 FastGPT invoke 资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/invoke/userInfo`	查询用户信息 FastGPT invoke 资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/system/file/[jwt]`	处理 FastGPT 系统文件。	否	当前不接，emoon 自有用户/团队/文件体系
`/system/file/download/[token]`	处理 FastGPT 系统文件。	否	当前不接，emoon 自有用户/团队/文件体系
`/system/file/upload/[token]`	处理 FastGPT 系统文件。	否	当前不接，emoon 自有用户/团队/文件体系
`/system/img/[...id]`	读取 FastGPT 系统图片资源。	否	当前不接，emoon 自有用户/团队/文件体系
`/system/plugin/[...path]`	读取 FastGPT 插件静态资源。	否	当前不接，emoon 自有用户/团队/文件体系

A.9 初始化、迁移与管理运维

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/admin/clearInvalidData`	清理无效数据 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initFeedbackFlags`	初始化反馈标记 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4132`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4140`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4141`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4143`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4144`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4145`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv41451`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/initv4147`	处理 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用
`/admin/support/appRegistration/create`	创建 FastGPT 初始化、迁移或管理维护任务。	否	当前仅 FastGPT 运维升级使用

A.10 代理、兼容与文档

接口	主要功能介绍	emoon 是否需要对接	当前系统环境是否需要对接
`/aiproxy/[...path]`	处理 FastGPT AI Proxy 代理能力。	否	当前不进入医疗生产链路
`/aiproxy/api/createChannel`	创建代理渠道 FastGPT AI Proxy 代理能力。	否	当前不进入医疗生产链路
`/devapidoc.json`	导出 FastGPT 开发 API 文档描述。	否	当前不进入医疗生产链路
`/lafApi/[...path]`	FastGPT 兼容或专业版代理转发接口。	否	当前不进入医疗生产链路
`/openapi.json`	导出 FastGPT OpenAPI 描述文件。	否	当前不进入医疗生产链路
`/proApi/[...path]`	FastGPT 兼容或专业版代理转发接口。	否	当前不进入医疗生产链路

FastGPT接入技术方案.md 111 KB History Raw