HTTP Gateway
wesgine 通过 HTTP Gateway 暴露所有功能。所有 Cell 业务端点都在 /cells/{cellID}/ 路径下。
路由结构
/health # 健康检查（无 auth）
/admin/* # Hypervisor 管理（admin token）
/cells/{cellID}/* # Cell 业务端点
核心端点
Runtime — 对话与执行
| 方法 | 路径 | 说明 |
|---|
| POST | /cells/{id}/run | SSE 流式 Run |
| POST | /cells/{id}/chat | 同步 Chat |
| GET | /cells/{id}/runs/{runID}/events | SSE 事件重放 |
Run 请求示例：
{
"actor": "alice",
"session_id": "s1",
"agent_id": "default",
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "你好"}
]
}
Run 生命周期与 SSE 连接解耦——SSE 断开不会取消 Run。
Sessions — 会话管理
| 方法 | 路径 | 说明 |
|---|
| GET | /cells/{id}/sessions | 列出会话 |
| GET | /cells/{id}/sessions/{sid}/messages | 消息列表 |
| DELETE | /cells/{id}/sessions/{sid} | 删除会话 |
| POST | /cells/{id}/sessions/{sid}/interrupt | 中断当前 Run |
Memory — 记忆管理
| 方法 | 路径 | 说明 |
|---|
| GET | /cells/{id}/memory | 列出记忆 |
| POST | /cells/{id}/memory | 保存记忆条目 |
| POST | /cells/{id}/memory/search | 语义搜索 |
| GET | /cells/{id}/memory/counts | 每层条数 |
| DELETE | /cells/{id}/memory/{mid} | 删除单条 |
Agents — Agent 配置
| 方法 | 路径 | 说明 |
|---|
| GET | /cells/{id}/agents | 列出 Agent |
| POST | /cells/{id}/agents | 注册/更新 |
| DELETE | /cells/{id}/agents/{aid} | 删除 |
Knowledge — 知识库
| 方法 | 路径 | 说明 |
|---|
| POST | /cells/{id}/knowledge/search | 语义搜索 |
| POST | /cells/{id}/knowledge/ingest | 上传文件 |
| GET | /cells/{id}/knowledge/sources | 数据源列表 |
| GET | /cells/{id}/knowledge/files | 文件列表 |
Observe — 可观测
| 方法 | 路径 | 说明 |
|---|
| GET | /cells/{id}/observe/token-usage | Token 用量 |
| GET | /cells/{id}/observe/runs | Run 列表 |
| GET | /cells/{id}/observe/stats | 统计信息 |
Admin 端点
| 方法 | 路径 | 说明 |
|---|
| GET | /admin/cells | 列出所有 Cell |
| POST | /admin/cells | 创建 Cell |
| PATCH | /admin/cells/{id} | 更新 CellSpec |
| DELETE | /admin/cells/{id} | 删除 Cell |
| GET | /admin/cells/{id}/export | 导出 Cell |
| POST | /admin/cells/import | 导入 Cell |
| GET | /admin/shared-providers | 共享 Provider 列表 |
| POST | /admin/shared-providers | 配置共享 Provider |
| GET | /admin/observe/snapshot | Hypervisor 快照 |
认证
/health — 无需认证/admin/* — Admin Token/cells/{id}/* — Cell Token 或 Admin Token
签发 Token：
# Admin Token
curl -X POST http://localhost:9091/admin/tokens
# Cell Token
curl -X POST http://localhost:9091/cells/my-cell/tokens
中间件链
请求经过以下中间件：
path parse → cell exist → auth → state → quota → dispatch
- state 中间件：Cool 态 Cell 首请求自动 WarmUp；Cold 态返回 503 +
Retry-After
SSE 事件格式
Run 的 SSE 流包含以下事件类型：
| 事件 | 说明 |
|---|
stream_delta | 模型输出片段（流式文本） |
tool_start | 工具调用开始 |
tool_result | 工具调用结果 |
plan_created | 计划创建 |
plan_updated | 计划步骤更新 |
done | Run 正常完成 |
error | 错误 |
SSE 断开后可通过 GET /cells/{id}/runs/{runID}/events?from_seq=N 续播事件。