news 2026/10/8 15:37:48

Mission Control 80+ API端点速查手册:程序化编排AI Agent工作流的完整参考

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Mission Control 80+ API端点速查手册:程序化编排AI Agent工作流的完整参考

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 构建,每个路由文件对应一个端点。接入只需三步:

  1. 本地或 Docker 启动服务:npm install后执行npm run dev,服务默认运行在http://localhost:4000;
  2. 设置 API 令牌:在.env.local中配置MC_API_TOKEN(建议用openssl rand -hex 32生成)。配置后,外部调用必须携带请求头Authorization: Bearer <token>,浏览器同源请求则自动放行;
  3. 发起第一个调用:
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/tasks37+CRUD、规划问答、派发、检查点、Convoy
产品自动驾驶/api/products50+研究、创意、滑动决策、A/B 测试、排程
Agent 管理/api/agents9目录、健康监控、信箱、网关发现
成本管控/api/costs6事件上报、预算帽、明细报表
实时事件流/api/events2SSE 广播、任务级 Agent 流
Convoy 编队/api/convoy1+编队邮件通信
文件服务/api/files4上传、预览、下载、在 Finder 中显示
网关代理/api/openclaw6模型、会话、历史、状态
外部集成/api/webhooks、/api/jira4Agent 完成回调、GitHub/Jira 事件
运维管理/api/admin、/api/health7备份恢复、回滚、健康指标

任务编排端点:创建、派发与崩溃恢复

任务是全系统的核心实体,覆盖看板 7 个状态列(PLANNING → INBOX → ASSIGNED → IN PROGRESS → TESTING → REVIEW → DONE)。

端点方法用途
/api/tasksGET / POST列表(支持status、workspace_id、assigned_agent_id过滤)/ 创建
/api/tasks/[id]GET / PATCH / DELETE查询、更新状态与字段、删除
/api/tasks/[id]/dispatchPOST派发给 Agent(OpenClaw 会话或 Codex CLI 运行)
/api/tasks/[id]/dispatch/retryPOST派发失败后重试
/api/tasks/[id]/planningGET获取规划阶段状态与澄清问题
/api/tasks/[id]/planning/answerPOST回答 AI 的澄清问题
/api/tasks/[id]/planning/approvePOST批准规划规格(审批门)
/api/tasks/[id]/planning/pollGET轮询规划进度
/api/tasks/[id]/planning/force-completePOST强制完成规划
/api/tasks/[id]/checkpointGET / POST查看 / 保存检查点
/api/tasks/[id]/checkpoint/restorePOST崩溃后从检查点恢复,而非从零重来
/api/tasks/[id]/checkpointsGET检查点历史列表
/api/tasks/[id]/chatGET / POST操作员聊天(排队备注 + 实时直达消息)
/api/tasks/[id]/chat/agentsGET可对话的 Agent 列表
/api/tasks/[id]/agent-streamGET(SSE)该任务的 Agent 实时输出流
/api/tasks/[id]/costsGET单任务成本明细
/api/tasks/[id]/flight-recorderGET任务"飞行记录仪"审计轨迹
/api/tasks/[id]/pr-checks/pr-checks/retryGET / POSTPR 检查状态与失败重跑
/api/tasks/[id]/deliverablesGET任务交付物
/api/tasks/unreadGET未读消息计数

派发逻辑的完整实现见 src/app/api/tasks/[id]/dispatch/route.ts 与 src/lib/server-dispatch.ts。

产品自动驾驶端点:研究 → 创意 → 滑动 → 排程

Autopilot 管线(RESEARCH → IDEATION → SWIPE → BUILD → PR)的每一步都有对应端点,全部位于/api/products下:

研究与创意

端点方法用途
/api/productsGET / POST产品列表 / 创建(含仓库预检repo_preflight)
/api/products/[id]/research/runPOST触发一次市场研究(竞品、SEO、用户意图)
/api/products/[id]/research/cyclesGET研究周期历史
/api/products/[id]/ideation/runPOST触发创意生成(含影响分/可行性评分)
/api/products/[id]/ideation/cyclesGET创意周期历史
/api/products/[id]/ideas/ideas/pendingGET创意列表 / 待处理创意
/api/products/[id]/ideas/[ideaId]GET / PATCH / DELETE创意详情与修改
/api/products/[id]/similarityGET创意去重相似度检测

滑动决策与 Maybe 池

端点方法用途
/api/products/[id]/swipe/deckGET取一张创意卡(类 Tinder 界面)
/api/products/[id]/swipePOST执行滑动:Pass / Maybe / Yes / Now!
/api/products/[id]/swipe/[swipeId]/undoPOST撤销滑动
/api/products/[id]/swipe/batchPOST批量决策
/api/products/[id]/swipe/history/statsGET滑动历史与偏好统计
/api/products/[id]/maybe/evaluatePOST批量重评 Maybe 池
/api/products/[id]/maybe/[ideaId]/resurfacePOST创意到期重新浮出

健康度、排程与 A/B 测试

端点方法用途
/api/products/[id]/health/scores/weights/exportGET产品健康分、权重配置与导出
/api/products/[id]/schedules/[schedId]GET / POST / PATCH研究/创意周期排程管理(每日、每周、cron)
/api/products/[id]/ab-tests/[testId]GET / POSTA/B 测试列表与创建
/api/products/[id]/ab-tests/[testId]/promote/conclude/cancelPOST胜出方案提升 / 结论 / 取消
/api/products/[id]/rollbackPOST自动回滚
/api/products/[id]/activity/insights/costsGET活动时间线、洞察、成本聚合

完整管线说明见 docs/HOW-THE-PIPELINE-WORKS.md。

Agent 管理与 Convoy 编队模式

Agent 目录与健康监控

端点方法用途
/api/agentsGET / POSTAgent 列表(自动核对在线/忙碌状态)/ 创建
/api/agents/[id]GET / PATCH / DELETE详情、更新、移除
/api/agents/[id]/healthGET健康详情(卡顿、僵尸检测)
/api/agents/[id]/health/nudgePOST手动"轻推"无响应的 Agent
/api/agents/[id]/mailGET / PATCH读写 Agent 信箱
/api/agents/[id]/openclawGET / POST / DELETE网关会话绑定与释放
/api/agents/discoverGET从 OpenClaw 网关发现可导入 Agent
/api/agents/importPOST导入发现的 Agent
/api/agents/healthGET全体 Agent 健康总览

Convoy 并行模式:大型功能被拆解为带依赖图(DAG)的子任务,由 3–5 个 Agent 并行执行:

端点方法用途
/api/tasks/[id]/convoy/dispatchPOST拆解并派发子任务编队
/api/tasks/[id]/convoy/progressGET编队整体进度
/api/tasks/[id]/convoy/subtasksGET / POST子任务列表与增补
/api/convoy/[convoyId]/mailPOST编队内部 Agent 间邮件

编排细节参见 docs/ORCHESTRATION_WORKFLOW.md。

成本追踪与实时事件流:预算帽 + SSE

成本端点(/api/costs)

端点方法用途
/api/costsGET成本总览
/api/costs/eventPOST上报一次成本事件(按 Agent/模型计)
/api/costs/breakdownGET按 Agent、模型、时段的多维明细
/api/costs/caps/caps/[id]GET / POST / PATCH日/月预算帽的管理
/api/costs/caps/statusGET预算帽当前状态(超额自动暂停派发)

实时事件流

端点方法用途
/api/events/streamGET(SSE)全局事件广播:任务、Agent、成本、PR 创建,每 30 秒心跳保活
/api/tasks/[id]/agent-streamGET(SSE)单任务 Agent 输出流

SSE 客户端接入支持把 token 作为查询参数传递(`/api/events/stream?token=*** 实时规范见 docs/REALTIME_SPEC.md,广播内核实现在 src/lib/events.ts。

Webhook、网关代理与运维端点

端点方法用途
/api/webhooks/agent-completionPOSTAgent 完成回调(HMAC 签名校验)
/api/webhooks/githubPOSTGitHub 事件(PR 状态等)
/api/webhooks/jiraPOSTJira 同步事件
/api/jira/statusGETJira 集成状态
/api/openclaw/status/modelsGET网关连接状态与可用模型
/api/openclaw/sessions/[id]/[id]/historyGET / POSTAgent 会话管理与历史回放
/api/files/upload/preview/download/reveal混合文件上传、预览、下载与本地显示
/api/admin/backups/[id]/restoreGET / POST / DELETE备份列表、创建、删除与一键恢复
/api/admin/rollbacksGET数据库回滚点
/api/health/health/metricsGET服务健康与监控指标
/api/error-reportsGET / POST前端错误上报
/api/workspaces/[id]/knowledge/workflows混合工作区、知识库与工作流模板

认证与安全速查:MC_API_TOKEN 规则

场景规则
设置MC_API_TOKEN后外部调用必须带Authorization: Bearer <token>
浏览器 UI同源请求自动放行,无需手动处理
SSE 流token 可走查询参数
未设置 tokenAPI 认证关闭(仅限本地开发)
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),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/8 15:35:01

openGym管理员后台完全指南:邀请码、审计日志与用户管理

openGym管理员后台完全指南&#xff1a;邀请码、审计日志与用户管理 【免费下载链接】openGym Self-hosted gym & body-weight tracker — plan routines, log workouts (supersets, warm-ups, cardio), see which muscles are trained, fatigued or detrained, import fro…

作者头像 李华
网站建设 2026/10/8 15:34:58

FPGA红外解码实战:DE2-115平台NEC协议状态机设计

把 DE2-115 这块板子拿来跑红外解码&#xff0c;是我带 FPGA 课程设计时最常推荐的题目之一。原因很简单&#xff1a;红外遥控器常见、成本低、现象直观&#xff0c;但要把 NEC 协议在硬件上完整走一遍&#xff0c;涉及边沿检测、时序测量、状态机、移位寄存器、数码管显示甚至…

作者头像 李华
网站建设 2026/10/8 15:34:44

ClaudeCode本地开发环境配置实战:从VS Code到Nginx代理

1. 这不是又一个“AI编程工具课”&#xff0c;而是一份能直接上手写项目的实操手册 你点开这个标题&#xff0c;大概率是被“B站讲得最好”“薪资翻倍”这些词勾住的。但说实话&#xff0c;我去年帮三个团队做AI辅助开发落地时&#xff0c;翻遍了全网视频——从2023年早期的Cod…

作者头像 李华
网站建设 2026/10/8 15:34:27

AI编程助手进阶:用superpowers技能包打造高效人机协作工作流

很多开发者第一次听说 superpowers 时&#xff0c;都会下意识觉得这是某个“锦上添花”的小工具&#xff0c;但实际上它是一套能直接改变你与 AI 协作方式的能力扩展包。我在自己的项目里用了一段时间之后&#xff0c;最大的感受就是&#xff1a;以前 AI 只是帮我写代码&#x…

作者头像 李华
网站建设 2026/10/8 15:34:18

大模型上下文管理实战:context-mode设计与翻车排查

先说一个我前阵子差点通宵的事&#xff1a;一个跑得顺顺当当的AI客服Demo&#xff0c;对话到第二十轮&#xff0c;模型突然像失忆一样&#xff0c;把用户最开始提的“预算1500以内&#xff0c;要白色降噪耳机”忘得干干净净&#xff0c;开始推荐上万的旗舰款。我的第一反应是换…

作者头像 李华
网站建设 2026/10/8 15:32:32

同一条 SQL 为什么会跑出完全不同的执行计划,理解 SAP HANA 中数据对 SQL Optimizer 的影响

在 SAP S/4HANA 项目里,经常会遇到一种很容易让开发人员困惑的性能问题。 一条 SQL 在开发系统里执行只需要几十毫秒,进入测试系统后依然表现正常,可到了生产系统,同样的 SQL 突然执行几秒甚至几十秒。代码没有变化,CDS View 没有变化,WHERE 条件看上去也完全一样,可通…

作者头像 李华