Agent Basics
Write a scoped request and distinguish conversation from a canvas change.
Open the canvas Agent
The canvas sidebar contains the Director Agent button. The panel sits beside your graph; it is not the same thing as a node Run control.
- Open a project and click the Agent icon in the left dock.
- Keep the target nodes visible while composing a request.
Give an actionable brief
State the output, the source material, the target nodes and constraints. “Make a 10-second vertical teaser from the selected product image; keep the logo unchanged” is clearer than “improve this.”
- Select or attach the relevant reference.
- Type the goal in the composer and press Enter; use Shift+Enter for a new line.
Understand possible replies
The Agent can respond with dialogue, a creation plan, an edit plan, an organization plan, a built-in Skill proposal or a tool result. A reply alone does not mean the suggested nodes already exist.
- If asked for clarification, answer with concrete constraints.
- If a preview card appears, review it before choosing an apply action.
Avoid accidental scope changes
Selected canvas nodes and attached media are sent as context. In Smart mode, selection can steer the Agent toward editing rather than creating.
- Clear unintended canvas selection before asking for a completely new workflow.
- For an edit, name the selected node and say what must remain unchanged.
When nothing changes
A dialogue reply may be informational, or a proposal may still be waiting for approval. Provider failures appear as an error rather than silently placing a workflow.
- Check whether a preview card offers Apply now or Apply changes.
- Read the panel error, then retry with a smaller, more specific request.
Example: brainstorm before building
Asking “Compare two directions for a quiet product film” may return dialogue rather than a canvas patch. Follow with an explicit build request once you pick a direction.
- Ask for two concise creative directions and select one.
- Then request “Create a small editable node workflow for direction A.”
If voice entry is unavailable
The microphone button relies on browser speech recognition and permission. It fills the instruction text; it is not a guarantee of media transcription or voice generation.
- If the button is disabled, type the request instead.
- If permission is denied, check browser microphone permission before trying again.