Skip to content

Pydantic AI

Framework de agentes en Python con tipado seguro, del equipo de Pydantic, con capacidades componibles, ejecución duradera y tracing con Logfire.

Reseña de Sheela · Actualizado

Ver en GitHub Código abierto

Nuestra nota

4.5/5

Pydantic AI lleva la disciplina del Python tipado a los agentes, a cambio de un ritmo de versiones que obliga a fijarlas.

¿Qué es Pydantic AI?

Pydantic AI es un framework de agentes del equipo de Pydantic, la biblioteca de validación de datos de la que dependen la mayoría de SDK de IA en Python. Usa las anotaciones de tipo de Python para validar las entradas de las herramientas y las salidas de los agentes, y para que los editores detecten errores antes de ejecutar el código.

La versión 2 pasó a estable el 23 de junio de 2026. Se organiza en torno a capacidades: paquetes componibles de herramientas, hooks, instrucciones y ajustes del modelo. Un paquete aparte, Pydantic AI Harness, añade memoria, guardrails, subagentes, planificación, gestión del contexto y un agente de programación completo, y la ejecución duradera, para que los agentes sobrevivan a los reinicios, funciona sobre ocho motores, entre ellos Temporal, DBOS y Prefect.

No depende de ningún modelo y emite trazas de OpenTelemetry estándar, que funcionan con cualquier backend o con Pydantic Logfire, el producto de observabilidad de pago de la empresa.

¿Cuánto cuesta Pydantic AI?

PlanPrecioQué incluye
LibraryFreeMIT
Logfire PersonalFreeHasta 10 millones de registros/mes
Logfire Team$49/monthMás 2 $ por cada millón de registros adicional

Gratis y de código abierto bajo la licencia MIT. Observabilidad con Logfire: Personal gratis hasta 10 millones de registros/mes, Team 49 $/mes más 2 $ por cada millón de registros adicional. Pydantic AI Gateway añade un recargo del 5% sobre los proveedores integrados.

¿Merece la pena Pydantic AI?

Pydantic AI es el framework de agentes para código que hay que mantener, no solo enseñar en una demo. Tiene unas 20.800 estrellas en GitHub, licencia MIT y publicó la v2.60.0 el 23 de octubre de 2026. Los argumentos de las herramientas y las salidas estructuradas se validan contra modelos de Pydantic, así que una respuesta mal formada del modelo falla de forma visible en lugar de acabar en tu base de datos, y la inyección de dependencias permite que las pruebas usen modelos de prueba.

El ritmo de versiones es extraordinario: 25 versiones menores de V2 entre la v2.36.0 del 29 de agosto y la v2.60.0 del 23 de octubre, mientras V1 sigue recibiendo parches (v1.107.9 el 21 de octubre). Fijar versiones no es opcional. El historial de seguridad muestra por qué: 19 avisos publicados, 13 de ellos desde agosto de 2026, sobre todo en la herramienta web-fetch (formas de saltarse la lista de bloqueo SSRF, bloqueos del event loop con HTML hostil) y en los adaptadores de interfaz, donde uno permitía ejecutar una llamada a herramienta enviada por el cliente.

V2 cambió la forma del framework. Las capacidades agrupan herramientas, instrucciones, hooks y ajustes en unidades que se enumeran en un agente, y el paquete Harness aporta ahora memoria, subagentes, planificación, guardrails y un agente de programación ya hecho, lo que reduce la distancia con CrewAI y Agno en patrones predefinidos. La ejecución duradera es inusualmente amplia, con ocho motores, de Temporal, DBOS y Prefect a AWS Lambda y Airflow, cinco de ellos mantenidos junto con los proveedores de cada motor. Los tutoriales escritos para V1 a menudo ya no coinciden.

La atracción comercial va hacia los productos propios de Pydantic, aunque nada obliga a usarlos. La instrumentación es OpenTelemetry estándar, así que sirve cualquier backend de tracing; Logfire es gratis hasta 10 millones de registros al mes para una persona y cuesta 49 $ al mes para equipos, con 2 $ por cada millón adicional. Pydantic AI Gateway ofrece una sola clave para muchos proveedores con un recargo del 5% sobre los proveedores integrados y ninguno sobre tus propias claves, lo que aporta presupuestos y conmutación por error a costa de un salto más entre el agente y el modelo.

Dónde se gana su sitio

  • Un equipo de backend en Python de una empresa de logística

    Extraer datos tipados de envíos de correos y PDF a su base de datos

    Definir la salida como un modelo de Pydantic y dejar que el agente reintente cuando falle la validación, para que las filas erróneas nunca lleguen a la base de datos. El framework no cuesta nada; la factura son los tokens del modelo, y los reintentos de validación la aumentan.

  • Una ingeniera de plataforma cuya empresa ya usa Temporal

    Ejecutar tareas largas de agentes que sobrevivan a despliegues y caídas

    Añadir la capacidad TemporalDurability para que cada llamada al modelo y a herramientas se convierta en una actividad de Temporal. No hace falta más infraestructura que el clúster existente; el riesgo es seguir una integración que cambia rápido entre versiones que salen varias veces por semana.

  • Un responsable de ingeniería de una start-up de IA de 15 personas

    Tener trazas y visibilidad de costes de los agentes en producción

    Enviar las trazas de OpenTelemetry integradas a Logfire Team, a 49 $ al mes por 10 millones de registros y cinco puestos, y después 2 $ por cada millón adicional, o a un backend existente sin coste de licencia adicional.

Antes de decidirte

Puesta en marcha
uv add pydantic-ai (o pip) con Python 3.11 o posterior; un agente tipado con una herramienta ocupa unas pocas líneas. Extras como pydantic-ai[temporal] y pydantic-ai-harness se instalan aparte.
Integraciones
OpenAI, Anthropic, Google, Bedrock, Azure AI Foundry, Groq, Mistral, xAI, Ollama y decenas más; MCP; streams de interfaz AG-UI y Vercel AI; voz en tiempo real; Temporal, DBOS, Prefect, Restate, AWS Lambda y Airflow para la ejecución duradera.
Datos y privacidad
Es una biblioteca: los datos van a los proveedores de modelos y exportadores de trazas que configures. Licencia MIT. Un aviso de septiembre descubrió que include_content=False no ocultaba en las trazas las excepciones ni las instrucciones, así que comprueba qué recibe tu exportador.
Coste a escala
El framework es gratis. Logfire Personal es gratis hasta 10 millones de registros al mes; Team cuesta 49 $ al mes con 10 millones de registros y 2 $ por cada millón adicional. AI Gateway cobra un recargo del 5% sobre los proveedores integrados y ninguno sobre tus propias claves.
Límites
Ritmo de versiones muy rápido, con V1 y V2 mantenidas en paralelo; unas 1.500 incidencias y pull requests abiertas; no hay constructor visual.

Lo bueno

  • Entradas de herramientas y salidas estructuradas validadas
  • Independiente del modelo, con decenas de proveedores
  • Ejecución duradera sobre ocho motores
  • Los agentes son fáciles de probar con pruebas unitarias

Lo malo

  • Varias versiones por semana; fijarlas es imprescindible
  • 19 avisos de seguridad, sobre todo en web-fetch y en los adaptadores de interfaz
  • V2 trasladó los extras a un paquete Harness aparte
  • Requiere Python 3.11 o posterior

Ideal para

Ingenieros de Python que construyen agentes para producción y quieren tipado fuerte, facilidad para probar y libertad para cambiar de modelo.

Alternativas a Pydantic AI

Pydantic AI: preguntas frecuentes

¿Merece la pena Pydantic AI?
Pydantic AI lleva la disciplina del Python tipado a los agentes, a cambio de un ritmo de versiones que obliga a fijarlas. Le damos un 4.5 sobre 5.
¿Cuánto cuesta Pydantic AI?
Gratis y de código abierto bajo la licencia MIT. Observabilidad con Logfire: Personal gratis hasta 10 millones de registros/mes, Team 49 $/mes más 2 $ por cada millón de registros adicional. Pydantic AI Gateway añade un recargo del 5% sobre los proveedores integrados.
¿Qué inconvenientes tiene Pydantic AI?
Varias versiones por semana; fijarlas es imprescindible; 19 avisos de seguridad, sobre todo en web-fetch y en los adaptadores de interfaz; v2 trasladó los extras a un paquete Harness aparte; requiere Python 3.11 o posterior.
¿Para quién es Pydantic AI?
Ingenieros de Python que construyen agentes para producción y quieren tipado fuerte, facilidad para probar y libertad para cambiar de modelo.
¿Cuánto cuesta Pydantic AI para un equipo o en producción?
El framework es gratis. Logfire Personal es gratis hasta 10 millones de registros al mes; Team cuesta 49 $ al mes con 10 millones de registros y 2 $ por cada millón adicional. AI Gateway cobra un recargo del 5% sobre los proveedores integrados y ninguno sobre tus propias claves.
¿Es Pydantic AI seguro para los datos de la empresa?
Es una biblioteca: los datos van a los proveedores de modelos y exportadores de trazas que configures. Licencia MIT. Un aviso de septiembre descubrió que include_content=False no ocultaba en las trazas las excepciones ni las instrucciones, así que comprueba qué recibe tu exportador.
¿Cuáles son las mejores alternativas a Pydantic AI?
Las alternativas más cercanas que hemos analizado son OpenAI Agents SDK, LangGraph, Agno y smolagents.

Respuestas comprobadas el 23 oct 2026.