> ## Documentation Index
> Fetch the complete documentation index at: https://comfyart.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent
> 能看懂你的画布、用真实工具在上面干活的设计 Agent。
左侧的 Agent 面板会在 ComfyUI 后端运行一个会用工具的 Agent。它能查看画布、规划设计、生成和编辑图片与视频，摆放文字、形状、画板、网页和幻灯片，向你提问确认，还会记住你的偏好。
## 模式
对话框下面的模式开关决定一条消息怎么处理：
* **Agent**：Agent 规划并用工具在画布上干活。需要先启用某个 Agent（见下文）。
* **图像** 和 **视频**：直接把提示词交给生成器，不经过 Agent，装好就能用。
在画布上选中图片可以把它们作为参考附上。输入 `/` 选择技能，输入 `@` 引用品牌套件、角色、产品或画布上的内容。
## 设置
Agent 默认是关闭的。从 Agent 选择菜单里打开 **Agent 设置**，勾选 **启用 MCP** 和 **启用 Agent**。
ComfyArt 使用本机上已经登录好的命令行 Agent，从不保存任何凭据。
| Agent | 需要什么 |
| - | - |
| Claude Code | PATH 里有 `claude`，并已登录 |
| Codex | PATH 里有 `codex`，并已登录 |
| Qwen Code | PATH 里有 `qwen`，并在 `~/.qwen/settings.json` 里配好模型 |
| DeepSeek Harness | PATH 里有 `dsh`，并已通过 DeepSeek Harness 应用登录 |
| 本地大模型 | 任何支持工具调用的 OpenAI 兼容接口，在 Agent 设置里填地址。需要密钥的话，启动 ComfyUI 前设置环境变量 `COMFYART_LOCAL_LLM_API_KEY`。 |
其他设置：
* **comfy-mcp**：可以同时挂载官方的 comfy-mcp，让 Agent 能查节点、模型和模板。
* **文字识别**：编辑文字和提取文字默认用 ComfyUI 里的本地 Gemma 4 模型识别，加载和识别时会显示进度。也可以切换成 **Agent**，交给默认 Agent 识别。
* **模型偏好**（对话框下面的按钮）：让 Agent 自动选模型，或给每类任务固定一个模型，图像和视频分开设置。
一些单次的小任务（分镜拆分、用 Agent 识别文字、提取品牌和记忆、参考图分析、Ideogram 描述）会直接交给默认 Agent，不带工具。
## 对话
* 对话保存在 SQLite 数据库（`user/__comfyart/data.db`）里，关掉面板也会继续运行。画布工具由该项目打开着的 ComfyArt 标签页执行，所以 Agent 工作时请保持这个标签页开着。
* 可以中途停止、编辑后重发消息、从某条消息分支出新对话、查看上下文用量，并打开每个结果的详情（过程、产出、原始提示词）。
* Agent 可以逐个画板检查画布、把评论汇总成修改计划，并帮你在画布上定位结果。
* 通知中心汇总建议、评论修改和已完成的任务；任务完成时还会弹浏览器通知。
* **语音输入** 用本地语音识别模型转文字。
## 技能
技能是一个文件夹，里面有一个 `SKILL.md` 和任意附加文件（图片、文本）。可以用内置技能、自己写、导入文件夹，或者把对话里的做法保存成技能。技能有版本历史，可以回滚。图片文件会给 Agent 看；文本文件会按相关性在上下文预算内收进去。
## 记忆
Agent 会跨项目记住你的信息：关于你、你的审美、你的工作方式和你的素材。它可以问你一些引导问题、从上传的文件里提取记忆；想改或想让它忘掉什么，直接在对话里说就行。演变日志会记录每次变化。
## 定时任务
ComfyArt 开着时，可以让某条 Agent 指令按计划（每天或每周）自动运行。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.