> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-stale2000-comfy-agent-guides.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Comfy Agent
> Use Comfy Agent to understand, build, edit, and run ComfyUI workflows.
Comfy Agent is an assistant inside ComfyUI. It can build and edit workflows, explain nodes, inspect media, fix validation errors, and run the finished workflow.
## What it can do
* Find templates, models, and nodes available in your ComfyUI environment.
* Build a workflow from a template and customize its prompts and settings.
* Change part of the current workflow without rebuilding the rest.
* Add, connect, configure, and remove nodes.
* Validate a workflow before running it.
* Inspect images and read video or audio properties.
* Run workflows and return their outputs.
## Where you can use it
| Where you use Comfy Agent | What to expect |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Comfy Cloud** | The Agent, workflows, and assets use your Comfy Cloud account. There is no local package to install. |
| **Comfy Desktop** | The Agent works with the ComfyUI installation on your machine, including its workflows, models, and custom nodes. |
| **Network connection** | Agent requests use Comfy services. See [Data and privacy](/agent-tools/in-app-agent-data-privacy). |
Comfy Agent is separate from [Comfy MCP](/agent-tools/mcp) and [Comfy CLI](/agent-tools/cli). MCP connects an external AI client to Comfy. The CLI is for terminal and script workflows. Comfy Agent works in the ComfyUI interface.
To make your first image, follow [Get started with Comfy Agent](/agent-tools/in-app-agent-installation#make-your-first-image).
## Choose which workflow to edit
Use the workflow selector in the Agent panel to choose the workflow to edit, then send your message. Switching to another tab while the Agent is responding does not redirect its edits.
The Agent cannot create or switch tabs itself. To work elsewhere, open the other workflow, choose it in the Agent panel, and send a new message.
The Agent can read another open or saved workflow for comparison without loading it into the current tab. For example:
> Compare this workflow with my portrait workflow and use the same sampler settings here.
## Build and edit workflows
For a new workflow, open a blank workflow tab and choose it in the Agent panel. The Agent searches for a matching template before building from individual nodes. A template includes a connected graph and an output node.
For changes to an existing workflow, name the part you want changed and what should stay the same:
* “Change the prompt to a watercolor landscape. Keep the model and sampler settings.”
* “Add an upscaling stage after image generation.”
* “Switch this workflow to Flux using models installed here.”
## Validate before running
The Agent checks node connections, model names, required values, and output nodes before a run. It separates workflow errors from inputs that only you can provide.
If the workflow is valid but still needs an image, video, or other input, attach the file and ask the Agent to continue.
## Work with media
The Agent can inspect the visible contents and dimensions of a still image. For video, it can read the duration, dimensions, frame rate, and format. For audio, it can read the duration, format, and audio tracks.
Use **Attach a file** in the message box to add an image or file. You can also drag media into the conversation.
| Add to the conversation | Ask | Result |
| ------------------------- | -------------------------------------- | ------------------------------------------------ |
| An image | “Describe the lighting in this image.” | A description you can use to refine your prompt. |
| A video | “Trim this to the first five seconds.” | A shortened video file. |
| Two video clips | “Join clip A followed by clip B.” | One video containing both clips in that order. |
| A video and an audio file | “Add this audio to the video.” | A video with the supplied audio. |
Media editing requires the media tools to be available in your installation. In Cloud, edited files are saved to your asset library. The Agent returns a preview or file link in the conversation.
## Run permissions
Choose a run permission next to the message box:
* **Ask** requests approval before each workflow run.
* **Auto** runs workflows without asking for each run.
Select **Save changes** to apply your choice. In Ask mode, select **Run** in the approval message to start the workflow, or **Cancel** to decline that run.
Ask and Auto control workflow runs. The Agent can edit the selected workflow in either mode.
## What the Agent can use
The Agent uses your message, selected workflow, selected nodes, attachments, and workflow errors. It can also read another workflow when you ask it to compare or reuse settings.
For Cloud and local data flow, chat history, and privacy controls, see [Comfy Agent data and privacy](/agent-tools/in-app-agent-data-privacy).
## Stop or cancel
Select **Stop** in the message box to stop the Agent's current response. Workflow execution has separate controls in the [run and queue area](/interface/overview); use those to manage a workflow that has already been submitted.
## Next steps
Build, run, and revise an image workflow.
Create and use reusable Agent instructions.
## Access
Request access to Comfy Agent.
## Feedback
Have a problem or an idea? [Send feedback](https://links.comfy.org/agentalphafeedback) about Comfy Agent.