spinny:~/writing $ less agentic-ai-frameworks-comparison.md
12Agentii AI au trecut de la demo-uri de cercetare la sisteme in productie. Se estimeaza ca peste 60% din aplicatiile AI de enterprise vor include componente agentice pana in 2026. Dar construirea agentilor de la zero - gestionand bucle de tool, stare, memorie, tratarea erorilor si coordonarea multi-agent - este complexa. Aici intervin framework-urile.34Patru framework-uri domina in 2026: **LangGraph**, **CrewAI**, **OpenAI Agents SDK** si **Claude Agent SDK**. Fiecare adopta o abordare fundamental diferita pentru aceeasi problema: a oferi LLM-urilor capacitatea de a rationa, planifica, folosi tool-uri si colabora.56## Vedere Generala78| Aspect | LangGraph | CrewAI | OpenAI Agents SDK | Claude Agent SDK |9|--------|-----------|--------|-------------------|-----------------|10| **Creat de** | LangChain | CrewAI Inc. | OpenAI | Anthropic |11| **Arhitectura** | Bazata pe grafuri | Bazata pe roluri | Bazata pe handoff | Bucla autonoma |12| **Filozofie** | Control maxim | Colaborare de echipa | Abstractie minima | Da agentului un calculator |13| **Limbaje** | Python, TypeScript | Python | Python | Python, TypeScript |14| **Suport modele** | Oricare (OpenAI, Claude, local) | Oricare | Oricare (in ciuda numelui) | Doar Claude |15| **Stele GitHub** | ~29k | ~40k | ~21k | ~6k |16| **Ideal pentru** | Workflow-uri stateful complexe | Specializare multi-agent | Routing si triage | Coding si sarcini cu fisiere |1718## LangGraph: Constructorul de Grafuri1920LangGraph modeleaza workflow-urile agentilor ca **grafuri ciclice dirijate**. Definesti noduri (functii care fac munca) si muchii (tranzitii intre ele, optional conditionale). Starea curge prin graf si persista prin checkpointing.2122Este cel mai explicit si controlabil framework - conectezi fiecare pas manual.2324```mermaid25graph LR26 Start --> Router[Router Node]27 Router -->|needs research| Research[Research Node]28 Router -->|needs code| Code[Code Node]29 Research --> Synthesize[Synthesize Node]30 Code --> Synthesize31 Synthesize --> End32```3334### Concepte Cheie3536- **StateGraph**: definitia grafului cu stare tipizata37- **Nodes**: functii Python care transforma starea38- **Edges**: conexiuni intre noduri, pot fi conditionale39- **Checkpointing**: persistenta integrata pentru workflow-uri de lunga durata4041### Exemplu de Cod4243```python44from langgraph.graph import StateGraph, MessagesState, START, END45from langchain_openai import ChatOpenAI4647llm = ChatOpenAI(model="gpt-4o")4849def call_agent(state: MessagesState):50 response = llm.invoke(state["messages"])51 return {"messages": [response]}5253def should_continue(state: MessagesState):54 last = state["messages"][-1]55 if last.tool_calls:56 return "tools"57 return END5859def call_tools(state: MessagesState):60 # Execute tool calls and return results61 results = []62 for tool_call in state["messages"][-1].tool_calls:63 result = execute_tool(tool_call)64 results.append(result)65 return {"messages": results}6667graph = StateGraph(MessagesState)68graph.add_node("agent", call_agent)69graph.add_node("tools", call_tools)70graph.add_edge(START, "agent")71graph.add_conditional_edges("agent", should_continue, {"tools": "tools", END: END})72graph.add_edge("tools", "agent")7374app = graph.compile()75result = app.invoke({"messages": [{"role": "user", "content": "What's the weather?"}]})76```7778### Puncte Forte7980- Control granular asupra fiecarui pas si tranzitii81- Checkpointing integrat si human-in-the-loop82- Paritate completa cu TypeScript83- Functioneaza cu orice furnizor LLM84- Ideal pentru workflow-uri complexe cu ramificari conditionale si bucle8586### Puncte Slabe8788- Curba de invatare abrupta - trebuie sa intelegi concepte de teoria grafurilor89- Verbos pentru cazuri de utilizare simple - un agent de baza necesita mai mult boilerplate decat alte framework-uri90- Debugging-ul fluxurilor grafului poate fi dificil fara LangSmith9192### Preturi9394Open-source (MIT). LangSmith (platforma de observabilitate gestionata) are planuri platite pentru monitorizare in productie.9596## CrewAI: Asamblorul de Echipe9798CrewAI foloseste o metafora umana: asamblezi un **crew** de agenti specializati, fiecare cu un **rol**, un **obiectiv** si o **poveste**. Agentii colaboreaza pe **sarcini** folosind **tool-uri**, coordonati de un **proces** (secvential, ierarhic sau consensual).99100Gandeste-te la asta ca angajarea unei echipe in care fiecare membru are un titlu si o specialitate specifice.101102```mermaid103graph TD104 Crew[Crew Manager] --> R[Researcher\nRole: Find data\nTools: WebSearch]105 Crew --> W[Writer\nRole: Write content\nTools: FileWrite]106 Crew --> E[Editor\nRole: Review quality\nTools: FileRead]107 R --> Task1[Research Task]108 W --> Task2[Writing Task]109 E --> Task3[Review Task]110 Task1 --> Task2 --> Task3111```112113### Concepte Cheie114115- **Agent**: un persona cu rol, obiectiv, poveste si tool-uri116- **Task**: o sarcina cu descriere, output asteptat si agent asignat117- **Crew**: un grup de agenti care lucreaza impreuna118- **Process**: strategie de executie (secventiala, ierarhica, consensuala)119- **Flow**: strat de orchestrare event-driven pentru conectarea mai multor crew-uri120121### Exemplu de Cod122123```python124from crewai import Agent, Task, Crew, Process125126researcher = Agent(127 role="Senior Research Analyst",128 goal="Find comprehensive data about the given topic",129 backstory="You have 10 years of experience in technology research. "130 "You are thorough and always verify facts from multiple sources.",131 tools=[web_search_tool],132 verbose=True,133)134135writer = Agent(136 role="Technical Writer",137 goal="Create clear, engaging technical content",138 backstory="You write for a developer audience. "139 "Your articles are practical and include code examples.",140 tools=[file_tool],141 verbose=True,142)143144research_task = Task(145 description="Research the latest developments in WebAssembly in 2026. "146 "Focus on WASI, Component Model, and production use cases.",147 expected_output="A structured research document with key findings and sources.",148 agent=researcher,149)150151writing_task = Task(152 description="Write a blog post based on the research. "153 "Include code examples and Mermaid diagrams.",154 expected_output="A complete blog post in Markdown format.",155 agent=writer,156 context=[research_task], # Writer receives researcher's output157)158159crew = Crew(160 agents=[researcher, writer],161 tasks=[research_task, writing_task],162 process=Process.sequential,163 verbose=True,164)165166result = crew.kickoff()167print(result.raw)168```169170### Puncte Forte171172- Abstractie bazata pe roluri intuitiva - usor de inteles173- Peste 100 de integrari de tool-uri incorporate174- Memorie partajata intre agenti (pe termen scurt, pe termen lung, pe entitate)175- Cea mai mare comunitate (~40k stele GitHub)176- Proces ierarhic cu un agent "manager" care deleaga si valideaza177178### Puncte Slabe179180- Mai putin control granular decat LangGraph - definesti roluri, nu cai de executie exacte181- Procesul ierarhic poate fi imprevizibil cand agentii nu sunt de acord182- Debugging-ul conversatiilor multi-agent este mai dificil decat fluxurile cu un singur agent183184### Preturi185186Core open-source (gratuit). CrewAI Platform: $99/luna (Teams) pana la $120k/an (Enterprise). Preturi bazate pe crew-uri active si executii lunare.187188## OpenAI Agents SDK: Routerul189190OpenAI Agents SDK (succesorul spiritual al Swarm) se concentreaza pe **handoff** - agenti care transfera conversatii catre alti agenti specializati. Este cel mai minimalist framework: agenti, tool-uri, handoff si guardrail. Atat.191192```mermaid193graph LR194 User --> Triage[Triage Agent]195 Triage -->|billing question| Billing[Billing Agent]196 Triage -->|refund request| Refund[Refund Agent]197 Triage -->|technical issue| Support[Support Agent]198 Billing --> Response[Response]199 Refund --> Response200 Support --> Response201```202203### Concepte Cheie204205- **Agent**: model + instructiuni + tool-uri + handoff206- **Handoff**: un transfer catre un alt agent (modelat ca un tool pe care LLM-ul il poate apela)207- **Guardrail**: validare de intrare/iesire care ruleaza in paralel cu agentul208- **Runner**: executa bucla agentului209- **Tracing**: observabilitate integrata pentru toate apelurile LLM, invocarile de tool si handoff-uri210211### Exemplu de Cod212213```python214from agents import Agent, Runner, handoff, InputGuardrail, GuardrailFunctionOutput215from pydantic import BaseModel216217class SafetyCheck(BaseModel):218 is_safe: bool219 reason: str220221async def content_safety(ctx, agent, input_text):222 result = await Runner.run(223 Agent(name="Safety", instructions="Check if input is safe. No PII."),224 input_text,225 context=ctx,226 )227 output = SafetyCheck.model_validate_json(result.final_output)228 return GuardrailFunctionOutput(229 output_info=output, tripwire_triggered=not output.is_safe230 )231232billing_agent = Agent(233 name="Billing Agent",234 instructions="You handle billing inquiries. Be precise with numbers.",235 tools=[lookup_invoice, process_payment],236)237238refund_agent = Agent(239 name="Refund Agent",240 instructions="You process refund requests. Always verify the order first.",241 tools=[lookup_order, issue_refund],242)243244triage_agent = Agent(245 name="Triage Agent",246 instructions="Route the customer to the right specialist. "247 "Ask clarifying questions if needed.",248 handoffs=[billing_agent, refund_agent],249 input_guardrails=[InputGuardrail(guardrail_function=content_safety)],250)251252result = await Runner.run(triage_agent, "I need a refund for order #4521")253print(result.final_output)254# The triage agent routes to refund_agent, which processes the refund255```256257### Puncte Forte258259- Pattern de handoff curat - natural pentru workflow-uri de routing/triage260- Guardrail-urile ruleaza in paralel cu executia (fail-fast, neblocante)261- Dashboard de tracing integrat pentru debugging262- In ciuda numelui, suporta modele non-OpenAI263- Abstractie minima - usor de inteles si de extins264265### Puncte Slabe266267- Gestionarea starii mai putin matura decat LangGraph268- Fara persistenta sau checkpointing integrate269- Ecosistemul de tool-uri terte este mai restrans270- Design-ul centrat pe handoff poate sa nu se potriveasca oricarei arhitecturi271272### Preturi273274Open-source (MIT). Platesti per token in functie de modelul utilizat.275276## Claude Agent SDK: Dezvoltatorul277278Claude Agent SDK adopta o abordare diferita: in loc sa definesti workflow-uri sau roluri, oferi agentului un **set de tool-uri si il lasi sa-si dea seama cum sa realizeze sarcina**. Foloseste aceeasi bucla autonoma care alimenteaza Claude Code - citeste, actioneaza, verifica, itereaza.279280```mermaid281graph TD282 Prompt[User Prompt] --> Loop[Autonomous Agent Loop]283 Loop --> Reason[Reason about next step]284 Reason --> Act[Execute tool]285 Act --> Verify[Check result]286 Verify -->|not done| Loop287 Verify -->|done| Output[Final output]288```289290### Concepte Cheie291292- **query()**: punctul de intrare principal care porneste bucla agentului293- **Tool-uri integrate**: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch294- **Tool-uri personalizate via MCP**: defineste tool-uri ca servere MCP in-process295- **Sub-agenti**: agenti specializati catre care parintele poate delega296- **Sessions**: mentin contextul de-a lungul mai multor interactiuni297298### Exemplu de Cod299300```typescript301import { tool, createSdkMcpServer, query } from "@anthropic-ai/claude-agent-sdk";302import { z } from "zod";303304const searchDocs = tool(305 "search_docs",306 "Search the internal documentation for relevant information",307 { query: z.string().describe("Search query") },308 async ({ query }) => {309 const results = await vectorStore.similaritySearch(query, 5);310 return {311 content: [{ type: "text", text: results.map(r => r.pageContent).join("\n\n") }],312 };313 }314);315316const docsServer = createSdkMcpServer({317 name: "docs",318 version: "1.0.0",319 tools: [searchDocs],320});321322for await (const message of query({323 prompt: "Find how authentication works in our system and write a summary",324 options: {325 mcpServers: { docs: docsServer },326 allowedTools: ["Read", "Glob", "Grep", "mcp__docs__search_docs"],327 },328})) {329 if (message.type === "result" && message.subtype === "success") {330 console.log(message.result);331 }332}333```334335### Puncte Forte336337- Integrare MCP de prima clasa - conecteaza-te la orice ecosistem de servere MCP338- Tool-uri integrate pentru operatiuni cu fisiere, terminal si acces web339- Compactare automata a contextului pentru baze de cod mari340- Paralelism al sub-agentilor pentru sarcini complexe341- Acelasi motor ca Claude Code - testat in lupta pe workflow-uri reale de dezvoltare342343### Puncte Slabe344345- Doar modele Claude - fara suport multi-furnizor346- Framework mai nou cu o comunitate mai mica347- Necesita runtime-ul Node.js chiar si pentru SDK-ul Python348- Mai putin control explicit al workflow-ului comparativ cu LangGraph349350### Preturi351352Open-source. Tarife standard per token ale API-ului Claude. Managed Agents (versiune gazduita): $0.08 per ora de sesiune pe langa costurile per token.353354## Cand Sa Alegi Care355356```mermaid357graph TD358 Start{What's your priority?}359 Start -->|Full control over workflow| LG[LangGraph]360 Start -->|Multi-agent collaboration| CA[CrewAI]361 Start -->|Routing and triage| OA[OpenAI Agents SDK]362 Start -->|Coding and file automation| CS[Claude Agent SDK]363364 LG --> LGU[Complex stateful workflows\nConditional branching\nHuman-in-the-loop]365 CA --> CAU[Team of specialized agents\nResearch + writing pipelines\nContent generation]366 OA --> OAU[Customer service routing\nMulti-step handoffs\nInput validation]367 CS --> CSU[Code generation and review\nFile-heavy automation\nMCP tool ecosystem]368```369370### Alege LangGraph daca:371- Ai nevoie de control precis asupra fiecarui pas al workflow-ului372- Cazul tau de utilizare implica logica conditionala complexa si bucle373- Vrei persistenta integrata si checkpoint-uri human-in-the-loop374- Trebuie sa folosesti mai multi furnizori LLM in acelasi workflow375376### Alege CrewAI daca:377- Vrei o abstractie intuitiva bazata pe roluri378- Sarcina ta implica mai multi agenti cu specialitati distincte379- Ai nevoie ca agentii sa colaboreze si sa-si paseze context intre ei380- Valorezi cea mai mare comunitate si cele mai multe integrari381382### Alege OpenAI Agents SDK daca:383- Pattern-ul tau principal este rutarea conversatiilor catre specialisti384- Ai nevoie de guardrail-uri care valideaza intrarea/iesirea in paralel385- Vrei abstractia cea mai simpla posibila cu boilerplate minim386- Tracing-ul si observabilitatea integrate sunt importante387388### Alege Claude Agent SDK daca:389- Agentii tai trebuie sa citeasca, scrie si execute cod390- Vrei integrare de prima clasa cu servere MCP391- Ai nevoie de agenti autonomi care itereaza si se auto-corecteaza392- Folosesti deja Claude si vrei integrarea cea mai profunda393394## Se Pot Combina Framework-urile?395396Da. Un pattern comun este sa folosesti un framework pentru orchestrare si altul pentru agentii individuali:397398- **LangGraph** pentru graful workflow-ului general399- **CrewAI** pentru un nod specific care necesita colaborare multi-agent400- **Claude Agent SDK** pentru sub-sarcini legate de coding via MCP401- **OpenAI Agents SDK** pentru triage si routing orientat catre client402403Framework-urile nu se exclud reciproc. Foloseste-l pe cel care se potriveste fiecarei parti a sistemului tau.404405## Concluzie406407Fiecare framework face un pariu clar:408409- **LangGraph** optimizeaza pentru control - tu decizi fiecare tranzitie410- **CrewAI** optimizeaza pentru colaborare - agentii lucreaza ca o echipa411- **OpenAI Agents SDK** optimizeaza pentru simplicitate - abstractie minima, handoff-uri curate412- **Claude Agent SDK** optimizeaza pentru autonomie - da-i tool-uri si lasa-l sa lucreze413414Alegerea corecta depinde de workflow-ul tau, echipa ta si stack-ul tau existent. Alege-l pe cel care se potriveste cazului tau principal de utilizare, invata-l bine si integreaza-le pe celelalte cand ajungi la punctul lor forte.415
:Framework-uri de IA Agentica Comparate: LangGraph vs CrewAI vs OpenAI Agents SDK vs Claude Agent SDKlines 1-415 (END) — press q to close