Mission Control 80+ API端点速查手册:程序化编排AI Agent工作流的完整参考
【免费下载链接】mission-controlThe world's first Autonomous Product Engine (APE): AI agents research your market, generate features, and ship code as PRs. Convoy mode, crash recovery, cost tracking, 80+ API endpoints. Self-hosted via OpenClaw Gateway.项目地址: https://gitcode.com/gh_mirrors/mission/mission-control
Mission Control(又称 Autensa)是全球首个自主产品引擎(APE),它让 AI Agent 自动研究市场、生成功能创意并以 PR 形式交付代码。其最强大的能力之一,是暴露在src/app/api/下的80+ 个 REST 与 SSE 端点——你可以用一条curl命令创建任务、指派 Agent、监听实时进度,实现完全程序化的 AI Agent 工作流编排。
本文是一份速查手册:按 10 大功能域梳理全部端点路径、方法与用途,并给出认证方式与典型编排配方,帮助新手和普通用户在 10 分钟内上手调用。
一键接入:3 步打通认证与调用
Mission Control 基于 Next.js App Router 构建,每个路由文件对应一个端点。接入只需三步:
- 本地或 Docker 启动服务:
npm install后执行npm run dev,服务默认运行在http://localhost:4000; - 设置 API 令牌:在
.env.local中配置MC_API_TOKEN(建议用openssl rand -hex 32生成)。配置后,外部调用必须携带请求头Authorization: Bearer <token>,浏览器同源请求则自动放行; - 发起第一个调用:
curl -X POST http://localhost:4000/api/tasks \ -H "Authorization: Bearer $MC_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title": "为网站添加暗色模式", "status": "assigned", "assigned_agent_id": "<agent-id>"}'当status为assigned且指定了 Agent 时,服务端会立即通过 OpenClaw Gateway 自动派发任务——这正是程序化编排的入口,实现逻辑见 src/app/api/tasks/route.ts。
端点全景图:10 大功能域一览
| 功能域 | 路径前缀 | 端点数 | 核心能力 |
|---|---|---|---|
| 任务管理 | /api/tasks | 37+ | CRUD、规划问答、派发、检查点、Convoy |
| 产品自动驾驶 | /api/products | 50+ | 研究、创意、滑动决策、A/B 测试、排程 |
| Agent 管理 | /api/agents | 9 | 目录、健康监控、信箱、网关发现 |
| 成本管控 | /api/costs | 6 | 事件上报、预算帽、明细报表 |
| 实时事件流 | /api/events | 2 | SSE 广播、任务级 Agent 流 |
| Convoy 编队 | /api/convoy | 1+ | 编队邮件通信 |
| 文件服务 | /api/files | 4 | 上传、预览、下载、在 Finder 中显示 |
| 网关代理 | /api/openclaw | 6 | 模型、会话、历史、状态 |
| 外部集成 | /api/webhooks、/api/jira | 4 | Agent 完成回调、GitHub/Jira 事件 |
| 运维管理 | /api/admin、/api/health | 7 | 备份恢复、回滚、健康指标 |
任务编排端点:创建、派发与崩溃恢复
任务是全系统的核心实体,覆盖看板 7 个状态列(PLANNING → INBOX → ASSIGNED → IN PROGRESS → TESTING → REVIEW → DONE)。
| 端点 | 方法 | 用途 |
|---|---|---|
/api/tasks | GET / POST | 列表(支持status、workspace_id、assigned_agent_id过滤)/ 创建 |
/api/tasks/[id] | GET / PATCH / DELETE | 查询、更新状态与字段、删除 |
/api/tasks/[id]/dispatch | POST | 派发给 Agent(OpenClaw 会话或 Codex CLI 运行) |
/api/tasks/[id]/dispatch/retry | POST | 派发失败后重试 |
/api/tasks/[id]/planning | GET | 获取规划阶段状态与澄清问题 |
/api/tasks/[id]/planning/answer | POST | 回答 AI 的澄清问题 |
/api/tasks/[id]/planning/approve | POST | 批准规划规格(审批门) |
/api/tasks/[id]/planning/poll | GET | 轮询规划进度 |
/api/tasks/[id]/planning/force-complete | POST | 强制完成规划 |
/api/tasks/[id]/checkpoint | GET / POST | 查看 / 保存检查点 |
/api/tasks/[id]/checkpoint/restore | POST | 崩溃后从检查点恢复,而非从零重来 |
/api/tasks/[id]/checkpoints | GET | 检查点历史列表 |
/api/tasks/[id]/chat | GET / POST | 操作员聊天(排队备注 + 实时直达消息) |
/api/tasks/[id]/chat/agents | GET | 可对话的 Agent 列表 |
/api/tasks/[id]/agent-stream | GET(SSE) | 该任务的 Agent 实时输出流 |
/api/tasks/[id]/costs | GET | 单任务成本明细 |
/api/tasks/[id]/flight-recorder | GET | 任务"飞行记录仪"审计轨迹 |
/api/tasks/[id]/pr-checks/pr-checks/retry | GET / POST | PR 检查状态与失败重跑 |
/api/tasks/[id]/deliverables | GET | 任务交付物 |
/api/tasks/unread | GET | 未读消息计数 |
派发逻辑的完整实现见 src/app/api/tasks/[id]/dispatch/route.ts 与 src/lib/server-dispatch.ts。
产品自动驾驶端点:研究 → 创意 → 滑动 → 排程
Autopilot 管线(RESEARCH → IDEATION → SWIPE → BUILD → PR)的每一步都有对应端点,全部位于/api/products下:
研究与创意
| 端点 | 方法 | 用途 |
|---|---|---|
/api/products | GET / POST | 产品列表 / 创建(含仓库预检repo_preflight) |
/api/products/[id]/research/run | POST | 触发一次市场研究(竞品、SEO、用户意图) |
/api/products/[id]/research/cycles | GET | 研究周期历史 |
/api/products/[id]/ideation/run | POST | 触发创意生成(含影响分/可行性评分) |
/api/products/[id]/ideation/cycles | GET | 创意周期历史 |
/api/products/[id]/ideas/ideas/pending | GET | 创意列表 / 待处理创意 |
/api/products/[id]/ideas/[ideaId] | GET / PATCH / DELETE | 创意详情与修改 |
/api/products/[id]/similarity | GET | 创意去重相似度检测 |
滑动决策与 Maybe 池
| 端点 | 方法 | 用途 |
|---|---|---|
/api/products/[id]/swipe/deck | GET | 取一张创意卡(类 Tinder 界面) |
/api/products/[id]/swipe | POST | 执行滑动:Pass / Maybe / Yes / Now! |
/api/products/[id]/swipe/[swipeId]/undo | POST | 撤销滑动 |
/api/products/[id]/swipe/batch | POST | 批量决策 |
/api/products/[id]/swipe/history/stats | GET | 滑动历史与偏好统计 |
/api/products/[id]/maybe/evaluate | POST | 批量重评 Maybe 池 |
/api/products/[id]/maybe/[ideaId]/resurface | POST | 创意到期重新浮出 |
健康度、排程与 A/B 测试
| 端点 | 方法 | 用途 |
|---|---|---|
/api/products/[id]/health/scores/weights/export | GET | 产品健康分、权重配置与导出 |
/api/products/[id]/schedules/[schedId] | GET / POST / PATCH | 研究/创意周期排程管理(每日、每周、cron) |
/api/products/[id]/ab-tests/[testId] | GET / POST | A/B 测试列表与创建 |
/api/products/[id]/ab-tests/[testId]/promote/conclude/cancel | POST | 胜出方案提升 / 结论 / 取消 |
/api/products/[id]/rollback | POST | 自动回滚 |
/api/products/[id]/activity/insights/costs | GET | 活动时间线、洞察、成本聚合 |
完整管线说明见 docs/HOW-THE-PIPELINE-WORKS.md。
Agent 管理与 Convoy 编队模式
Agent 目录与健康监控
| 端点 | 方法 | 用途 |
|---|---|---|
/api/agents | GET / POST | Agent 列表(自动核对在线/忙碌状态)/ 创建 |
/api/agents/[id] | GET / PATCH / DELETE | 详情、更新、移除 |
/api/agents/[id]/health | GET | 健康详情(卡顿、僵尸检测) |
/api/agents/[id]/health/nudge | POST | 手动"轻推"无响应的 Agent |
/api/agents/[id]/mail | GET / PATCH | 读写 Agent 信箱 |
/api/agents/[id]/openclaw | GET / POST / DELETE | 网关会话绑定与释放 |
/api/agents/discover | GET | 从 OpenClaw 网关发现可导入 Agent |
/api/agents/import | POST | 导入发现的 Agent |
/api/agents/health | GET | 全体 Agent 健康总览 |
Convoy 并行模式:大型功能被拆解为带依赖图(DAG)的子任务,由 3–5 个 Agent 并行执行:
| 端点 | 方法 | 用途 |
|---|---|---|
/api/tasks/[id]/convoy/dispatch | POST | 拆解并派发子任务编队 |
/api/tasks/[id]/convoy/progress | GET | 编队整体进度 |
/api/tasks/[id]/convoy/subtasks | GET / POST | 子任务列表与增补 |
/api/convoy/[convoyId]/mail | POST | 编队内部 Agent 间邮件 |
编排细节参见 docs/ORCHESTRATION_WORKFLOW.md。
成本追踪与实时事件流:预算帽 + SSE
成本端点(/api/costs)
| 端点 | 方法 | 用途 |
|---|---|---|
/api/costs | GET | 成本总览 |
/api/costs/event | POST | 上报一次成本事件(按 Agent/模型计) |
/api/costs/breakdown | GET | 按 Agent、模型、时段的多维明细 |
/api/costs/caps/caps/[id] | GET / POST / PATCH | 日/月预算帽的管理 |
/api/costs/caps/status | GET | 预算帽当前状态(超额自动暂停派发) |
实时事件流
| 端点 | 方法 | 用途 |
|---|---|---|
/api/events/stream | GET(SSE) | 全局事件广播:任务、Agent、成本、PR 创建,每 30 秒心跳保活 |
/api/tasks/[id]/agent-stream | GET(SSE) | 单任务 Agent 输出流 |
SSE 客户端接入支持把 token 作为查询参数传递(`/api/events/stream?token=*** 实时规范见 docs/REALTIME_SPEC.md,广播内核实现在 src/lib/events.ts。
Webhook、网关代理与运维端点
| 端点 | 方法 | 用途 |
|---|---|---|
/api/webhooks/agent-completion | POST | Agent 完成回调(HMAC 签名校验) |
/api/webhooks/github | POST | GitHub 事件(PR 状态等) |
/api/webhooks/jira | POST | Jira 同步事件 |
/api/jira/status | GET | Jira 集成状态 |
/api/openclaw/status/models | GET | 网关连接状态与可用模型 |
/api/openclaw/sessions/[id]/[id]/history | GET / POST | Agent 会话管理与历史回放 |
/api/files/upload/preview/download/reveal | 混合 | 文件上传、预览、下载与本地显示 |
/api/admin/backups/[id]/restore | GET / POST / DELETE | 备份列表、创建、删除与一键恢复 |
/api/admin/rollbacks | GET | 数据库回滚点 |
/api/health/health/metrics | GET | 服务健康与监控指标 |
/api/error-reports | GET / POST | 前端错误上报 |
/api/workspaces/[id]/knowledge/workflows | 混合 | 工作区、知识库与工作流模板 |
认证与安全速查:MC_API_TOKEN 规则
| 场景 | 规则 |
|---|---|
设置MC_API_TOKEN后 | 外部调用必须带Authorization: Bearer <token> |
| 浏览器 UI | 同源请求自动放行,无需手动处理 |
| SSE 流 | token 可走查询参数 |
| 未设置 token | API 认证关闭(仅限本地开发) |
Demo 模式(DEMO_MODE=true) | 所有写操作被拦截,只读 |
| Webhook | 使用WEBHOOK_SECRET做 HMAC 签名验证 |
认证中间件位于 src/middleware.ts,生产部署细节见 PRODUCTION_SETUP.md。
实战配方:用 3 个端点编排一次完整交付
第 1 步 · 创建并派发任务
curl -X POST http://localhost:4000/api/tasks \ -H "Authorization: Bearer $MC_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title": "优化首屏加载", "status": "assigned", "assigned_agent_id": "agent-uuid"}'第 2 步 · 监听 Agent 实时输出
curl -N "http://localhost:4000/api/tasks/<task-id>/agent-stream?token=$MC_API_TOKEN"第 3 步 · 轮询成本并检查预算帽
curl -H "Authorization: Bearer $MC_API_TOKEN" \ http://localhost:4000/api/costs/caps/status任务完成、测试、审查与 PR 创建会自动沿管线推进;若 Agent 掉线,系统会经由/api/agents/[id]/health/nudge的自动轻推机制或检查点恢复接管——全程无需人工干预。
延伸阅读:文档与源码索引
- 管线机制:docs/HOW-THE-PIPELINE-WORKS.md
- Agent 协作协议:docs/AGENT_PROTOCOL.md
- 实时事件规范:docs/REALTIME_SPEC.md
- 编排工作流:docs/ORCHESTRATION_WORKFLOW.md
- Convoy 编队规格:specs/convoy-mode-spec.md
- 产品 Autopilot 规格:specs/product-autopilot-spec.md
- 全部端点源码:src/app/api/
把这份速查表贴在工位上,你的 AI Agent 舰队就从"手动指挥"升级为"脚本驱动"了。 🚀
【免费下载链接】mission-controlThe world's first Autonomous Product Engine (APE): AI agents research your market, generate features, and ship code as PRs. Convoy mode, crash recovery, cost tracking, 80+ API endpoints. Self-hosted via OpenClaw Gateway.项目地址: https://gitcode.com/gh_mirrors/mission/mission-control
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考