> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务

> 工作流的一次执行。在哪里找到你的输出，以及如何跟踪进度。

**任务**是工作流的一次运行。你从工作流的详情页提交它（也可以从你的 AI 客户端通过 MCP 提交，或者从脚本提交）；Cloud 把它调度到你团队的某个代理上；结果落到任务自己的页面上。

## 找到你的输出

一旦任务到达 **completed**，它的详情页会显示一个 **Outputs** 面板——工作流产出的每个文件（图像、视频、模型文件、JSON，任何代理上传的内容）对应一个条目。

* 点击图片可预览；点击下载图标可保存。
* 暂不支持批量下载——如果你需要自动化，请用 [API](/zh/api-reference/introduction) 或 webhook。
* 输出链接是短期有效的签名 URL。如果下载返回 token 过期错误，刷新任务页面即可——Cloud 每次都会铸造新的 URL。

输出在生产部署上无限期保留在对象存储中；保留策略按部署设置。如果你找不到旧任务的输出，去 **Tasks** 列表看看——已完成的运行会一直留在那里，连同结果，直到你团队的保留策略将它们移除。

## 跟踪实时进度

任务详情页会在代理运行时流式推送进度。实时日志、步数计数器、部分预览——任何工作流运行时输出的内容——产生后一秒内就会出现。

如果你的网络阻塞了 server-sent events，页面会回退到轮询。两种方式下你都不需要手动刷新。

## 生命周期

每个任务会经过以下状态：

| 状态               | 含义                             |
| ---------------- | ------------------------------ |
| **pending**      | Cloud 已接收任务。调度器尚未取走。           |
| **waiting**      | 调度器已取走，但目前没有符合条件的代理可用。         |
| **provisioning** | 正在准备一个代理来承接任务。                 |
| **queued**       | 已选定一个代理。等待代理确认。                |
| **running**      | 代理正在执行工作流。                     |
| **completed**    | 干净结束。输出可用。                     |
| **failed**       | 出错、超时或代理断开。详情页显示错误原因以及最后的日志几行。 |
| **cancelled**    | 在到达终态前被取消。                     |

`completed`、`failed` 和 `cancelled` 是终态——任务不会再前进。

## 取消任务

* **取消单个任务**：打开任务详情页，点击 **Cancel**。
* **取消多个任务**：在 **Tasks** 列表中多选行，使用批量操作栏。

取消正在运行的任务会请求代理停止；运行时干净地结束，已产生的产物仍然会上传。取消已排队的任务是即时的——还没开始运行。

## 再次运行

针对单个任务的重新运行功能正在开发中。目前，要再次运行同一个工作流，打开该工作流的详情页并点击 **Run**——运行对话框会记住你上次运行的参数，让你从上次的位置继续。每次运行都会创建一个新任务；之前的任务作为历史保留在 **Tasks** 列表中。

## 从代码或 AI 客户端驱动

* **代码**：参见[生成 API 密钥](/zh/cloud/guides/api-key) ——REST 运行时端点。
* **AI 客户端（Claude Code、Cursor 等）**：参见[通过 MCP 连接](/zh/cloud/guides/connect-mcp)。
* **通知**：订阅 [webhook](/zh/cloud/guides/webhooks)，让你的后端在任务完成时做出反应，不必轮询。

## 相关

* [工作流](/zh/cloud/concepts/workflows) ——任务所基于的模板。
* [代理](/zh/cloud/concepts/agents) ——执行任务的主体。
* [通知](/zh/cloud/concepts/notifications) ——任务结果的应用内通知。