Limits & rules

Character limits, connection rules, and paging behavior across Agent Playground

These are the limits and validation rules Agent Playground enforces.

Naming

NameMaximum lengthCannot contain
Agent name255 charactersNo restriction
Node name255 characters. [ ] { }
Input name100 charactersNo restriction
Output name100 characters. [ ] { }

A name that breaks one of these rules can’t be saved.

Connections

Break any of these and the connection won’t attach.

RuleBehavior
One source per inputAn input accepts exactly one incoming connection; an output can feed any number of inputs
DirectionA connection always runs from an output to an input
Same versionBoth connected nodes must belong to the same version
No loopsA connection cannot create a cycle, and a node cannot connect to itself

Agent Nodes

See Agent Node for what it is.

Breaking any of these means the node can’t be saved with that target.

RuleBehavior
Version statusPoints only at an active or inactive version of another agent, never a draft
Self-referenceCannot point at the agent it belongs to
One version per target agentAll Agent Nodes in a version that point at the same target agent must point at the same version of it, for example Agent B v3, not v3 and v4 together
CyclesCannot form a cycle of Agent Nodes pointing at each other

Versions

Breaking any of these blocks the edit, the activation, or the run.

RuleBehavior
EditableOnly the draft version can be edited
Running versionExactly one version of an agent runs at a time
Minimum versionsThe last remaining version of an agent cannot be removed
Output namesTwo outputs left unconnected can’t share a name within the same version
Required inputsEvery node’s required inputs must be present

Runs

Statuses

LevelPossible statuses
Runpending, running, success, failed, cancelled
Node steppending, running, success, failed, skipped

Execution limits

LimitValue
Concurrent nodesUp to 10 nodes run at the same time, per run
Step attemptsA step is retried automatically, up to 3 attempts, before it’s marked failed
Step timeoutA step is cut off after 1 hour if it hasn’t finished

Lists

ListPage size
All lists10 rows per page

Keep exploring

Was this page helpful?

Questions & Discussion