> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Agent

> 使用 Comfy Agent 理解、构建、编辑和运行 ComfyUI 工作流。已在 Comfy Cloud 中正式可用；Comfy Desktop 的本地支持即将推出。

<Note>
  **Comfy Agent 现已在 Comfy Cloud 中全面可用**。Comfy Desktop 本地版中的 Agent 即将推出。[加入候补名单](https://links.comfy.org/agentalpha)即可收到通知。
</Note>

直接在 ComfyUI 中描述你的需求。它会规划、构建并运行工作流。它会在你工作时编辑画布，与你并肩创作。

## 它可以做什么

* 查找你的 ComfyUI 环境中可用的模板、模型和节点。
* 基于模板构建工作流，并自定义其提示词和设置。
* 修改当前工作流的一部分，而无需重建其余部分。
* 添加、连接、配置和移除节点。
* 在运行之前验证工作流。
* 查看图像并读取视频或音频属性。
* 运行工作流并返回其输出。
* 在 Agent 响应期间，你可以继续在画布上操作：无需等待它完成，它会基于你当前打开的内容进行工作。
* 用自然语言创建技能，或者让 Agent 使用 Comfy 的公开技能，而不只是使用你自己的技能。参见 [Agent skills](/zh/agent-tools/in-app-agent-skills)。
* 同时打开多个对话。每个对话都是独立的会话，拥有自己的历史和上下文。

## 可以在哪里使用

| 使用 Comfy Agent 的位置 | 预期情况 |
| - | - |
| **Comfy Cloud** | 已全面可用。Agent、工作流和资产都使用你的 Comfy Cloud 账户。无需安装任何本地包。 |
| **Comfy Desktop** | **即将推出。**[加入候补名单](https://links.comfy.org/agentalpha)，以便在 Comfy Agent 支持本地 ComfyUI（包括你自己的模型和自定义节点）时收到通知。 |

无论使用哪种方式，Agent 的请求都会通过网络使用 Comfy 服务。请参阅[数据和隐私](/zh/agent-tools/in-app-agent-data-privacy)。

Comfy Agent 与 [Comfy MCP](/zh/agent-tools/mcp) 和 [Comfy CLI](/zh/agent-tools/cli) 是相互独立的。MCP 将外部 AI 客户端连接到 Comfy。CLI 用于终端和脚本工作流。Comfy Agent 在 ComfyUI 界面中工作。

要生成你的第一张图像，请按照[开始使用 Comfy Agent](/zh/agent-tools/in-app-agent-installation#制作你的第一张图像)操作。

## 费用是多少

免费初始 token 现已面向所有人开放，可用于试用多次 Comfy Agent 聊天。之后，Comfy Agent 会从你已用于生成任务的同一份 Comfy 积分池中扣费。你需要 Comfy 积分余额为正才能继续运行 Agent，但不一定需要订阅套餐。套餐详情请参见[订阅与充值套餐](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=agent)。

### 每个 token 的价格

| 模型 | 输入积分 / 1K | 5m 缓存写入积分 / 1K | 1h 缓存写入积分 / 1K | 缓存命中积分 / 1K | 输出积分 / 1K |
| :- | -: | -: | -: | -: | :- |
| Opus 4.8 | 1.055 | 1.319 | 2.110 | 0.106 | 5.275 |

## 本地版即将推出

一旦 Comfy Agent 登陆 Comfy Desktop，它就能使用你自己的 GPU、模型和自定义节点，并引导你完成设置。它还将超越目前云端已有的功能：直接在画布上为你构建自定义编辑工具，例如一次性使用的遮罩或合成工具，无需额外安装。

<Card title="加入候补名单" icon="list" href="https://links.comfy.org/agentalpha">
  当 Comfy Agent 在 Comfy Desktop 上可用时获取通知。
</Card>

## 选择要编辑的工作流

使用 Agent 面板中的工作流选择器选择要编辑的工作流，然后发送消息。在 Agent 响应期间切换到其他标签页不会重定向其编辑。

Agent 无法自行创建或切换标签页。若要在其他位置操作，请打开另一个工作流，在 Agent 面板中选择它，然后发送新消息。

Agent 可以读取另一个已打开或已保存的工作流用于比较，而无需将其加载到当前标签页。例如：

> 将此工作流与我的肖像工作流进行比较，并在此处使用相同的采样器设置。

## 构建和编辑工作流

对于新工作流，请打开一个空白工作流标签页，并在 Agent 面板中选择它。Agent 在从单个节点构建之前，会先搜索匹配的模板。模板包含一个连通的节点图和一个输出节点。

若要修改现有工作流，请说明要更改的部分以及应保持不变的部分：

* “将提示词改为水彩风景。保留模型和采样器设置。”
* “在图像生成之后添加一个图像放大阶段。”
* “使用此处已安装的模型将此工作流切换为 Flux。”

在你继续编辑画布的同时，Agent 会实时在画布上进行构建。

<h2 id="validate-before-running">
  运行前验证
</h2>

Agent 会在运行前检查节点连接、模型名称、必填值以及输出节点。它会将工作流错误与只能由你提供的输入区分开来。

如果工作流有效但仍需要图像、视频或其他输入，请附加文件并让 Agent 继续。

## 处理媒体

Agent 可以检查静态图像的可见内容和尺寸。对于视频，它可以读取时长、尺寸、帧率和格式。对于音频，它可以读取时长、格式和音轨。

使用消息输入框中的 **附加文件** 来添加图像或文件。你也可以将媒体拖入对话。

| 添加到对话 | 提问 | 结果 |
| - | - | - |
| 一张图像 | “描述这张图像中的光照。” | 一段可用于完善提示词的描述。 |
| 一个视频 | “将其裁剪为前五秒。” | 一个缩短后的视频文件。 |
| 两个视频片段 | “将片段 A 与紧随其后的片段 B 拼接。” | 一个按该顺序包含这两个片段的视频。 |
| 一个视频和一个音频文件 | “将此音频添加到视频中。” | 一个带有所提供音频的视频。 |

媒体编辑需要你的安装环境中具备媒体工具。在云端，编辑后的文件会保存到你的资产库。Agent 会在对话中返回预览或文件链接。

## 运行权限

在消息框旁边选择一个运行权限：

* **询问**：在每次运行工作流之前请求批准。
* **自动**：运行工作流时无需每次询问。

选择 **保存更改** 以应用你的选择。在询问模式下，选择审批消息中的 **运行** 以启动工作流，或选择 **取消** 以拒绝该次运行。

询问和自动用于控制工作流运行。在任一模式下，Agent 都可以编辑已选择的工作流。

## Agent 可以使用什么

通常情况下，在一次聊天会话中，Agent 会使用你的消息、已选择的工作流、已选择的节点、附件以及工作流错误。当你要求它比较或复用设置时，它还可以读取另一个工作流。

此外，Agent 还可以访问当前工作区中已保存的工作流、可用模型和可用节点，以及公共模板工作流和公共/私有技能，这些内容都会在需要时被使用。

关于云端和本地数据流、聊天历史以及隐私控制，请参阅 [Comfy Agent 数据与隐私](/zh/agent-tools/in-app-agent-data-privacy)。

## 停止或取消

在消息框中点击 **Stop**，即可停止 Agent 当前的回复。工作流执行在[运行与队列区域](/zh/interface/overview)中有独立的控制项；若要管理已提交的工作流，请使用这些控件。

## 下一步

<CardGroup cols={2}>
  <Card title="制作你的第一张图像" icon="play" href="/zh/agent-tools/in-app-agent-installation#制作你的第一张图像">
    构建、运行并修改图像工作流。
  </Card>

  <Card title="Agent 技能" icon="wand-magic-sparkles" href="/zh/agent-tools/in-app-agent-skills">
    创建并使用可复用的 Agent 指令。
  </Card>
</CardGroup>

## 反馈

Comfy Agent 目前处于测试版。我们正在积极开发新功能并修复问题。告诉我们哪些功能好用、哪些不好用，这是帮助我们确定优先构建内容的最佳方式。

* 反馈：[https://links.comfy.org/agentfeedback](https://links.comfy.org/agentfeedback)
* Discord：加入我们的[服务器](https://discord.com/invite/comfyorg)，并在 #comfy-agent 通道找到我们

<Card title="发送反馈" icon="message" href="https://links.comfy.org/agentalphafeedback">
  反馈 bug 或分享你的感受。
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.