API 端点速查
以下公开端点使用 https://api.genispace.cn/api 作为 Base URL。实际可用范围仍取决于空间、角色、应用和部署配置。
智能体
| 方法 | 端点 | 用途 |
|---|---|---|
| GET / POST | /agents | 列出或创建智能体 |
| GET / PUT / DELETE | /agents/{agentId} | 读取、更新或删除智能体 |
| POST | /agents/{agentId}/chat | 对话智能体；流式时使用 LangGraph V3 |
| POST | /agents/{agentId}/execute | 结构化任务智能体执行 |
| GET | /agents/{agentId}/mcp/tools | 列出智能体可用的 MCP 工具 |
| POST / GET | /agents/sessions | 创建或列出对话会话 |
| GET / PATCH / DELETE | /agents/sessions/{sessionId} | 读取、重命名或删除会话 |
| GET | /agents/sessions/{sessionId}/messages | 列出已保存消息和执行事件 |
| POST | /agents/{agentId}/sessions/{sessionId}/context/status | 查看上下文用量 |
| POST | /agents/{agentId}/sessions/{sessionId}/context/compact | 压缩模型上下文 |
| GET | /agents/{agentId}/sessions/{sessionId}/interactions/pending | 列出待处理用户交互 |
| POST | /agents/{agentId}/turns/{turnId}/resume | 以 V3 流恢复用户选择交互 |
| POST | /agents/{agentId}/turns/{turnId}/cancel | 取消正在执行的对话轮次 |
流请求头、事件、请求体和交互生命周期详见智能体 API。
Agent Job
| 方法 | 端点 | 用途 |
|---|---|---|
| POST | /agent-jobs | 提交 AGENT_INVOKE 等后台 Agent Job |
| GET | /agent-jobs/{jobId} | 查看阶段、进度、结果或错误 |
| POST | /agent-jobs/{jobId}/cancel | 请求协作式取消 |
任务与工作流执行
| 方法 | 端点 | 用途 |
|---|---|---|
| GET / POST | /tasks | 列出或创建任务 |
| GET / PUT / DELETE | /tasks/{taskId} | 读取、更新或删除任务 |
| POST | /tasks/{taskId}/execute | 启动手动执行 |
| GET | /tasks/{taskId}/executions | 列出任务执行 |
| GET | /tasks/executions/{executionId} | 查看执行详情 |
| GET | /tasks/runs/{executionId} | 查看当前运行状态 |
数据集
| 方法 | 端点 | 用途 |
|---|---|---|
| GET / POST | /datasets | 列出或创建数据集 |
| GET / DELETE | /datasets/{datasetId} | 读取或删除数据集 |
| POST | /datasets/{datasetId}/data/insert | 插入记录 |
| POST | /datasets/{datasetId}/data/update | 更新匹配记录 |
| POST | /datasets/{datasetId}/data/query | 类型化字段、ID、排序与分页查询 |
| POST | /datasets/{datasetId}/data/count | 对有效筛选条件精确计数 |
| POST | /datasets/{datasetId}/data/delete | 删除匹配记录；客户端应要求确认 |
| POST | /datasets/{datasetId}/data/search | 从文本执行向量语义搜索 |
| POST | /datasets/{datasetId}/data/full-text-search | 全文搜索 |
必须使用数据集 Schema 中的准确字段名。批量按 ID 查询时，应优先使用类型化 ids 字段，不要手写筛选表达式。
API Key
| 方法 | 端点 | 用途 |
|---|---|---|
| GET / POST | /api-keys | 列出或创建 API Key |
| GET / PUT | /api-keys/{keyId} | 读取或更新 Key 元数据 |
| POST | /api-keys/{keyId}/revoke | 撤销 Key |
| POST | /api-keys/validate | 验证 Key |
Models 中继
/models/v1/* 是 OpenAI 兼容模型中继，不使用核心 /api 前缀。例如：
POST https://api.genispace.cn/models/v1/chat/completions
POST https://api.genispace.cn/models/v1/embeddings
Models 中继不能替代 /api/agents/{agentId}/chat，两者具有不同的契约和运行逻辑。
MCP
MCP Server 使用 Streamable HTTP：
https://api.genispace.cn/mcp
详见 MCP 集成。