任务管理 API

由 scripts/generate-api-docs.ts 自动生成 —— 请勿手改 共 33 个端点

POST /task

创建任务

请求体

{
  "$ref": "#/components/schemas/CreateTaskDto"
}

响应

状态码	说明
201

---

DELETE /task/{id}

删除任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /task/{id}

获取任务详情

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

PUT /task/{id}

更新任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/UpdateTaskDto"
}

响应

状态码	说明
200

---

GET /task/{id}/artifacts

获取产出物列表

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /task/{id}/artifacts/{fileName}/download

下载产出物

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅
fileName	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/execute

开始执行任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

GET /task/{id}/executions

获取执行历史

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/external-input

第三方要求补充材料后提交用户输入并恢复执行

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/SubmitExternalInputDto"
}

响应

状态码	说明
201

---

POST /task/{id}/external-input/answer

多轮补充资料：按题作答（每轮最多 2 项，全部答完才恢复执行）

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /task/{id}/pause

暂停执行

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /task/{id}/re-execute

重新执行任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/ReExecuteDto"
}

响应

状态码	说明
201

---

GET /task/{id}/results

获取任务结果

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/resume

恢复执行

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /task/{id}/resume-facts

P2：字段补充完成后恢复被挂起的执行（幂等）

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

DELETE /task/{id}/soft

软删除任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /task/{id}/status

获取执行状态

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /task/{id}/summary

获取当前需求总结

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/summary

提取需求总结

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /task/{id}/summary/confirm

确认需求总结

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/ConfirmSummaryDto"
}

响应

状态码	说明
201

---

GET /task/{id}/summary/history

获取总结历史

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/summary/regenerate

重新生成需求总结

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/RegenerateSummaryDto"
}

响应

状态码	说明
201

---

GET /task/{id}/trace

获取执行轨迹（L0 事件投影；DAG 与轨迹流同源）

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /task/{id}/with-dialog

获取任务及对话历史

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/workflow/generate

自动生成工作流

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /task/{id}/workflow/select

选择工作流

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

请求体

{
  "$ref": "#/components/schemas/SelectWorkflowDto"
}

响应

状态码	说明
201

---

GET /task/{id}/workflows

获取推荐的工作流

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /task/{id}/workflows/recommend

推荐工作流

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

GET /task/agent

Agent 查询任务——按 agentId 筛选，含审核状态

请求参数

参数名	位置	类型	必填	说明
agentId	query	string	✅

响应

状态码	说明
200

---

GET /task/by-dialog/{dialogId}

按 dialogId 反查任务（深链只带 dialogId 时用）

请求参数

参数名	位置	类型	必填	说明
dialogId	path	string	✅

响应

状态码	说明
200

---

GET /task/list

任务列表

请求参数

参数名	位置	类型	必填	说明
userId	query	string	—	用户ID
status	query	string	—	状态
workflowId	query	string	—	工作流ID

响应

状态码	说明
200

---

POST /task/marketplace

创建 Marketplace 任务（无需 Dialog）

响应

状态码	说明
201

---

GET /task/stats/user

获取用户任务统计

响应

状态码	说明
200

---