Team Step
Run one of your teams of agents as a workflow step.
The Team Step node (team_step) runs one of your teams — several agents coordinated by a lead — as a single step, and hands its final answer to the next node.
Configuration
| Field | Type | Default | Description |
|---|---|---|---|
teamId | string | — | The team to run. It must belong to the workflow's organization. |
teamName | string | — | The team's name, kept for display. |
inputExpression | string | '' | What to send the team, using the {{ }} syntax. Empty forwards what reached the node, the same way the AI Agent node does. |
The team's coordination mode, lead, members, history and context settings (including Add date/time to context) are the team's own, as configured in the Team Builder.
Output
| Field | Type | Description |
|---|---|---|
text | string | The team's final answer. |
teamId | string | The team that ran. |
runId | string | null | The team run's id, for the team's own trace. |
sessionId | string | null | The session the run used. |
tokenUsage.prompt | number | Prompt tokens, across every member. |
tokenUsage.completion | number | Completion tokens, across every member. |
latencyMs | number | How long the step took. |
Limits and errors
The node fails when no team is selected, the team belongs to another organization, the team's lead cannot run, or the team reaches its iteration limit without an answer. Every member's model calls count against the run's budget.
Example
name: Incident review
description: Has the review team assess each incident report.
graph:
nodes:
- id: report
type: trigger_manual
position: { x: 0, y: 0 }
data:
description: Paste the incident report as `report`.
- id: review
type: team_step
position: { x: 280, y: 0 }
data:
team: teams.incident-review
teamName: Incident review
inputExpression: '{{ trigger.report }}'
edges:
- { id: report-to-review, source: report, target: review }In a Package
Declare the team under teams: in the manifest; the node references it as teams.<name>.
- Travels:
teamName,inputExpression - Converted:
teamId→team(ateams.<name>reference) - Never carried: none
Add teams to compatibility.requiredCapabilities so an organization without Teams is refused before install.