> ## 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.

# 工作流

> 定义在代理上运行什么的可复用执行模板。

**工作流**是平台可以运行的某类工作的模板。它把以下内容打包到一起：

* 一个底层运行时（例如一个 ComfyUI 图或一条 Nerfstudio 管线）。
* 调用方提交任务时填入的参数。
* 派发任务时所需要的代理标签。

当你提交任务时，你选择一个工作流并为它的参数提供值。派发会基于标签挑选一个符合条件的代理。

## 工作流的来源

全新团队的工作流列表是空的。你可以通过两种方式添加工作流：

1. **团队工作流** ——团队成员通过控制台创建，通常是导入一份 ComfyUI 图 JSON。
2. **向导生成的工作流** ——对部分管线，Cloud 提供一个表单式向导，无需手动编辑 JSON 就能生成工作流。参见[运行 Nerfstudio 工作流](/zh/cloud/guides/nerfstudio)。

## 参数

参数是工作流暴露给调用方的有类型输入。一个 ComfyUI 文生图图通常会有：

| 参数         | 类型      | 备注                    |
| ---------- | ------- | --------------------- |
| `prompt`   | string  | 正向提示词。                |
| `negative` | string  | 可选的反向提示词。             |
| `seed`     | integer | 随机种子。复用同一种子可以重现输出。    |
| `steps`    | integer | 采样步数。                 |
| `model`    | string  | 代理上可用的 checkpoint 名称。 |

Cloud 中的工作流详情页展示实时的参数表单。在 API 中你能在 `GET /workflows/{workflowId}` 看到相同的结构。

## 标签要求

工作流会列出它的任务所需要的标签：

```yaml theme={null}
workflow:
  name: comfy-text-to-image
  labels:
    - gpu
    - comfyui
```

只有那些标签集合是上述列表**超集**的代理才符合条件。一个拥有标签 `gpu, comfyui, nerfstudio` 的代理符合上面的要求。一个只有 `gpu` 的代理不符合。

如果工作流要求的标签没有被满足，对应任务会一直停留在 **queued**。Cloud 会在任务界面把这种情况显示为 “waiting for eligible agent”。给某个代理补上缺失的标签（或连接一个新代理）即可解除阻塞。

## 快照

当你的部署启用了快照时，工作流的每次保存都会自动创建一个带版本的定义快照。在详情页的 **History** 面板，你可以：

* 预览旧快照的 JSON 和参数结构。
* 把工作流恢复到旧快照（带确认）。

恢复时不会删除快照——它们会持续累积，让你随时回退。当列表变长时，History 面板会分页。

完整演练参见[工作流快照](/zh/cloud/guides/workflow-snapshots)。

## 编辑与重新运行

编辑工作流的参数不会追溯性地改变过去的任务——每个任务都会携带它提交时的参数快照。重新运行任务时使用工作流的当前定义，除非你明确指向某个快照。

## 相关

* [任务](/zh/cloud/concepts/tasks) ——单次执行实例。
* [代理](/zh/cloud/concepts/agents) ——标签与派发。
* [工作流快照](/zh/cloud/guides/workflow-snapshots) ——版本化。
* [运行 Nerfstudio 工作流](/zh/cloud/guides/nerfstudio) ——向导示例。