crewai - 💡(How to fix) Fix [Docs] Visualize CrewAI's multi-agent swarm pattern with FlowZap — workflow + sequence + architecture in one file [3 comments, 2 participants]

Fix Plan

To integrate the provided FlowZap architecture diagram into the CrewAI documentation, follow these steps:

• Create a new file with a .fz extension (e.g., crewai_architecture.fz) and paste the provided FlowZap code into it.
• Update the crewai_architecture.fz file to include any necessary comments or descriptions for clarity.
• Use the FlowZap MCP tool to generate the Workflow, Sequence diagram, and Architecture views by running the command:

npx -y flowzap-mcp crewai_architecture.fz

• Review the generated diagrams to ensure they accurately represent the CrewAI architecture.
• Create a pull request to add the crewai_architecture.fz file and the generated diagrams to the CrewAI documentation.

Verification

To verify that the fix worked, check that:

• The crewai_architecture.fz file is correctly formatted and renders the expected diagrams when pasted into the FlowZap editor.
• The generated diagrams accurately represent the CrewAI architecture and are consistent across all three views (Workflow, Sequence diagram, and Architecture).
• The pull request is successfully merged and the updated documentation is visible on the CrewAI website.

Example Code

The provided FlowZap code can be used as a starting point:

dispatcher_agent {# Dispatcher Agent
  n1: rectangle label="Split Goals & Dispatch"
  n1.handle(bottom) -> research_agent_a.n2.handle(top) [label="Explore Angle 1"]
  n1.handle(bottom) -> research_agent_b.n3.handle(top) [label="Explore Angle 2"]
  n1.handle(bottom) -> research_agent_c.n4.handle(top) [label="Explore Angle 3"]
}
research_agent_a {# Research Agent A
  n2: rectangle label="Parallel Search A"
  n2.handle(bottom) -> aggregator_agent.n5.handle(top) [label="Findings A"]
}
research_agent_b {# Research Agent B
  n3: rectangle label="Parallel Search B"
  n3.handle(bottom) -> aggregator_agent.n5.handle(top) [label="Findings B"]
}
research_agent_c {# Research Agent C
  n4: rectangle label="Parallel Search C"
  n4.handle(bottom) -> aggregator_agent.n5.handle(top) [label="Findings C"]
}
aggregator_agent {# Aggregator Agent
  n5: rectangle label="Merge & Deduplicate"
}