本文档提供了 GeniSpace API 的完整端点列表和快速参考。所有端点都位于 /api 基础路径下（例如 https://api.genispace.cn/api/agents）。
智能体 API
管理端点
| 方法 | 端点 | 描述 |
|---|
| GET | /api/agents | 获取智能体列表（支持 accessibleOnly） |
| POST | /api/agents | 创建新智能体（需要 name、model、systemPrompt） |
| GET | /api/agents/{id} | 获取特定智能体详情 |
| PUT | /api/agents/{id} | 更新智能体 |
| DELETE | /api/agents/{id} | 删除智能体 |
| GET | /api/agents/system-agents | 列出内置系统智能体 |
创建智能体时，可使用 accessScope（SPACE 或 RESTRICTED）限制访问范围；对于 RESTRICTED 智能体，还可提供 allowedUserIds[] 列表。完整参数参考请见 智能体 API。
执行端点
| 方法 | 端点 | 描述 |
|---|
| POST | /api/agents/{id}/chat | 多模态对话，SSE 流式（GeniSpace 原生 contents[]） |
| POST | /api/agents/{id}/execute | 结构化智能体执行 |
会话端点
| 方法 | 端点 | 描述 |
|---|
| POST | /api/agents/sessions | 创建对话会话 |
| GET | /api/agents/sessions | 列出对话会话 |
| GET | /api/agents/sessions/{sessionId} | 获取会话详情 |
| DELETE | /api/agents/sessions/{sessionId} | 删除会话 |
| GET | /api/agents/sessions/{sessionId}/messages | 列出会话消息 |
记忆端点
| 方法 | 端点 | 描述 |
|---|
| GET | /api/agents/{id}/memory | 列出智能体记忆条目 |
| POST | /api/agents/{id}/memory | 创建记忆条目 |
| PUT | /api/agents/{id}/memory/{memoryId} | 更新记忆条目 |
| DELETE | /api/agents/{id}/memory/{memoryId} | 删除记忆条目 |
| POST | /api/agents/{id}/memory/search | 搜索智能体记忆 |
| DELETE | /api/agents/{id}/memory/clear | 清空智能体记忆 |
MCP 工具
| 方法 | 端点 | 描述 |
|---|
| GET | /api/agents/{id}/mcp/tools | 列出智能体可用的 MCP 工具 |
任务 API
| 方法 | 端点 | 描述 |
|---|
| GET | /api/tasks | 获取任务列表 |
| POST | /api/tasks | 创建新任务 |
| GET | /api/tasks/{id} | 获取特定任务详情 |
| PUT | /api/tasks/{id} | 更新任务 |
| DELETE | /api/tasks/{id} | 删除任务 |
| POST | /api/tasks/{id}/execute | 执行任务 |
| GET | /api/tasks/{id}/executions | 获取任务执行历史 |
| GET | /api/tasks/executions/{executionId} | 获取某次执行的详情 |
| GET | /api/tasks/runs/{executionId} | 获取某次执行的运行状态 |
数据集 API
| 方法 | 端点 | 描述 |
|---|
| GET | /api/datasets | 获取数据集列表 |
| POST | /api/datasets | 创建新数据集 |
| GET | /api/datasets/{id} | 获取特定数据集详情 |
| DELETE | /api/datasets/{id} | 删除数据集 |
| POST | /api/datasets/{id}/data/insert | 插入行数据 |
| POST | /api/datasets/{id}/data/query | 按过滤条件查询行数据 |
| POST | /api/datasets/{id}/data/update | 更新行数据 |
| POST | /api/datasets/{id}/data/delete | 删除行数据 |
| POST | /api/datasets/{id}/data/search | 向量搜索 |
| POST | /api/datasets/{id}/data/full-text-search | 全文搜索 |
API 密钥管理
| 方法 | 端点 | 描述 |
|---|
| GET | /api/api-keys | 获取 API 密钥列表 |
| POST | /api/api-keys | 创建新 API 密钥 |
| GET | /api/api-keys/{id} | 获取特定 API 密钥详情 |
| PUT | /api/api-keys/{id} | 更新 API 密钥 |
| POST | /api/api-keys/{id}/revoke | 撤销 API 密钥 |
| POST | /api/api-keys/validate | 校验 API 密钥 |
OpenAI 兼容中继
| 方法 | 端点 | 描述 |
|---|
| GET | /models/v1/{path} | OpenAI 兼容 GET 中继 |
| POST | /models/v1/{path} | OpenAI 兼容 POST 中继（例如 /models/v1/chat/completions） |
相关文档