|
| 1 | +--- |
| 2 | +title: Flows in Studio |
| 3 | +description: "Build event-driven workflows that combine deterministic, step-by-step control with agentic intelligence — no code required." |
| 4 | +icon: "diagram-project" |
| 5 | +mode: "wide" |
| 6 | +--- |
| 7 | + |
| 8 | +<Info> |
| 9 | +**Rolling out now**: Flows in Studio is being rolled out gradually during the week of July 20th, 2026. If you don't see the Flows option in Studio yet, it hasn't reached your organization — check back soon. |
| 10 | +</Info> |
| 11 | + |
| 12 | +## Overview |
| 13 | + |
| 14 | +Studio now supports building **Flows** in addition to Crews. Flows are event-driven workflows where you control exactly which steps run, in what order, and under what conditions — while still delegating the intelligent work within each step to AI agents. |
| 15 | + |
| 16 | +To build a Flow, open Studio, describe your automation, and select **Flows** from the selector next to the prompt box. |
| 17 | + |
| 18 | +<Frame> |
| 19 | +  |
| 20 | +</Frame> |
| 21 | + |
| 22 | +## Why Flows? |
| 23 | + |
| 24 | +Crews are great when you want a team of agents to collaborate autonomously toward a goal. But many real-world automations need more predictability: fetch this data first, then summarize it, then post the result — every time, in that order. |
| 25 | + |
| 26 | +Flows give you both: |
| 27 | + |
| 28 | +- **Determinism where it matters**: steps execute in a defined sequence with explicit branching, so runs are predictable, repeatable, and easy to debug. |
| 29 | +- **Intelligence where you need it**: each step is powered by an agent (or an entire crew), so the work inside a step — summarizing, scoring, drafting, deciding — benefits from full LLM reasoning. |
| 30 | + |
| 31 | +This mix is what makes Flows well suited for production automations: the structure is guaranteed, and the agency is scoped to the steps that need it. |
| 32 | + |
| 33 | +## Building a Flow |
| 34 | + |
| 35 | +Describe what you want in natural language and the Studio Assistant designs the Flow for you — creating the steps, wiring them together, and configuring the agents and app integrations each step needs. The canvas on the right shows the resulting workflow as connected nodes, and you can keep iterating conversationally or edit any node directly. |
| 36 | + |
| 37 | +<Frame> |
| 38 | +  |
| 39 | +</Frame> |
| 40 | + |
| 41 | +When you're ready, use **Run** to test the Flow end-to-end, inspect results in the **Output** and **Traces** tabs, and **Deploy** when it's stable. You can also **Share** the project or **Download** the source code. |
| 42 | + |
| 43 | +## Node Types |
| 44 | + |
| 45 | +Flows are composed from three core node types. Each node is a step in the workflow, and you can mix them freely. |
| 46 | + |
| 47 | +### Single Agent |
| 48 | + |
| 49 | +A Single Agent node runs one agent against one focused task — ideal for well-scoped steps like fetching data from an integration, transforming content, or posting a message. |
| 50 | + |
| 51 | +Clicking into an agent node opens its full configuration: |
| 52 | + |
| 53 | +- **Task**: what this step should accomplish and what output it should produce |
| 54 | +- **Profile**: the agent's role, goal, and backstory |
| 55 | +- **Model**: which LLM powers the agent |
| 56 | +- **Apps**: the integrations the agent can use (e.g. Linear, Slack, HubSpot) |
| 57 | +- **Runtime Controls**: toggles for planning before executing, delegation, and memory |
| 58 | + |
| 59 | +<Frame> |
| 60 | +  |
| 61 | +</Frame> |
| 62 | + |
| 63 | +### Crews |
| 64 | + |
| 65 | +A Crew node embeds an entire crew — multiple agents collaborating across multiple tasks — as a single step in your Flow. Use it when a step is too rich for one agent, like grouping and summarizing data by team and then formatting the result for delivery. |
| 66 | + |
| 67 | +<Frame> |
| 68 | +  |
| 69 | +</Frame> |
| 70 | + |
| 71 | +Opening a Crew node reveals its internal structure: the tasks it performs, the agents assigned to each, and the apps they use. The crew runs autonomously within the step, then hands its output to the next node in the Flow. |
| 72 | + |
| 73 | +<Frame> |
| 74 | +  |
| 75 | +</Frame> |
| 76 | + |
| 77 | +This is the deterministic-plus-agentic pattern in action: the Flow guarantees *when* the crew runs, and the crew brings collaborative intelligence to *how* the work gets done. |
| 78 | + |
| 79 | +### Router |
| 80 | + |
| 81 | +A Router node branches the Flow based on conditions, so different outcomes take different paths. For example, a lead-routing Flow can score incoming leads and then route high-quality leads to a sales-assignment step while logging the rest for future nurturing. |
| 82 | + |
| 83 | +<Frame> |
| 84 | +  |
| 85 | +</Frame> |
| 86 | + |
| 87 | +Routers are what make Flows genuinely event-driven: the same workflow handles every case, but each run follows only the branch its data warrants — no wasted steps, no ambiguity about what happens next. |
| 88 | + |
| 89 | +## Agent Repository Sync |
| 90 | + |
| 91 | +Agents you build in Flows don't have to stay locked inside a single project. Every agent node includes a **Publish to Agent Repository** button that saves the agent — its role, goal, backstory, model, and configuration — to your organization's [Agent Repository](/en/enterprise/features/agent-repositories). |
| 92 | + |
| 93 | +This works in both directions: |
| 94 | + |
| 95 | +- **Publish**: promote an agent you've refined in a Flow to the repository so other teams and projects can reuse it. |
| 96 | +- **Pull**: bring an existing repository agent into a new Flow instead of rebuilding it from scratch. |
| 97 | + |
| 98 | +Because repository agents are synced across your organization, an improvement made to a shared agent benefits every Flow that uses it — keeping agent behavior consistent, governed, and free of duplicated effort. |
| 99 | + |
| 100 | +## Best Practices |
| 101 | + |
| 102 | +- **Reach for a Flow** when the automation has a clear sequence or branching logic; reach for a Crew when the path to the goal is open-ended. |
| 103 | +- **Keep agent tasks focused** — a Single Agent node with a tight task description is more reliable than one asked to do three things. |
| 104 | +- **Use Routers to handle every case explicitly**, including the "do nothing" path (e.g. logging skipped leads), so runs are fully accounted for. |
| 105 | +- **Publish stable agents to the Agent Repository** so your organization builds a shared library instead of parallel one-offs. |
| 106 | +- **Test with Run and inspect Traces** before deploying to catch integration or prompt issues early. |
| 107 | + |
| 108 | +## Related |
| 109 | + |
| 110 | +<CardGroup cols={4}> |
| 111 | + <Card title="Crew Studio" href="/en/enterprise/features/crew-studio" icon="pencil"> |
| 112 | + Build Crews in Studio. |
| 113 | + </Card> |
| 114 | + <Card title="Agent Repositories" href="/en/enterprise/features/agent-repositories" icon="people-group"> |
| 115 | + Share and reuse agents across your organization. |
| 116 | + </Card> |
| 117 | + <Card title="Flows Concepts" href="/en/concepts/flows" icon="diagram-project"> |
| 118 | + Learn how Flows work in the CrewAI framework. |
| 119 | + </Card> |
| 120 | + <Card title="Tools & Integrations" href="/en/enterprise/features/tools-and-integrations" icon="plug"> |
| 121 | + Connect the apps your agents use. |
| 122 | + </Card> |
| 123 | +</CardGroup> |
0 commit comments