Agent is the AI assistant built into Nodespell. In a conversation, Agent can explain what a graph does, find and change nodes, connect them, and prepare a generation. Agent never spends credits on a generation without your approval. In the app, Agent lives in the Assistant panel.
Open the Assistant panel
Section titled “Open the Assistant panel”Agent works with the Project that is open. It reads and changes the graph that the Graph Editor shows, so keep a graph visible while you work with it. The table lists every way to open the panel.
| Where you are | How to open Agent |
|---|---|
| Graph mode | Open the add-panel menu in any panel area and choose Automation > Assistant. |
| Any mode, from the menu bar | Window > New Panel Window > Assistant opens Agent as a floating window. |
| Command palette | Run Add Assistant Panel. |
| Create mode | Select Assistant in the tool rail. |
| Immersive mode | Select Assistant in the tool rail. |
If Agent reports Open a graph panel first., open a Graph Editor and send the request again. To learn more about the modes, see Workspace modes. For panels, see the interface tour.
Walk through a first request
Section titled “Walk through a first request”A new conversation opens with What would you like to create? and a few suggested requests under Try. The suggestions change to match what you have selected. For example, with an image node selected, one suggestion is Turn the selected image into a video.
-
Select one or more nodes on the canvas if your request is about them. Then select the Include selected nodes chip above the message box. Agent only knows about the nodes you include. See Context and references.
-
Check the mode menu next to the + button. Edit is the default. It lets Agent make changes to your graph. To ask questions without making changes, choose Ask.
-
Type a request in the message box, for example “Add an upscaler after this image and connect it.” Press
Enterto send it. PressShift+Enterto start a new line. -
Watch the progress steps while Agent reads the graph and works. When the turn ends, Agent summarizes what it did. Select a referenced node chip to move the canvas to that node.
-
If Agent shows a Needs your approval card, read what it wants to do, then select Approve or Deny. Deleting nodes and starting a paid generation always ask first.
-
Review the graph. If you don’t want a change Agent made, undo it with
Cmd/Ctrl+Zlike any other graph edit.
What can Agent do, and what can’t it do?
Section titled “What can Agent do, and what can’t it do?”| Agent can | Agent can’t |
|---|---|
| Explain a graph, a node, or how a branch is connected | Change the graph in Ask or Plan mode |
| Find nodes in your Project and in the node and Creative Tool catalogs | Spend credits on a generation without your approval |
| Create, duplicate, rename, configure, connect, and disconnect nodes | Delete nodes or switch a Creative Tool’s model without your approval |
| Create a Creative Tool and switch its model | Edit inside the Timeline or a compositor, or arrange the layout for you |
| Find Project Assets and place them on the graph | Use Snippets or Custom Nodes, or import from the web |
| Estimate, prepare, start, track, and cancel a run | Work on a different Level while a request is running |
For the complete list, with an example request for each action, see What Agent can do.
Does Agent cost credits?
Section titled “Does Agent cost credits?”Yes. Every Agent request uses credits for Agent’s own reasoning. The cost depends on the Agent model you choose and on how much work the request takes. A generation that Agent starts uses credits the same way a run you start yourself does. Both kinds of charge appear in the Usage tab of the Tasks panel. See Sessions and models.
Frequently asked questions
Section titled “Frequently asked questions”Is Agent the same as the Assistant panel?
Section titled “Is Agent the same as the Assistant panel?”Yes. Agent is Nodespell’s name for the assistant, and Assistant is the label on the panel and tool rail button that opens it.
Does Agent see my whole graph?
Section titled “Does Agent see my whole graph?”No. Agent gets the nodes you include in a message. When it needs more, Agent looks up other parts of the Project, and the steps it takes appear in the conversation.
Can Agent run a generation by itself?
Section titled “Can Agent run a generation by itself?”No. Agent can estimate and prepare a run, but it must ask for your approval before the run starts. You see an approval card, and nothing runs until you select Approve.
Can I undo something Agent did?
Section titled “Can I undo something Agent did?”Yes. You can undo Agent’s graph edits with Cmd/Ctrl+Z. Undo does not reverse a generation that has already started. You can ask Agent to cancel a run, or cancel it in the Tasks panel.