spinny:~/writing $ less agentic-ai-frameworks-comparison.md
12Los agentes de IA han pasado de demos de investigacion a sistemas en produccion. Se espera que mas del 60% de las aplicaciones de IA empresariales incluyan componentes agentivos para 2026. Pero construir agentes desde cero - gestionando bucles de tool, estado, memoria, manejo de errores y coordinacion multi-agente - es complejo. Ahi es donde entran los frameworks.34Cuatro frameworks dominan en 2026: **LangGraph**, **CrewAI**, **OpenAI Agents SDK** y **Claude Agent SDK**. Cada uno adopta un enfoque fundamentalmente diferente al mismo problema: dar a los LLM la capacidad de razonar, planificar, usar tool y colaborar.56## Vista General78| Aspecto | LangGraph | CrewAI | OpenAI Agents SDK | Claude Agent SDK |9|--------|-----------|--------|-------------------|-----------------|10| **Creado por** | LangChain | CrewAI Inc. | OpenAI | Anthropic |11| **Arquitectura** | Basada en grafos | Basada en roles | Basada en handoff | Bucle autonomo |12| **Filosofia** | Maximo control | Colaboracion de equipo | Abstraccion minima | Dale un ordenador al agente |13| **Lenguajes** | Python, TypeScript | Python | Python | Python, TypeScript |14| **Soporte de modelos** | Cualquiera (OpenAI, Claude, local) | Cualquiera | Cualquiera (a pesar del nombre) | Solo Claude |15| **Estrellas GitHub** | ~29k | ~40k | ~21k | ~6k |16| **Ideal para** | Workflows stateful complejos | Especializacion multi-agente | Routing y triage | Coding y tareas con archivos |1718## LangGraph: El Constructor de Grafos1920LangGraph modela los workflows de agentes como **grafos ciclicos dirigidos**. Defines nodos (funciones que hacen el trabajo) y aristas (transiciones entre ellos, opcionalmente condicionales). El estado fluye a traves del grafo y se persiste mediante checkpointing.2122Es el framework mas explicito y controlable - conectas cada paso tu mismo.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### Conceptos Clave3536- **StateGraph**: la definicion del grafo con estado tipado37- **Nodes**: funciones Python que transforman el estado38- **Edges**: conexiones entre nodos, pueden ser condicionales39- **Checkpointing**: persistencia integrada para workflows de larga duracion4041### Ejemplo de Codigo4243```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### Fortalezas7980- Control granular sobre cada paso y transicion81- Checkpointing integrado y human-in-the-loop82- Paridad completa con TypeScript83- Funciona con cualquier proveedor LLM84- Ideal para workflows complejos con ramificacion condicional y bucles8586### Debilidades8788- Curva de aprendizaje pronunciada - necesitas entender conceptos de teoria de grafos89- Verboso para casos de uso simples - un agente basico requiere mas boilerplate que otros frameworks90- El debugging de flujos del grafo puede ser dificil sin LangSmith9192### Precios9394Open-source (MIT). LangSmith (plataforma de observabilidad gestionada) tiene planes de pago para monitoreo en produccion.9596## CrewAI: El Ensamblador de Equipos9798CrewAI usa una metafora humana: ensamblas un **crew** de agentes especializados, cada uno con un **rol**, un **objetivo** y una **historia**. Los agentes colaboran en **tareas** usando **tool**, coordinados por un **proceso** (secuencial, jerarquico o consensuado).99100Piensalo como contratar un equipo donde cada miembro tiene un titulo y una especialidad especificos.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### Conceptos Clave114115- **Agent**: un persona con rol, objetivo, historia y tool116- **Task**: una asignacion con descripcion, salida esperada y agente asignado117- **Crew**: un grupo de agentes trabajando juntos118- **Process**: estrategia de ejecucion (secuencial, jerarquica, consensuada)119- **Flow**: capa de orquestacion event-driven para conectar multiples crews120121### Ejemplo de Codigo122123```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### Fortalezas171172- Abstraccion basada en roles intuitiva - facil de razonar173- Mas de 100 integraciones de tool incorporadas174- Memoria compartida entre agentes (corto plazo, largo plazo, por entidad)175- Mayor comunidad (~40k estrellas GitHub)176- Proceso jerarquico con un agente "manager" que delega y valida177178### Debilidades179180- Menos control granular que LangGraph - defines roles, no rutas de ejecucion exactas181- El proceso jerarquico puede ser impredecible cuando los agentes no estan de acuerdo182- El debugging de conversaciones multi-agente es mas dificil que los flujos de un solo agente183184### Precios185186Core open-source (gratuito). CrewAI Platform: $99/mes (Teams) hasta $120k/anio (Enterprise). Precios basados en crews activos y ejecuciones mensuales.187188## OpenAI Agents SDK: El Router189190El OpenAI Agents SDK (sucesor espiritual de Swarm) se enfoca en los **handoff** - agentes que transfieren conversaciones a otros agentes especializados. Es el framework mas minimalista: agentes, tool, handoff y guardrail. Eso es todo.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### Conceptos Clave204205- **Agent**: modelo + instrucciones + tool + handoff206- **Handoff**: una transferencia a otro agente (modelada como un tool que el LLM puede llamar)207- **Guardrail**: validacion de entrada/salida que se ejecuta en paralelo con el agente208- **Runner**: ejecuta el bucle del agente209- **Tracing**: observabilidad integrada para todas las llamadas LLM, invocaciones de tool y handoff210211### Ejemplo de Codigo212213```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### Fortalezas258259- Patron de handoff limpio - natural para workflows de routing/triage260- Los guardrail se ejecutan en paralelo con la ejecucion (fail-fast, no bloqueantes)261- Dashboard de tracing integrado para debugging262- A pesar del nombre, soporta modelos no-OpenAI263- Abstraccion minima - facil de entender y extender264265### Debilidades266267- Gestion de estado menos madura que LangGraph268- Sin persistencia ni checkpointing integrados269- El ecosistema de tool de terceros es mas reducido270- El disenio centrado en handoff puede no adaptarse a toda arquitectura271272### Precios273274Open-source (MIT). Se paga por token segun el modelo utilizado.275276## Claude Agent SDK: El Desarrollador277278El Claude Agent SDK adopta un enfoque diferente: en lugar de definir workflows o roles, le das al agente un **conjunto de tool y lo dejas descubrir como realizar la tarea**. Utiliza el mismo bucle autonomo que impulsa Claude Code - leer, actuar, verificar, iterar.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### Conceptos Clave291292- **query()**: el punto de entrada principal que inicia el bucle del agente293- **Tool integrados**: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch294- **Tool personalizados via MCP**: define tool como servidores MCP in-process295- **Sub-agents**: agentes especializados a los que el padre puede delegar296- **Sessions**: mantienen el contexto a traves de multiples interacciones297298### Ejemplo de Codigo299300```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### Fortalezas336337- Integracion MCP de primera clase - conectate a cualquier ecosistema de servidores MCP338- Tool integrados para operaciones de archivos, terminal y acceso web339- Compactacion automatica del contexto para bases de codigo grandes340- Paralelismo de sub-agents para tareas complejas341- Mismo motor que Claude Code - probado en batalla en workflows de desarrollo reales342343### Debilidades344345- Solo modelos Claude - sin soporte multi-proveedor346- Framework mas reciente con una comunidad mas pequenia347- Requiere el runtime Node.js incluso para el SDK de Python348- Menos control explicito del workflow comparado con LangGraph349350### Precios351352Open-source. Tarifas estandar por token de la API de Claude. Managed Agents (version alojada): $0.08 por hora de sesion ademas de los costos por token.353354## Cuando Elegir Cual355356```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### Elige LangGraph si:371- Necesitas control preciso sobre cada paso del workflow372- Tu caso de uso implica logica condicional compleja y bucles373- Quieres persistencia integrada y checkpoints human-in-the-loop374- Necesitas usar multiples proveedores LLM en el mismo workflow375376### Elige CrewAI si:377- Quieres una abstraccion intuitiva basada en roles378- Tu tarea involucra multiples agentes con especialidades distintas379- Necesitas que los agentes colaboren y se pasen contexto entre si380- Valoras la comunidad mas grande y la mayor cantidad de integraciones381382### Elige OpenAI Agents SDK si:383- Tu patron principal es enrutar conversaciones hacia especialistas384- Necesitas guardrail que validen entrada/salida en paralelo385- Quieres la abstraccion mas simple posible con boilerplate minimo386- El tracing y la observabilidad integrados son importantes387388### Elige Claude Agent SDK si:389- Tus agentes necesitan leer, escribir y ejecutar codigo390- Quieres integracion de primera clase con servidores MCP391- Necesitas agentes autonomos que iteren y se auto-corrijan392- Ya usas Claude y quieres la integracion mas profunda393394## Se Pueden Combinar los Frameworks?395396Si. Un patron comun es usar un framework para la orquestacion y otro para los agentes individuales:397398- **LangGraph** para el grafo del workflow general399- **CrewAI** para un nodo especifico que requiere colaboracion multi-agente400- **Claude Agent SDK** para sub-tareas relacionadas con coding via MCP401- **OpenAI Agents SDK** para triage y routing orientado al cliente402403Los frameworks no son mutuamente excluyentes. Usa el que se adapte a cada parte de tu sistema.404405## Conclusion406407Cada framework hace una apuesta clara:408409- **LangGraph** optimiza para el control - tu decides cada transicion410- **CrewAI** optimiza para la colaboracion - los agentes trabajan en equipo411- **OpenAI Agents SDK** optimiza para la simplicidad - abstraccion minima, handoff limpios412- **Claude Agent SDK** optimiza para la autonomia - dale tool y dejalo trabajar413414La eleccion correcta depende de tu workflow, tu equipo y tu stack existente. Elige el que coincida con tu caso de uso principal, aprendelo bien e incorpora los demas cuando llegues a su punto fuerte.415
:Frameworks de IA Agentica Comparados: LangGraph vs CrewAI vs OpenAI Agents SDK vs Claude Agent SDKlines 1-415 (END) — press q to close