Limits & rules
Character limits, connection rules, and paging behavior across Agent Playground
These are the limits and validation rules Agent Playground enforces.
Naming
| Name | Maximum length | Cannot contain |
|---|---|---|
| Agent name | 255 characters | No restriction |
| Node name | 255 characters | . [ ] { } |
| Input name | 100 characters | No restriction |
| Output name | 100 characters | . [ ] { } |
A name that breaks one of these rules can’t be saved.
Connections
Break any of these and the connection won’t attach.
| Rule | Behavior |
|---|---|
| One source per input | An input accepts exactly one incoming connection; an output can feed any number of inputs |
| Direction | A connection always runs from an output to an input |
| Same version | Both connected nodes must belong to the same version |
| No loops | A 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.
| Rule | Behavior |
|---|---|
| Version status | Points only at an active or inactive version of another agent, never a draft |
| Self-reference | Cannot point at the agent it belongs to |
| One version per target agent | All 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 |
| Cycles | Cannot form a cycle of Agent Nodes pointing at each other |
Versions
Breaking any of these blocks the edit, the activation, or the run.
| Rule | Behavior |
|---|---|
| Editable | Only the draft version can be edited |
| Running version | Exactly one version of an agent runs at a time |
| Minimum versions | The last remaining version of an agent cannot be removed |
| Output names | Two outputs left unconnected can’t share a name within the same version |
| Required inputs | Every node’s required inputs must be present |
Runs
Statuses
| Level | Possible statuses |
|---|---|
| Run | pending, running, success, failed, cancelled |
| Node step | pending, running, success, failed, skipped |
Execution limits
| Limit | Value |
|---|---|
| Concurrent nodes | Up to 10 nodes run at the same time, per run |
| Step attempts | A step is retried automatically, up to 3 attempts, before it’s marked failed |
| Step timeout | A step is cut off after 1 hour if it hasn’t finished |
Lists
| List | Page size |
|---|---|
| All lists | 10 rows per page |
Keep exploring
Was this page helpful?
Questions & Discussion