Run Agents Team¶
Runs a coordinated multi-agent conversation to solve a given task. You can add 1–31 agents and choose how the discussion proceeds (round-robin, LLM-selected next speaker, or orchestrator-managed). Returns the full conversation transcript and an optional concise summary.
Usage¶
Use this node to orchestrate collaboration among multiple specialized agents created with Create Agent. Connect one or more agent configs, define the task, choose the team type, and optionally cap length and duration. Ideal for complex problems that benefit from debate, tool-usage, or role specialization, with a final summarized answer if desired.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| agent_1 | True | AGENT | First team member configuration. Produced by Create Agent. | AGENT object from Create Agent (e.g., GPT-4o with WebSearcher tool and a Researcher role) |
| team_type | True | STRING | Defines the discussion flow: Cycle (round-robin turns), Smart (LLM selects next speaker based on context), Manage (an orchestrator manages who speaks when). | Cycle |
| task | True | STRING | The problem or objective for the agents to solve. Provide clear instructions and constraints. | Research the top three note-taking strategies for software engineers and propose a concise, actionable plan. |
| summarize | True | BOOLEAN | If true, the node will also produce a concise summary/answer to the task based on the conversation. | true |
| max_messages | True | INT | Maximum number of messages produced by the team. Use 0 for no limit. | 12 |
| max_timeout | True | INT | Maximum execution time in seconds for the team run. | 300 |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| messages | STRING | The complete transcript of the agents' conversation, formatted as markdown. | A multi-turn, markdown-formatted dialogue between the agents discussing and solving the task. |
| summary | STRING | A concise summary or final answer distilled from the conversation (may be empty or brief if summarization is disabled or not applicable). | Top three strategies summarized with a short action plan. |
Important Notes¶
- Agents must be created with Create Agent first and connected here as agent_1, agent_2, etc.
- You can run with a single agent if desired; additional agents are optional and appear incrementally as you connect them.
- team_type determines how turns are selected: Cycle (fixed order), Smart (context-aware selection), Manage (orchestrator-controlled).
- Set max_messages to 0 to allow unlimited conversation length within max_timeout.
- If summarize is disabled, the summary output may be empty or minimal.
Troubleshooting¶
- Conversation stops too early: increase max_messages or provide a clearer task to guide the discussion.
- Run times out: increase max_timeout or reduce the number of agents/complexity of the task.
- Summary is missing or too brief: ensure summarize is enabled and that the task clearly asks for actionable conclusions.
- Agents seem off-topic: refine each agent's role and system prompt in Create Agent, and provide a more specific task.
Example Pipelines¶
