核心概念：API 服务

AI 服务基于 FastAPI，对外提供 REST + SSE + WebSocket 能力，主要用于：会话对话、Agent 管理、RAG 知识源管理、文档摄取与查询等。

• SSE 流式回复（POST /stream）。
• WebSocket 实时会话（/ws/{session_id}）。
• 会话与消息查询（/sessions、/sessions/{id}/messages）。
• 模型清单与默认配置（/models）。
• Agent 管理（/agents CRUD）。
• 知识源管理（/knowledge-sources CRUD）。
• Agent 知识挂载（/agents/{agent_id}/mounts）。
• 文档上传、查询与删除（/knowledge-sources/{id}/documents）。
• 摄取任务触发与查询（/knowledge-sources/{id}/ingest）。

快速导航

• 端点总览（HTTP/SSE/WS）：见「API 参考 → 端点概览」。
• FastAPI 应用入口与数据模型：见「API 参考 → API 服务」。

数据流说明

• SSE：客户端 POST 请求后，服务端持续输出 data: {json} 事件。
• WebSocket：连接后可推送历史消息与新回复。
• Agent 知识过滤：当请求携带 agent_id 时，RAG 检索会根据 Agent 挂载的知识源进行过滤。

API 参考

端点与数据模型的详细说明请查看：

• 「API 参考 → 端点概览」
• 「API 参考 → API 服务」