工作流 / DAG API

工作流以 DAG（有向无环图） 与 长任务（LongTask） 形式存在。

⚠️ 退役提示：个人版 /api/v1/dag 全系 5 条路由已于最新版本退役（返回 410 Gone）。DAG 现仅作为对话式任务分解（task_decompose）的内部执行体，不再暴露独立 HTTP 接口。请改用自然语言对话或下方 长任务（/api/v1/longtask） 接口编排自动化。

重要事实：代码层面不存在 /api/workflows/templates、/api/workflows/execute、/api/workflows/approve 这类路由。工作流没有可视化画布或拖拽编辑器，通过自然语言（对话）或长任务 API 创建。真实路径前缀为 /api/v1/longtask 与 /api/v1/evolution/workflows/*（DAG 内部执行体不再独立暴露）。

版本说明：DAG / 长任务基础能力两者都提供；/api/v1/dag/stream（SSE 流式执行）与 /api/v1/dag/:dagID/resume 为个人版独有；企业版 DAG 由 Temporal 驱动。自进化工作流（/api/v1/evolution/workflows/*）为个人版独有。

---

DAG ⚠️ 已退役（410 Gone）

个人版 /api/v1/dag 全系路由已退役。以下为历史参考，当前版本不再可用；请改用对话式任务或长任务接口。

POST /api/v1/dag

创建并启动一个 DAG 工作流（请求体描述节点与依赖）。

curl -X POST http://localhost:19824/api/v1/dag \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "信息搜集流程",
    "nodes": [ { "id": "n1", "type": "llm", "prompt": "调研 X" } ],
    "edges": []
  }'

GET /api/v1/dag

DAG 列表。

GET /api/v1/dag/:dagID

获取 DAG 执行结果。

POST /api/v1/dag/:dagID/resume

个人版独有。从检查点恢复执行。

POST /api/v1/dag/stream

个人版独有。SSE 流式执行 DAG（逐节点推送进度与结果），首帧心跳，终止帧 data: [DONE]\n\n。

---

长任务（LongTask）

POST /api/v1/longtask

创建长任务。

GET /api/v1/longtask

长任务列表。

GET /api/v1/longtask/:taskID

长任务详情。

生命周期控制

POST /api/v1/longtask/:taskID/{pause,resume,cancel,approve,reject} —— 暂停 / 恢复 / 取消 / 审批通过 / 审批拒绝（两者都提供）。

---

自进化工作流（个人版独有）

组前缀 /api/v1/evolution/workflows/*：

方法	路径	说明
GET	/blueprints	进化蓝图列表
GET	/blueprints/:name/versions	某蓝图版本
GET	/versions/:id	版本详情
POST	/versions/:id/apply	应用版本（蓝绿）
POST	/versions/:id/revert	回滚版本
GET	/versions/:id/diff	版本差异
GET	/traces	进化追踪
POST	/analyze	触发分析

---

调度（定时触发）

方法	路径	说明
POST	/api/v4/scheduler/create	创建定时任务（cron/一次性）
GET	/api/v4/scheduler/list	列表
DELETE	/api/v4/scheduler/:id	删除
PATCH	/api/v4/scheduler/:id/pause	暂停
PATCH	/api/v4/scheduler/:id/resume	恢复
POST	/api/v4/scheduler/:id/execute-now	立即执行

---

错误码

场景	code	message
DAG 不存在	40400	DAG 不存在
长任务不存在	40400	长任务不存在
任务已结束	42200	任务已完成或已取消