Overview
This node creates a "crew" in the CrewAI system, which is a group of agents assigned to execute multiple tasks collaboratively. It allows users to define how these agents work together by selecting different process types such as sequential execution, hierarchical orchestration with a manager agent, or consensual decision-making among agents.
Common scenarios where this node is beneficial include:
- Automating complex workflows that require multiple AI agents to perform distinct tasks.
- Coordinating task execution strategies depending on project needs (e.g., step-by-step vs. managed delegation).
- Experimenting with collaborative AI agent behaviors for research or development purposes.
Practical example:
- A user wants to create a crew of AI agents where tasks are executed one after another (sequential). They connect agent data and task data into the node, specify the crew name, and run the workflow to instantiate this crew in the CrewAI platform.
Properties
| Name | Meaning |
|---|---|
| Crew Name | Name or identifier for the crew being created. |
| Process Type | How the crew executes tasks: - Sequential: Tasks run one after another in order. - Hierarchical: A designated manager agent orchestrates task execution. - Consensual: Agents reach consensus to execute tasks. |
| Manager Agent ID | (Only if Hierarchical) The ID of the agent acting as the manager for the hierarchical process. |
| Advanced Options | Collection of advanced settings: - Verbose Logging: Enable detailed logs. - Max Iterations: Maximum number of iterations allowed. - Enable Cache: Whether to cache operations. - Output Log File: File path to save execution logs. |
| Collaboration Options | Settings controlling agent collaboration: - Enable Sharing: Allow agents to share information. - Share Results: Share task results between agents. - Enable Delegation: Allow agents to delegate tasks to others. |
| Report Issue | Notice with links to report bugs or get support. |
| Request Feature | Notice with links to request new features or enhancements. |
Output
The node outputs a JSON object representing the created crew as returned by the CrewAI API. This includes details such as the crew's name, associated agent IDs, task IDs, process type, and any other metadata returned from the API.
The output is structured as an array with one item containing the crew creation response JSON.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the CrewAI API.
- Depends on the external CrewAI service endpoint
/crewsto create crews. - Uses internal helper functions for making authenticated API requests and validating inputs.
Troubleshooting
Error: "At least one agent must be connected to the Agents input."
Occurs if no agent data is connected to the second input. Ensure you connect at least one valid agent item.Error: "At least one task must be connected to the Tasks input."
Happens if no task data is connected to the third input. Connect at least one valid task item.Error: "No valid agent IDs found in the connected agents."
The connected agent items do not contain recognizable agent ID fields (agent_idorid). Verify the input data structure.Error: "No valid task IDs found in the connected tasks."
Similar to above but for tasks. Check that task items havetask_idorid.Validation Error: Missing required "Crew Name".
The crew name property is mandatory; provide a non-empty string.If the node fails due to API errors, check your API key credential and network connectivity.