Framework · Pydantic
Pydantic AI de un vistazo
Un framework de agentes para Python del equipo de Pydantic, basado en anotaciones de tipo, salidas estructuradas validadas e inyección de dependencias. Destaca por la ejecución duradera en siete motores, desde Temporal hasta Airflow, e incluye Pydantic Evals.
Ideal para: Agentes de Python con seguridad de tipos cuyas salidas deben validarse, con libertad para elegir el motor de ejecución duradera.
Datos clave
- Mantenedor
- Pydantic
- Lenguajes
- Python
- Licencia
- MIT
- Última versión
2.52.0· 30 de septiembre de 2026- Repositorio
- pydantic/pydantic-ai
- Opción alojada
- Ninguno
Inicio rápido
Instala el paquete, configura las credenciales y ejecuta el agente más sencillo de la documentación oficial. Los ID de modelo son los que usa la documentación y puede que no estén habilitados en tu cuenta.
pip install pydantic-aifrom typing import Literal
from pydantic import BaseModel, Field
from pydantic_ai import Agent, RunContext
class Sentiment(BaseModel):
label: Literal['positive', 'negative', 'neutral']
score: float = Field(ge=-1, le=1)
agent = Agent('openai:gpt-6-sol', output_type=Sentiment)
@agent.tool
def recent_reviews(ctx: RunContext, product: str) -> list[str]:
"""Fetch recent review snippets for a product."""
return ['The new release fixed everything I complained about!']
result = agent.run_sync('How are people feeling about the Extract app?')
print(result.output)
#> label='positive' score=0.9Funciones
| Cualquier modelo | Sí | Cambiar de modelo solo requiere modificar una cadena; incluye un modelo de prueba sin conexión |
|---|---|---|
| Cliente MCP | Sí | Se añade al agente como una capacidad MCP |
| Servidor MCP | Sin confirmar | |
| Multiagente | Sí | Capacidad SubAgents y flujo de control tipado con Pydantic Graph |
| Ejecuciones duraderas | Sí | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru o Airflow |
| Aprobación humana | Sí | Las aprobaciones también funcionan con la ejecución duradera |
| Trazas | Sí | Nativo de OpenTelemetry; una línea envía trazas a Logfire |
| Evaluaciones | Sí | Pydantic Evals, un paquete independiente del mismo proyecto |
Cambios recientes
- Pasó a la línea 2.x; la 1.x sigue recibiendo versiones de mantenimiento, como la v1.107.7 del 30 de septiembre de 2026.
- El nuevo paquete pydantic-ai-harness añade Coder, Researcher y SubAgents.
- Se añadieron voz en tiempo real, generación de imágenes y embeddings.
- La documentación se trasladó a pydantic.dev/docs/ai/.