Manage agents (Flows)

Playground

The Playground tab in the right panel gives you a live chat interface connected directly to the agent you're building. Send a message, watch the canvas animate as your sub-agents execute, and inspect the routing decisions — all without opening a separate window.

Opening the Playground

Click the Playground tab at the top of the right panel. The panel switches to a chat interface showing the model the entry sub-agent is using.

Save any unsaved changes before sending a message — the Playground runs the version currently saved on the server.

Sending messages

Type a message in the compose bar and press Enter or click the send button. The agent begins executing immediately.

While a run is in progress, the send button becomes a red Stop button. Click it to interrupt the run mid-stream.

Watching the canvas

The canvas animates in real time as the agent runs:

  • The entry node lights up first as the first sub-agent begins executing
  • When a transfer happens, the originating node dims and the receiving node activates
  • When a delegation happens, the delegating node stays active while the target node runs; control returns when the delegation completes
  • Connection arrows pulse briefly during each handoff

This makes routing decisions immediately visible — you can see exactly which sub-agent handled a message and in what order, without reading logs.

Routing timeline

When a run involved transfers or delegations, a routing timeline link appears below the assistant's response. Click it to open a detailed trace of every routing event: which sub-agent ran, at which step, how long it took, and whether any errors occurred.

Use the routing timeline when a response seems wrong or an agent routed unexpectedly — it shows you exactly where the conversation went.

Tool approval cards

If the flow's permission mode requires approval for a tool call, the Playground pauses and shows an approval card:

  • The tool name and its risk category
  • The exact inputs the agent wants to pass (shown in a code block)
  • Approve and Deny buttons, with an optional reason field

Approve to let the tool run and continue the stream. Deny to block it — the sub-agent receives a denial notification and can try another approach or explain the limitation to the user.

Approvals time out after five minutes. If you don't respond, the call is skipped and the agent is notified.

Permission mode indicator

A pill below the compose bar shows the current permission mode for the flow. If you want to test the agent with fewer interruptions, change the permission mode in Agent settings and save before testing.

Test routing before connecting tools

When building a new multi-agent flow, test the routing logic first using simple text-only sub-agents. Once transfers and delegations are working as expected, layer in tools and skills. This makes it much easier to isolate whether a problem is in routing or tool execution.