# Get started with Agent

> Use Nodespell Agent, the in-product assistant, to explain your graph, make edits, and prepare generations that run only after you approve them.

Source: https://docs.nodespell.com/agent/ · Last updated: 2026-11-10

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

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](https://docs.nodespell.com/start/workspace-modes/). For panels, see the [interface tour](https://docs.nodespell.com/start/interface/).

## 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**.

1. 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](https://docs.nodespell.com/agent/context-and-references/).

2. 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**.

3. Type a request in the message box, for example "Add an upscaler after this image and connect it." Press `Enter` to send it. Press `Shift+Enter` to start a new line.

4. 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.

5. 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.

6. Review the graph. If you don't want a change Agent made, undo it with `Cmd/Ctrl+Z` like any other graph edit.

## 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](https://docs.nodespell.com/agent/what-agent-can-do/).

## 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](https://docs.nodespell.com/agent/sessions-and-models/).

## Frequently asked questions

### 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?

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?

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?

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.

## Related

  - [Modes and approvals](https://docs.nodespell.com/agent/behavior-modes-and-approvals/): Ask, Plan, and Edit, and which actions always need your approval.
  - [Context and references](https://docs.nodespell.com/agent/context-and-references/): Include nodes, mention them with @, and attach reference files.
  - [Generate with Agent](https://docs.nodespell.com/agent/generate-with-agent/): Estimates, run approvals, and the Results tab.
  - [Sessions and models](https://docs.nodespell.com/agent/sessions-and-models/): Conversations, the Agent model, credits, and Stop, Steer, and Resume.
  - [What Agent can do](https://docs.nodespell.com/agent/what-agent-can-do/): Every capability, with example requests and limits.
