跳转至

API 参考

API 参考聚合当前平台已经暴露出来的主要业务面与控制面接口，帮助读者快速判断“这类功能是走哪个 router、属于哪个系统”。

路由分区

路由分区 主要职责 关键文件
平台聊天入口 chat stream、models catalog、release metadata ai_service/api/routers/core.py
Conversations session、WebSocket、takeover、turn context、knowledge correction ai_service/conversations/interfaces/http/router.py
Agent 控制面 agent、version、orchestrator、模型路由、Fusion link ai_service/api/routers/agents.py
Knowledge / RAG source、document、ingestion、manual inspection、snapshot rebuild、retrieval test ai_service/api/routers/knowledge.py
Document Recognition public run review/download routes、overview、runs ai_service/document_recognition/interfaces/http/router.py
ETL Jobs ETL jobs、下载、删除 ai_service/api/routers/jobs.py
MCP 控制面 server、credential、agent mount、health check、test call、response preview ai_service/api/routers/mcp.py
Fusion Runtime draft、publish、run、persisted I/O ai_service/fusion/interfaces/http/router.py 与 ai_service/api/routers/agents.py
Evaluation dataset、CSV import、run、result export、gate evaluate ai_service/api/routers/evaluation.py
Scheduled Tasks task 列表、详情、取消、run history ai_service/api/routers/scheduled_tasks.py
Skills skill asset、skill version、agent mount、skill audit ai_service/api/routers/skills.py
Admin auth、users、system settings、model config、audit ai_service/api/routers/admin_*.py

按主题查接口

会话与编排

  • 会话、消息、SSE、WebSocket、人工接管、MCP passthrough
  • 对应系统页：编排器参考

RAG 与知识

  • knowledge source
  • documents
  • ingestion jobs
  • retrieval test
  • manual inspection
  • snapshot rebuild
  • correction publish

对应系统页：RAG 参考

MCP 与外部工具

  • MCP server registry
  • credentials
  • agent mounts
  • health check
  • test call
  • MCP response preview

对应系统页：MCP 参考

Fusion Runtime

  • definitions
  • versions
  • publish
  • runs
  • persisted inputs / outputs

对应系统页：Fusion 参考

Evaluation

  • datasets
  • CSV import
  • evaluation runs
  • run results
  • gate evaluate
  • CSV results export

对应系统页：评测参考

Document Recognition

  • runtime agent registry
  • Fusion-backed run projections
  • field reviews
  • source/result downloads
  • document recognition overview / runs

对应系统页：单证识别参考

Skills 与 Scheduled Tasks

  • skills、skill versions、agent skill mounts
  • scheduled tasks、run history、cancel

这两块当前已经是平台控制面的一部分，不应再被视为边缘功能。

使用方式

  • 想理解“为什么有这类接口”：先看对应系统页
  • 想找“这个接口归哪一层”：先看本页
  • 想看对象定义、字段与 schema：进入 源码级 API 参考