CrewAI & Sisteme Multi-Agent: ghid Python, arhitectură și exemple practice

CrewAI este un framework Python open-source dedicat orchestrării echipelor de agenți AI autonomi bazați pe roluri (Multi-Agent Systems). În loc să împovărezi un singur prompt gigantic cu zece responsabilități contradictorii, CrewAI îți permite să creezi o echipă de agenți specializați (ex: Cercetător, Analist Financiar, Redactor Tehnic, QA Reviewer) care colaborează, își deleagă sarcini și își verifică reciproc rezultatele.

Arhitectura modernă CrewAI combină două paradigme complementare: Crews (echipe autonome bazate pe roluri și obiective pentru rezolvarea creativă a sarcinilor) și Flows (fluxuri deterministe bazate pe evenimente și stare tipizată pentru controlul strict al aplicației în producție).

Cum este organizat acest ghid

Am structurat cele clase, decoratori și concepte CrewAI, plus comenzile CLI-ului crewai, grupate în categorii:

• Arhitectura de Bază (Agents, Tasks & Crews): Agent (role, goal, backstory), Task (description, expected_output, context), Crew & kickoff() și Configurarea YAML (agents.yaml & tasks.yaml).
• Procese de Execuție & CrewAI Flows: Process.sequential vs Process.hierarchical, Delegarea între Agenți (allow_delegation), CrewAI Flows (@start, @listen, @router) și Execuția Asincronă & Batch (kickoff_for_each).
• Unelte (Tools), Date Structurate & Guardrails: Decoratorul @tool & BaseTool, crewai-tools (SerperDev, ScrapeWebsite, FileRead), output_pydantic & output_json și Task Guardrails & human_input.
• Memorie, Knowledge (RAG) & CLI: Memoria unificată (clasa Memory), Knowledge Sources (PDF, CSV, Text RAG) și CLI-ul crewai: lista comenzilor.
• Comenzi CLI: proiect și execuție: crewai create, install, run, chat, train, replay, log-tasks-outputs, reset-memories, memory, checkpoint, flow, version și uv.
• Comenzi CLI: CrewAI AMP și registre: crewai login, deploy, org, config, traces, tool, skill și template.

Apasă pe oricare componentă de mai jos pentru sintaxă Python actualizată, exemple complete de echipe multi-agent și sfaturi de arhitectură.

# 1. Instalare uv și CrewAI CLI pe macOS:
brew install uv
uv tool install crewai

# 2. Crearea și rularea unei echipe noi de agenți:
crewai create crew echipa-mea
cd echipa-mea
crewai install && crewai run

# 1. Instalare uv și CrewAI în Windows PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install crewai

# Notă Windows: Dacă întâmpini erori de compilare C++ la chroma-hnswlib,
# instalează 'Desktop development with C++' din Visual Studio Build Tools.
crewai create crew echipa-mea && cd echipa-mea && crewai run

# 1. Instalare uv și CrewAI pe Ubuntu / Debian / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uv tool install crewai

# Sau într-un mediu venv clasic:
pip install 'crewai[tools]'
crewai create crew echipa-mea

# La rularea 'crewai create crew', CLI-ul generează un fișier .env în care completezi:
MODEL=anthropic/claude-3-7-sonnet-20250219
ANTHROPIC_API_KEY=sk-ant-...
SERPER_API_KEY=cheie_serper_pentru_cautare_google