Agregando un agente de receta inteligente con Telex y FastAPI — Consejos diarios, análisis de ingredientes y conversiones inteligentes

Introducción: En este artículo explico cómo desarrollé e integré un agente de recetas inteligente con Telex.im y FastAPI, y cómo esa solución puede encajar en la oferta de Q2BSTUDIO, empresa dedicada a desarrollo de software a medida, aplicaciones a medida, inteligencia artificial, ciberseguridad y servicios cloud aws y azure.

Qué hace el Agente de Recetas Inteligente: El agente es un asistente culinario potenciado por IA que interactúa de forma natural a través de Telex.im. Entre sus funciones principales están: enviar consejos diarios de cocina y nutrición al pedir Get Daily Tip, analizar y parsear ingredientes como ½ cup sugar y extraer cantidad, unidad e ingrediente, realizar conversiones inteligentes de unidades como 2 cups flour a 250 g de harina y escalar recetas automáticamente por número de comensales para generar cantidades ajustadas.

Tecnologías y arquitectura: La solución usa FastAPI para exponer endpoints REST, Pydantic para validación y modelos, y se integra con Telex.im mediante el protocolo A2A para recibir y responder mensajes en tiempo real. Para despliegue de prueba se utilizó Railway y uvicorn para ejecutar la app. La lógica de parsing y conversiones contiene reglas y tablas de equivalencias para ingredientes comunes y admite ampliación para medidas y densidades más complejas.

Integración con Telex.im: La integración se realiza con un workflow JSON que envía eventos a un webhook FastAPI. Cada mensaje entrante se procesa, se interpreta la intención del usuario y se responde mediante la API A2A de Telex.im. Manejar correctamente la autenticación del webhook y los timeouts evita errores 502 y desconexiones. El agente también mantiene trazas de logs para depuración y monitoreo.

Estructura del proyecto: El proyecto incluye un main.py con la app FastAPI, utilidades de parsing y conversión, un handler para la integración A2A y un archivo de dependencias. Esta estructura permite escalar el agente e integrar otras capacidades como recomendaciones nutricionales, búsqueda de recetas y sincronización con catálogos de ingredientes propios.

Desafíos y lecciones: Entre los retos estuvieron validar respuestas A2A, tiempos de espera y formato de autenticación. Aprendí a diseñar validaciones estrictas, a gestionar reintentos automáticos y a implementar conversiones reversibles para ofrecer respuestas consistentes al usuario. Es clave implementar tests automatizados sobre parsing y conversiones para evitar errores en producción.

Resultados y casos de uso: Una vez desplegado, el agente responde instantáneamente en Telex con consejos diarios, conversiones de ingredientes precisas y recetas escaladas para familias o porciones individuales. Esto convierte la interacción en una experiencia de diálogo con un asistente culinario práctico, ideal como complemento a productos y servicios de empresas que buscan incorporar agentes IA en sus flujos.

Por qué esto es relevante para Q2BSTUDIO: En Q2BSTUDIO combinamos experiencia en desarrollo de software a medida y aplicaciones a medida con soluciones de inteligencia artificial para empresas. Un agente como este es un ejemplo de cómo podemos diseñar agentes IA personalizados que automatizan tareas, mejoran la experiencia de usuario y se integran con plataformas de mensajería y orquestación. Si su objetivo es modernizar procesos o añadir capacidades conversacionales a su producto, podemos ayudar a construirlo y desplegarlo en la nube.

Servicios complementarios: Además de agentes IA, Q2BSTUDIO ofrece ciberseguridad y pentesting para proteger integraciones, servicios cloud aws y azure para desplegar soluciones escalables y servicios de inteligencia de negocio y power bi para explotar los datos generados por los agentes. Integramos automatización y análisis para convertir interacciones en insights accionables.

Conoce más sobre nuestras capacidades en inteligencia artificial visitando nuestra página de Inteligencia Artificial y si buscas soluciones de producto o aplicaciones personalizadas consulta nuestros servicios de desarrollo de aplicaciones y software a medida. En Q2BSTUDIO diseñamos agentes IA y plataformas seguras y escalables que aportan valor real al negocio.

Conclusión: El Agente de Recetas Inteligente demuestra cómo combinar FastAPI, A2A y modelos de IA para crear asistentes prácticos que automatizan tareas cotidianas. Para empresas interesadas en aprovechar la inteligencia artificial, agentes IA o modernizar sus aplicaciones con software a medida, Q2BSTUDIO ofrece la experiencia técnica y las prácticas de seguridad necesarias para entregar soluciones completas y eficientes.