LyncoreLyncore
Lyncore

工作流 / DAG API ​

工作流以 DAG（有向无环图） 与对话式任务分解两种形态存在。

重要事实：代码层面不存在 /api/workflows/templates、/api/workflows/execute、/api/workflows/approve、/api/v1/longtask 这类路由。工作流没有可视化画布或拖拽编辑器，通过自然语言（对话）创建与执行。

版本说明：DAG 由企业版提供真实 HTTP 接口（Temporal 驱动，仅 POST /api/v1/dag、GET /api/v1/dag、GET /api/v1/dag/:dagID 3 条）。个人版保留 /api/v1/dag 410 Gone 占位路由（含 dag/stream、dag/:dagID/resume 子路由）——路由已注册、handler 恒返回 410 Gone，仅作引导提示，不代表接口可用。stream/resume 两个子路由企业版也未注册（handler 存在但未接线，返回 404）。DAG 在个人版中作为对话式任务分解（task_decompose）的内部执行引擎活跃运行，但不对外暴露独立 HTTP 接口。自进化工作流（/api/v1/evolution/workflows/*）为个人版独有。

DAG — 企业版真实可用 / 个人版 410 占位 ​

以下端点在企业版可用（Temporal 驱动，注册于租户路由组）；在个人版均已注册但恒返回 410 Gone，响应体为引导用户改用 task_decompose 工具的提示。

POST /api/v1/dag ​

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

版本：[企业] 可用；[个人] 410 Gone。

bash
curl -X POST http://localhost:8080/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 ​

从检查点恢复执行。

版本说明：该子路由企业版并未注册——企业版 DAG 组仅挂载 3 条路由（POST /api/v1/dag、GET /api/v1/dag、GET /api/v1/dag/:dagID），resume 虽有 handler 方法实现但未接线，调用返回 404。个人版注册了该子路由但恒返回 410 Gone。不要依赖此接口。

POST /api/v1/dag/stream ​

SSE 流式执行 DAG（逐节点推送进度与结果）。

版本说明：与 resume 同——企业版未注册该子路由（handler 存在但未接线，调用返回 404）；个人版注册但恒返回 410 Gone。当前代码中 DAG 流式进度无可用 HTTP 入口。SSE 帧格式与事件 type 取值见 API 概览 · 流式响应。

长任务（LongTask）— 已随重构移除 ​

重要事实：代码层面不存在 /api/v1/longtask 这一路由。LongTask（长任务）能力已随工作流重构整体移除，相关实现与用例均已删除。

如果你在旧文档中看到 POST/GET /api/v1/longtask、POST /api/v1/longtask/:taskID/{pause,resume,cancel,approve,reject}，那属于过时且不符合代码的写法，请以本说明为准。

替代方案：

需求替代路径
多步骤自动化编排对话式任务分解（task_decompose 工具），或企业版 DAG API
查看/控制运行中的任务任务中心 /api/v4/tasks（见 任务与目标 API）
定时/周期触发调度器 POST /api/v4/scheduler/create

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

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

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

其余自进化端点（/api/v1/evolution/{status,audit,heal,insights,rules,skills,watchdog/check,curator/scan}）见 自进化 API。

调度（定时触发） ​

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

错误码 ​

场景codemessage
DAG 不存在40400DAG 不存在
任务已结束42200任务已完成或已取消
个人版调用 DAG410（HTTP）端点已废弃，请改用 task_decompose 工具