feat: Introduce production-ready Flows and Crews architecture with ne… (#4003)

* feat: Introduce production-ready Flows and Crews architecture with new runner and updated documentation across multiple languages.

* ko and pt-br for tracing missing links

---------

Co-authored-by: Greyson LaLonde <greyson.r.lalonde@gmail.com>

docs/en/introduction.mdx

@@ -7,110 +7,89 @@ mode: "wide"
 
 # What is CrewAI?
 
-**CrewAI is a lean, lightning-fast Python framework built entirely from scratch—completely independent of LangChain or other agent frameworks.**
+**CrewAI is the leading open-source framework for orchestrating autonomous AI agents and building complex workflows.**
 
-CrewAI empowers developers with both high-level simplicity and precise low-level control, ideal for creating autonomous AI agents tailored to any scenario:
+It empowers developers to build production-ready multi-agent systems by combining the collaborative intelligence of **Crews** with the precise control of **Flows**.
 
-- **[CrewAI Crews](/en/guides/crews/first-crew)**: Optimize for autonomy and collaborative intelligence, enabling you to create AI teams where each agent has specific roles, tools, and goals.
-- **[CrewAI Flows](/en/guides/flows/first-flow)**: Enable granular, event-driven control, single LLM calls for precise task orchestration and supports Crews natively.
+- **[CrewAI Flows](/en/guides/flows/first-flow)**: The backbone of your AI application. Flows allow you to create structured, event-driven workflows that manage state and control execution. They provide the scaffolding for your AI agents to work within.
+- **[CrewAI Crews](/en/guides/crews/first-crew)**: The units of work within your Flow. Crews are teams of autonomous agents that collaborate to solve specific tasks delegated to them by the Flow.
 
-With over 100,000 developers certified through our community courses, CrewAI is rapidly becoming the standard for enterprise-ready AI automation.
+With over 100,000 developers certified through our community courses, CrewAI is the standard for enterprise-ready AI automation.
 
+## The CrewAI Architecture
 
-## How Crews Work
+CrewAI's architecture is designed to balance autonomy with control.
+
+### 1. Flows: The Backbone
 
 <Note>
-  Just like a company has departments (Sales, Engineering, Marketing) working together under leadership to achieve business goals, CrewAI helps you create an organization of AI agents with specialized roles collaborating to accomplish complex tasks.
-</Note>
-
-<Frame caption="CrewAI Framework Overview">
-  <img src="/images/crews.png" alt="CrewAI Framework Overview" />
-</Frame>
-
-| Component | Description | Key Features |
-|:----------|:-----------:|:------------|
-| **Crew** | The top-level organization | • Manages AI agent teams<br/>• Oversees workflows<br/>• Ensures collaboration<br/>• Delivers outcomes |
-| **AI Agents** | Specialized team members | • Have specific roles (researcher, writer)<br/>• Use designated tools<br/>• Can delegate tasks<br/>• Make autonomous decisions |
-| **Process** | Workflow management system | • Defines collaboration patterns<br/>• Controls task assignments<br/>• Manages interactions<br/>• Ensures efficient execution |
-| **Tasks** | Individual assignments | • Have clear objectives<br/>• Use specific tools<br/>• Feed into larger process<br/>• Produce actionable results |
-
-### How It All Works Together
-
-1. The **Crew** organizes the overall operation
-2. **AI Agents** work on their specialized tasks
-3. The **Process** ensures smooth collaboration
-4. **Tasks** get completed to achieve the goal
-
-## Key Features
-
-<CardGroup cols={2}>
-  <Card title="Role-Based Agents" icon="users">
-    Create specialized agents with defined roles, expertise, and goals - from researchers to analysts to writers
-  </Card>
-  <Card title="Flexible Tools" icon="screwdriver-wrench">
-    Equip agents with custom tools and APIs to interact with external services and data sources
-  </Card>
-  <Card title="Intelligent Collaboration" icon="people-arrows">
-    Agents work together, sharing insights and coordinating tasks to achieve complex objectives
-  </Card>
-  <Card title="Task Management" icon="list-check">
-    Define sequential or parallel workflows, with agents automatically handling task dependencies
-  </Card>
-</CardGroup>
-
-## How Flows Work
-
-<Note>
-  While Crews excel at autonomous collaboration, Flows provide structured automations, offering granular control over workflow execution. Flows ensure tasks are executed reliably, securely, and efficiently, handling conditional logic, loops, and dynamic state management with precision. Flows integrate seamlessly with Crews, enabling you to balance high autonomy with exacting control.
+  Think of a Flow as the "manager" or the "process definition" of your application. It defines the steps, the logic, and how data moves through your system.
 </Note>
 
 <Frame caption="CrewAI Framework Overview">
   <img src="/images/flows.png" alt="CrewAI Framework Overview" />
 </Frame>
 
-| Component | Description | Key Features |
-|:----------|:-----------:|:------------|
-| **Flow** | Structured workflow orchestration | • Manages execution paths<br/>• Handles state transitions<br/>• Controls task sequencing<br/>• Ensures reliable execution |
-| **Events** | Triggers for workflow actions | • Initiate specific processes<br/>• Enable dynamic responses<br/>• Support conditional branching<br/>• Allow for real-time adaptation |
-| **States** | Workflow execution contexts | • Maintain execution data<br/>• Enable persistence<br/>• Support resumability<br/>• Ensure execution integrity |
-| **Crew Support** | Enhances workflow automation | • Injects pockets of agency when needed<br/>• Complements structured workflows<br/>• Balances automation with intelligence<br/>• Enables adaptive decision-making |
+Flows provide:
+- **State Management**: Persist data across steps and executions.
+- **Event-Driven Execution**: Trigger actions based on events or external inputs.
+- **Control Flow**: Use conditional logic, loops, and branching.
 
-### Key Capabilities
+### 2. Crews: The Intelligence
+
+<Note>
+  Crews are the "teams" that do the heavy lifting. Within a Flow, you can trigger a Crew to tackle a complex problem requiring creativity and collaboration.
+</Note>
+
+<Frame caption="CrewAI Framework Overview">
+  <img src="/images/crews.png" alt="CrewAI Framework Overview" />
+</Frame>
+
+Crews provide:
+- **Role-Playing Agents**: Specialized agents with specific goals and tools.
+- **Autonomous Collaboration**: Agents work together to solve tasks.
+- **Task Delegation**: Tasks are assigned and executed based on agent capabilities.
+
+## How It All Works Together
+
+1.  **The Flow** triggers an event or starts a process.
+2.  **The Flow** manages the state and decides what to do next.
+3.  **The Flow** delegates a complex task to a **Crew**.
+4.  **The Crew**'s agents collaborate to complete the task.
+5.  **The Crew** returns the result to the **Flow**.
+6.  **The Flow** continues execution based on the result.
+
+## Key Features
 
 <CardGroup cols={2}>
-  <Card title="Event-Driven Orchestration" icon="bolt">
-    Define precise execution paths responding dynamically to events
+  <Card title="Production-Grade Flows" icon="arrow-progress">
+    Build reliable, stateful workflows that can handle long-running processes and complex logic.
   </Card>
-  <Card title="Fine-Grained Control" icon="sliders">
-    Manage workflow states and conditional execution securely and efficiently
+  <Card title="Autonomous Crews" icon="users">
+    Deploy teams of agents that can plan, execute, and collaborate to achieve high-level goals.
   </Card>
-  <Card title="Native Crew Integration" icon="puzzle-piece">
-    Effortlessly combine with Crews for enhanced autonomy and intelligence
+  <Card title="Flexible Tools" icon="screwdriver-wrench">
+     Connect your agents to any API, database, or local tool.
   </Card>
-  <Card title="Deterministic Execution" icon="route">
-    Ensure predictable outcomes with explicit control flow and error handling
+  <Card title="Enterprise Security" icon="lock">
+    Designed with security and compliance in mind for enterprise deployments.
   </Card>
 </CardGroup>
 
 ## When to Use Crews vs. Flows
 
-<Note>
-  Understanding when to use [Crews](/en/guides/crews/first-crew) versus [Flows](/en/guides/flows/first-flow) is key to maximizing the potential of CrewAI in your applications.
-</Note>
+**The short answer: Use both.**
 
-| Use Case | Recommended Approach | Why? |
-|:---------|:---------------------|:-----|
-| **Open-ended research** | [Crews](/en/guides/crews/first-crew) | When tasks require creative thinking, exploration, and adaptation |
-| **Content generation** | [Crews](/en/guides/crews/first-crew) | For collaborative creation of articles, reports, or marketing materials |
-| **Decision workflows** | [Flows](/en/guides/flows/first-flow) | When you need predictable, auditable decision paths with precise control |
-| **API orchestration** | [Flows](/en/guides/flows/first-flow) | For reliable integration with multiple external services in a specific sequence |
-| **Hybrid applications** | Combined approach | Use [Flows](/en/guides/flows/first-flow) to orchestrate overall process with [Crews](/en/guides/crews/first-crew) handling complex subtasks |
+For any production-ready application, **start with a Flow**.
 
-### Decision Framework
+- **Use a Flow** to define the overall structure, state, and logic of your application.
+- **Use a Crew** within a Flow step when you need a team of agents to perform a specific, complex task that requires autonomy.
 
-- **Choose [Crews](/en/guides/crews/first-crew) when:** You need autonomous problem-solving, creative collaboration, or exploratory tasks
-- **Choose [Flows](/en/guides/flows/first-flow) when:** You require deterministic outcomes, auditability, or precise control over execution
-- **Combine both when:** Your application needs both structured processes and pockets of autonomous intelligence
+| Use Case | Architecture |
+| :--- | :--- |
+| **Simple Automation** | Single Flow with Python tasks |
+| **Complex Research** | Flow managing state -> Crew performing research |
+| **Application Backend** | Flow handling API requests -> Crew generating content -> Flow saving to DB |
 
 ## Why Choose CrewAI?
 
@@ -124,13 +103,6 @@ With over 100,000 developers certified through our community courses, CrewAI is
 ## Ready to Start Building?
 
 <CardGroup cols={2}>
-  <Card
-    title="Build Your First Crew"
-    icon="users-gear"
-    href="/en/guides/crews/first-crew"
-  >
-    Step-by-step tutorial to create a collaborative AI team that works together to solve complex problems.
-  </Card>
   <Card
     title="Build Your First Flow"
     icon="diagram-project"
@@ -138,6 +110,13 @@ With over 100,000 developers certified through our community courses, CrewAI is
   >
     Learn how to create structured, event-driven workflows with precise control over execution.
   </Card>
+  <Card
+    title="Build Your First Crew"
+    icon="users-gear"
+    href="/en/guides/crews/first-crew"
+  >
+    Step-by-step tutorial to create a collaborative AI team that works together to solve complex problems.
+  </Card>
 </CardGroup>
 
 <CardGroup cols={3}>