HTTP Gateway

wesgine HTTP 网关的双模式、中间件管道、路由体系与基础设施端点。

双模式

模式函数路径
单 Cellgateway.ServeSingleCell(cell, opts)无 cellID 前缀
多 Cellgateway.ServeMultiCell(hyp, opts)/cells/{id}/*

中间件管道

请求到达
    ↓ path parse
    ↓ cell exist
    ↓ auth
    ↓ state（温度检查）
    ↓ quota
    ↓ dispatch

温度中间件

Cell 状态行为
Hot / Warm直接处理
Cool同步 WarmUp → 处理
Cold503 + Retry-After: 5 + 异步唤醒

Admin 路由（/admin/*）

Cells 管理

方法路径说明
GET/admin/cells列出所有 Cell
POST/admin/cells创建 Cell
POST/admin/cells/import导入 Cell
GET/admin/cells/{id}获取 Cell 详情
PATCH/admin/cells/{id}更新 CellSpec
PUT/admin/cells/{id}幂等 upsert
DELETE/admin/cells/{id}删除 Cell
POST/admin/cells/{id}/stop停止 Cell
POST/admin/cells/{id}/restart重启 Cell
POST/admin/cells/{id}/reset-faults重置故障计数
GET/admin/cells/{id}/export导出 Cell

SharedProviders

方法路径说明
GET/admin/shared-providers共享 Provider 列表
POST/admin/shared-providers配置共享 Provider

Admin Observe

方法路径说明
GET/admin/observe/snapshotHypervisor 快照
GET/admin/observe/per-cell-stats各 Cell 统计
GET/admin/observe/provider-latencyProvider 延迟
GET/admin/observe/runs跨 Cell Run 列表
GET/admin/observe/crash-log崩溃日志

Tokens

方法路径说明
POST/admin/tokens签发 Admin Token
DELETE/admin/tokens/{id}吊销 Admin Token

基础设施路由

方法路径说明Auth
GET/health健康检查无
GET/metricsPrometheus 指标公开或 admin

Cell 路由 概览

所有业务路径 /cells/{cellID}/*。主要分组：

分组端点数示例
Runtime3/run、/chat、/runs/{runID}/events
Agents4CRUD
Sessions9列表、消息、中断、批量
Checkpoints/Branches7创建、回滚、分支
Memory15列表、搜索、保存、GC、验证
Knowledge17搜索、导入、数据源、文件
Skills16安装、卸载、回滚、统计
Tools2列表、描述
HITL2待处理、响应
Observe12token 用量、Run 追踪
TaskMemory10计划、发现、决策
Learn5惯例扫描、纠正
Channels7渠道注册、发送
Email4邮箱管理
MCP7注册、探测、调用
Cron9定时任务管理
Policy/Quotas/Config10治理、配额、特性
Tokens2Cell Token 签发/吊销
Events1SSE 全局事件流
Audit2审计导出
Workspace7文件管理
Providers3私有 Provider、测试
Webhook3企业微信/飞书/钉钉

相关文档