Working on the canvas

The canvas is where you lay out an AI Team: who the agents are, what the steps are, and what follows what. Everything on it saves as you go.

Adding things

The toolbar across the top adds one of each:

Add trigger · Add agent · Add task · Add action · Add condition · Add agents route

New agents land in a column on the left, steps in a column on the right, each below the last. Triggers go in a row above the Sequence, because a run flows downward and the thing that starts one belongs at the top. Move them wherever you like — where a node sits is remembered.

Joining two things

Every node has small dots on its edges. Drag from a dot on one node to a dot on another, and you have made a join. The line follows your cursor while you drag, so you can see it taking.

The canvas only allows the joins that mean something:

Actions and conditions have no agent handle. An action runs a tool with no model involved, and a condition decides by comparison — neither has anything for an agent to do.

A trigger has no dot on top at all. Nothing can come before the beginning, so there is nothing to draw into.

Each of these holds one value, so drawing a new join replaces the old one rather than sitting beside it. A task has one agent. A step has one thing that follows it.

Taking a join off

Right-click the line and choose Disconnect. It tells you what it is about to disconnect, so you know you have the right line.

Disconnecting an agent from a task leaves the task with nobody on it, and the task will say Pick an agent until you join one. That matters — see below.

Undo and redo

Ctrl+Z undoes, Ctrl+Shift+Z or Ctrl+Y redoes. There are buttons for both under the zoom controls in the corner.

They cover what the canvas itself does: moving nodes, making joins, taking them off. Adding and deleting whole nodes is a separate thing with its own confirmation, and starts the undo history again.

Moving around

The buttons in the bottom corner zoom in, zoom out, and fit everything on screen. Drag the background to move around; scroll to zoom.

The canvas stays where you put it while you work — it won't jump or re-centre itself when something saves.

A step with nobody on it

A task shows Pick an agent in red when no agent is joined to it.

This is worth taking seriously. A task with no agent does not run — it stops at that step, says so in the run trace, and the rest of the Sequence carries on without it. It used to be handed quietly to whichever agent happened to be first, which is how the wrong agent ends up writing a customer's apology.

Actions say Pick a tool for the same reason, routes say Add some exits, and a schedule with no rule says Set when it should run — it would never fire, and a pill that never fires should not look armed.

Questions people ask

Does it save? Yes, as you go. There is no save button for the canvas — moving a node or making a join is saved a moment later.

I dragged a line and nothing happened. You probably missed the dot. Drag from the small circle on the node's edge, not from the node itself — dragging the node body moves the node. If a line follows your cursor, you have it.

Can I delete a node? Right-click it and choose Delete. It asks first, because deleting a step also removes any joins into it.

Two steps point at the same next step. Is that allowed? Yes. Branches that rejoin are normal — three kinds of request can all end at the same "send the reply" step.

What happens to a step with nothing after it? The run ends there. Once anything on the canvas branches, every step's successor is the one you drew — nothing is assumed from the order they were added in.

Can I work on this from my phone? You can look, but building an AI Team wants a real screen. The canvas is a drag-and-drop surface.