Serie PydanticAI desde cero · Artículo 2 de 5 · El formulario oficial del Banano Exchange
En el artículo anterior contratamos a Don Plátano, un corredor de bolsa entusiasta que cotiza todo en bananas. Tenía personalidad, pero entregaba sus cotizaciones como texto libre: si querías guardar cien cotizaciones en una hoja de cálculo, tenías que rescatar el número de entre sus exclamaciones a mano.
Hoy lo obligamos a llenar un formulario oficial. Cada cotización llegará como un objeto con campos definidos, validados y listos para usarse en un programa.
🎯 Objetivos de este artículo
- Entender por qué el texto libre estorba cuando quieres usar la respuesta en un programa.
- Repasar
BaseModelde Pydantic y crear tu primer formulario (Cotizacion). - Validar rangos y tipos con
Field,LiteralyEnum. - Forzar la salida del agente con
output_type. - Entender qué pasa cuando el modelo se equivoca: reintentos y errores.
- Convertir las cotizaciones en una tabla de pandas y guardarla en CSV.
📋 Antes de empezar
- Haber leído el Artículo 1 ayuda, pero no es obligatorio: la sección de preparación repite lo necesario.
- Una cuenta de Google (Colab), conocimientos básicos de Python y una cuenta en OpenRouter con unos centavos de crédito.
- Este notebook hace unas 20 llamadas pequeñas a modelos económicos, así que cuesta poco, pero no es gratis.
- Ejecuta las celdas en orden, de arriba hacia abajo.
⚠️ Límite de Colab: la sesión gratuita se reinicia si la dejas inactiva. Al reiniciarse se pierden las librerías, las variables y los archivos que hayas creado. Si ocurre, vuelve a ejecutar desde la sección de preparación.
0. Preparación (igual que en el Artículo 1)
Cuatro celdas rápidas: instalar, verificar, cargar la API key y activar nest_asyncio.
⚠️ Usamos
--quietpara no llenar la pantalla, pero eso oculta los errores. Si algo falla, la celda de verificación te avisará; entonces vuelve a ejecutar la instalación sin--quiet.
✅ Lo que aprendiste
- El texto libre es difícil de usar en un programa; las salidas estructuradas resuelven eso.
- Un
BaseModelde Pydantic es un formulario con campos tipados, y rechaza datos que no encajan. Field,LiteralyEnumañaden reglas: rangos, largos y opciones permitidas.- Las
descriptionde los campos son parte del prompt, así que se escriben con cuidado. - Con
output_type, el agente devuelve un objeto validado en lugar de texto. - Si el modelo se equivoca, PydanticAI le devuelve el error y le pide corregir; si no lo logra, lanza una excepción.
- Con
model_dump(mode="json")y pandas, las cotizaciones se vuelven una tabla lista para guardar en CSV. - Estructura no es verdad: el formato es correcto, pero las cifras siguen siendo inventadas.
🔜 En el próximo artículo
Don Plátano ya entrega cotizaciones impecables… con precios que dependen de su estado de ánimo. Vimos que el valor de la Torre Eiffel puede variar muchas veces entre una ejecución y otra.
En el Artículo 3 le daremos herramientas: una tabla con el precio oficial de la banana, una consulta de tipo de cambio y una calculadora. Así dejará de inventar y empezará a consultar.
Serie PydanticAI desde cero · Artículo 2 de 5. ¿Dudas o comentarios? Déjalos en el blog.

Si quieres que la IA deje de ser un experimento en el chat y empiece a trabajar en tu operación diaria —automatizando lo repetitivo, conectando las herramientas que ya usas y atendiendo cuando tú no estás—, en Clarvex AI lo hacemos a la medida de tu negocio.
Armamos la página que explica tu servicio y el chatbot de WhatsApp que responde a tus clientes cuando tú no estás, usando la API oficial de Meta. También conectamos lo que ya usas (correo, hojas, agenda, etc.) para que dejes de copiar y pegar. 👉🏻 clarvexai.com
