Agents

Build and edit agents on the canvas

The agent builder displays every step on a canvas with a permanent right sidebar. You build and edit the agent directly on the canvas—the sidebar never closes, and it updates to show the details or editor for whichever node you select.

Canvas layout

When you open an agent, the canvas shows the step graph on the left and the right sidebar on the right. The sidebar is always visible and cannot be dismissed.

  • Canvas: The node-and-edge graph of the agent.

  • Sidebar: Details and editing controls for the selected node.

Enter and exit edit mode

To change an agent, click Edit on the agent page. The canvas stays in place and enters edit mode. The sidebar becomes the editor for whichever node you select. When you are finished, click Save or Cancel.

Save and Cancel semantics are unchanged. Validation still runs before a save is applied.

Edit on the canvas

While in edit mode, the canvas shows editing controls directly on the graph and on each node.

Add a step

Click the circled + button on any edge to insert a new step between the two connected nodes. Inserting on a branch edge inserts the step into that branch and retargets the branch accordingly.

Delete or reorder a step

Hover over a step node to reveal the editing controls:

  • Click the X to delete the step.

  • Click the up or down chevrons to move the step earlier or later in the flow.

Edit titles and descriptions inline

While editing, the agent title and description are editable inline in the page header. Click the title or description to change them.

Right-click context menu

Right-click a node or edge to open a context menu with additional editing actions.

The right sidebar shows the full editor for whichever node is selected. It has the same fields as the previous form editor:

  • Input nodes: fields, kinds, choices, defaults, required flags, keys, and the attached-context editor with file picker, upload, playbooks, and reviews.

  • Step nodes: name, instructions, type picker, human-input prompt and key, condition branches, expressions, targets, skip lists, rejoin, and decision key.

  • Output nodes: label, kind, description, source step and key, plus add and remove controls.

Run page sidebar behavior

When you open an agent run, the sidebar opens to the Inputs panel by default. If a step is currently waiting on human input, the sidebar shows that step instead so the resume form is immediately visible. Clicking any node on the run graph overrides both defaults and shows that node’s details in the sidebar.

Visual language on the canvas

  • Edges render under nodes and are orthogonal everywhere. Condition branches split from a shared stem and run vertically with a branch label on each leg.

  • Skipped or cancelled steps are shown as muted, faded cards instead of displaying a status icon.

  • The agent description appears directly under the agent title with a Show more affordance to expand the full text.

  • Result blocks in the sidebar use a left-rule style instead of boxed cards.

Viewport and navigation

The canvas opens anchored to the input node at the top center at zoom 1. If you resize the window, the canvas re-anchors until you pan, zoom, or click. Click the Controls fit button to return to a full-overview view of the entire agent.

Was this helpful?
Was this helpful?