端点概览

本页面集中列出 AI 服务的 HTTP、SSE、WebSocket 端点，便于快速检索。

核心会话端点

方法	路径	说明
GET	/healthz	健康检查
POST	/stream	SSE 流式对话，支持 agent_id
GET	/sessions	最近会话列表
GET	/sessions/{session_id}/messages	会话消息历史
GET	/models	模型清单与默认配置
WS	/ws/{session_id}	WebSocket 会话，支持 agent_id

Agent 管理端点

方法	路径	说明
POST	/agents	创建 Agent
GET	/agents	获取 Agent 列表
GET	/agents/{agent_id}	获取 Agent 详情
PATCH	/agents/{agent_id}	更新 Agent

知识源管理端点

方法	路径	说明
POST	/knowledge-sources	创建知识源
GET	/knowledge-sources	获取知识源列表
GET	/knowledge-sources/{source_id}	获取知识源详情
PATCH	/knowledge-sources/{source_id}	更新知识源

Agent 知识挂载端点

方法	路径	说明
POST	/agents/{agent_id}/mounts	挂载知识源到 Agent
GET	/agents/{agent_id}/mounts	获取 Agent 挂载列表
DELETE	/agents/{agent_id}/mounts/{source_id}	解除知识源挂载

MCP Server 管理端点

方法	路径	说明
POST	/mcp-servers	创建 MCP Server
GET	/mcp-servers	获取 MCP Server 列表
GET	/mcp-servers/{mcp_server_id}	获取 MCP Server 详情
PATCH	/mcp-servers/{mcp_server_id}	更新 MCP Server
DELETE	/mcp-servers/{mcp_server_id}	删除 MCP Server
POST	/mcp-servers/{mcp_server_id}/health-check	运行连接健康检查

MCP 凭据管理端点

方法	路径	说明
POST	/mcp-credentials	创建加密 MCP 凭据
GET	/mcp-credentials	获取 MCP 凭据列表
GET	/mcp-credentials/{credential_id}	获取 MCP 凭据详情（不返回明文）
PATCH	/mcp-credentials/{credential_id}	更新 MCP 凭据元数据
DELETE	/mcp-credentials/{credential_id}	删除 MCP 凭据
POST	/mcp-credentials/{credential_id}/rotate	轮换 MCP 凭据密文

Agent MCP 挂载端点

方法	路径	说明
POST	/agents/{agent_id}/mcp-mounts	挂载 MCP Server 到 Agent
GET	/agents/{agent_id}/mcp-mounts	获取 Agent MCP 挂载列表
PATCH	/agents/{agent_id}/mcp-mounts/{mount_id}	更新 MCP 挂载策略
DELETE	/agents/{agent_id}/mcp-mounts/{mount_id}	解除 MCP 挂载

MCP 调用审计端点

方法	路径	说明
GET	/sessions/{session_id}/mcp-calls	按会话查询 MCP 调用审计
GET	/agents/{agent_id}/mcp-calls	按 Agent 查询 MCP 调用审计

文档与摄取端点

方法	路径	说明
POST	/knowledge-sources/{source_id}/documents	上传文档
GET	/knowledge-sources/{source_id}/documents	获取文档列表
GET	/knowledge-sources/{source_id}/documents/{document_id}	获取文档详情
DELETE	/knowledge-sources/{source_id}/documents/{document_id}	删除文档
POST	/embedding-model/check-readiness	检查并预热 Embedding 模型（返回 backend_type/provider/model/dim/错误信息）
POST	/knowledge-sources/{source_id}/ingest	触发摄取任务
GET	/knowledge-sources/{source_id}/ingestion-jobs	列出摄取任务
GET	/ingestion-jobs/{job_id}	获取摄取任务状态