# Pydantic AI: construye agentes Python con contratos de datos

> Define herramientas y resultados tipados para integrar modelos de lenguaje en aplicaciones Python con validación explícita.

Verificado el 26 oct 2026.

## Qué es

Pydantic AI es un SDK de Python para aplicaciones con modelos de lenguaje. Utiliza tipos y validación para expresar los datos que recibe una herramienta y los resultados que debe producir un agente.

## Para qué te sirve

- Cuando una respuesta del modelo debe convertirse en un objeto que tu aplicación pueda procesar.
- Cuando necesitas herramientas con argumentos bien definidos y errores de validación visibles.
- Cuando quieres cambiar de proveedor sin reescribir toda la estructura del agente.

## Cómo funciona

El agente combina un modelo, instrucciones y herramientas. Los contratos de datos describen la interfaz entre esas piezas y el programa que las consume. El repositorio distingue el SDK principal de capacidades adicionales de arnés, voz y otras interfaces.

La validación controla la forma de los datos; no demuestra que una respuesta sea cierta. Conserva reglas del negocio y comprobaciones de las herramientas en código, especialmente cuando una salida desencadena otras operaciones.

## Antes de empezar

Necesitas Python ≥3.11, uv para esta ruta y acceso al proveedor de modelos del ejemplo elegido. En un proyecto con uv puedes añadir solo el SDK básico; las capacidades de shell, archivos o subagentes del paquete de arnés son opcionales y tienen un alcance diferente.

## Límites y alternativas

La seguridad de tipos ayuda a detectar errores de integración, pero no elimina alucinaciones ni autoriza acciones. Para una tarea puramente determinista, una función Python normal evita llamadas al modelo. Evalúa el comportamiento con entradas reales y casos de error.

## Recursos

- [Repositorio y README](https://github.com/pydantic/pydantic-ai) - 20888 estrellas; licencia detectada por GitHub: MIT.
- [Licencia](https://github.com/pydantic/pydantic-ai/blob/main/LICENSE) - Consulta sus condiciones antes de reutilizar el proyecto.
