Docs menu
On this page

Agent

The Agent node writes your prompts for you. Connect it to the nodes that make your content, tell it what you want, and every time you hit Run it writes one prompt for each of those nodes: a different prompt for Scene 1 than for Scene 2, and something new next time.

It only writes prompts. It never adds, deletes, or reconnects anything on your canvas.

Inputs and outputs

Inputs (all optional): Text for a brief coming from another node, Images, Video, and a generic Flow input for connecting from earlier nodes. The Video input only shows up when the model you picked can watch video (the Gemini models can), or when a video is already wired in.

Output: a single Prompts handle. Connect it to anything that takes a prompt, such as Image Generation, Video Generation, Voice Generation, or LLM. Each connected node gets its own prompt, written for what that node makes: a composed still for an image, movement and camera for a video, the actual words for text.

Connecting it to a node that does not take a prompt (Compose or Output, for example) costs you nothing. It is skipped.

Writing the brief

Type what you want into the box at the bottom of the card. Every run needs one: your instructions and its memory shape what it writes, but they never decide what this run is about. That stays yours. A Text node wired into the agent's Text input counts as the brief too, so a brief can come from earlier in the workflow.

The card shows how many prompts it will write when you hit Run, then shows each prompt it wrote, labelled with the node it went to.

Naming the nodes it writes for

The agent reads the names on your nodes as intent, so renaming them is the fastest way to steer it. "Scene 1", "Scene 2" and "Scene 3" become consecutive moments in one piece. "Hook" and "Payoff" become two different jobs. "B-Roll" becomes supporting footage rather than the subject.

Leave them unnamed and it treats them as an ordered set and gives them a progression anyway.

Memory

Click the brain icon in the settings bar to open Memory.

  • Your instructions: style, tone, format, subjects to stick to or stay away from. The agent follows these on every run and writes them into every prompt it produces, so the node downstream hears them too. This is yours: the agent reads it and can never change it.
  • What it has made here: one line per run, newest first, describing what was distinctive about it. This is how it avoids giving you the same thing twice. You can delete any entry, or clear the lot, but you cannot edit them: they are a record of what happened.

Memory belongs to the workflow, so each workflow builds up its own.

Images and video

Wire images or video in and the agent uses them as reference for what it writes.

It works from your file names and the tags added automatically when you upload, which is usually enough to tell one asset from another and costs you nothing. When an image has no name and no tags, it opens it and looks, up to three times per run. Naming your assets keeps that from happening. An image made earlier in the same run has no name yet, so it is one of the ones it opens.

Video is different: only some models can watch one (the Gemini models can), so the Video input only appears when your chosen model can. If you wire a video and later switch to a model that cannot watch it, the connection stays, the run still works, the agent goes by the file name instead, and the node's warnings tell you so and name what to switch to.

Choosing a model

Click the model picker in the settings bar. The default is Claude Sonnet 4.6, or the closest equivalent on your provider. The agent runs on fal.ai, OpenRouter, and Kie AI alike.

Running the node

Select the node to reveal its Run button. Running the whole workflow writes the prompts and passes each one straight to the node it was written for, so everything downstream starts together.

Testing just this node writes prompts and shows them to you without adding anything to its memory, so you can try a brief as many times as you like without using up its sense of what it has already made.

Tips

  • If a run comes back with something missing, click the Inputs / Outputs button (the eye icon) to see exactly what it wrote and any warnings it left.
  • An agent connected to nothing that takes a prompt does not run a model at all, so an unfinished canvas costs you nothing.
  • Nothing you write in your instructions can change what the agent is allowed to do. It writes prompts, and only prompts.