Introducción: En la Etapa 3 de HNG desarrollé un Agente Rastreador de Tareas integrado con Telex.im mediante el protocolo A2A. El objetivo fue crear un asistente inteligente que permita gestionar proyectos y plazos directamente desde la interfaz de chat. Este artículo describe el proceso de desarrollo, los retos superados y cómo logramos la integración con Telex.im, todo con un enfoque práctico y orientado a producción.
Sobre el proyecto: Implementé un agente en TypeScript usando Express.js, con integración completa del protocolo A2A, endpoints REST con gestión de errores, procesamiento de comandos en lenguaje natural y gestión de tareas en tiempo real para crear, listar, completar y eliminar tareas. La arquitectura se diseñó pensando en escalabilidad y extensibilidad para futuras capacidades de IA y análisis.
Tecnologías clave: TypeScript para seguridad de tipos, Express.js como servidor web, Mastra Core preparado para funciones avanzadas de IA, protocolo A2A para la integración con Telex.im y ngrok para exponer un endpoint público seguro durante la fase de pruebas. Todo el desarrollo siguió buenas prácticas de diseño de API y manejo robusto de errores.
Motivación y diseño: Elegí construir un rastreador de tareas porque resuelve una necesidad real de gestión de proyectos, tiene funcionalidades claras y comprobables y encaja naturalmente en una interfaz de chat. El agente soporta comandos en lenguaje natural como create task [título], list tasks, complete task [id/título], delete task [id/título] y help, con respuestas amigables, uso de emojis para mejorar la experiencia y mensajes de error útiles.
Estructura del proyecto: La organización del código incluyó carpetas para agents, routes y types, con un archivo principal para levantar el servidor Express. El almacenamiento inicial fue en memoria para la MVP y está pensado para migrar a bases de datos como MongoDB o PostgreSQL en próximas fases.
Integración A2A: La parte crítica fue comprender el formato de mensajes A2A entrantes y salientes para Telex.im y asegurar que los endpoints respondieran con el formato esperado, incluyendo metadatos como el identificador del mensaje original y el nombre del agente. Se realizaron pruebas extensivas con curl y con el endpoint público de ngrok para validar el flujo completo.
Implementación principal: El agente procesa mensajes de usuario, detecta comandos y ejecuta acciones sobre el almacén de tareas. Las respuestas están formateadas para chat con feedback claro sobre la acción realizada, por ejemplo confirmaciones de creación con ID y estado, listados agrupados por estado y soporte para operaciones por ID o por coincidencia de título.
Retos y soluciones: Problemas como la configuración inicial de Mastra, la comprensión del protocolo A2A y la exposición de un endpoint público se resolvieron con un enfoque MVP, lectura detallada de ejemplos JSON y configuración de autenticación en ngrok. Además se añadieron anotaciones de tipo explícitas en Express para evitar advertencias de TypeScript.
Pruebas y validación: Se realizaron pruebas locales y públicas simulando llamadas A2A y validando respuestas HTTP, códigos de estado y mensajes de error. Las solicitudes malformadas devuelven 400 con mensajes explicativos y los errores de servidor devuelven 500 con la información necesaria para depuración.
Características destacadas: gestión inteligente de tareas con IDs y timestamps automáticos, organización por estado pendiente en progreso completada, operaciones por ID o título, respuestas amigables con emojis, diseño RESTful, manejo completo de errores y endpoints de health check para supervisión.
Configuración para Telex: Se preparó un flujo JSON de Mastra para registrar el agente en Telex.im apuntando al endpoint público del agente, facilitando la integración y despliegue en entornos de pruebas y producción.
Resultados y demo: El agente demostró funcionalidad útil de gestión de tareas y una integración limpia con Telex.im, validando la arquitectura y las decisiones de diseño. El proyecto sirve como base para añadir capacidades de IA avanzada, recordatorios y colaboración en equipo.
Futuras mejoras: migrar almacenamiento a bases de datos como MongoDB o PostgreSQL, integración completa con Mastra para NLP, gestión de fechas y recordatorios, funcionalidades colaborativas y panel de analítica con métricas de productividad.
Sobre Q2BSTUDIO: En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, con experiencia en soluciones de inteligencia artificial, ciberseguridad y servicios cloud aws y azure. Ofrecemos servicios integrales que van desde el diseño y desarrollo de aplicaciones hasta la automatización de procesos y soluciones de inteligencia de negocio. Si buscas potenciar tus proyectos con Inteligencia Artificial para empresas, contamos con experiencia práctica en agentes IA y arquitecturas escalables.
Servicios recomendados: para proyectos que requieren soluciones personalizadas disponemos de nuestro servicio de desarrollo de aplicaciones a medida y para integrar modelos y despliegues en la nube ofrecemos servicios cloud aws y azure accesibles y seguros a través de nuestra oferta en la nube. Además proporcionamos servicios de ciberseguridad y pentesting para proteger tus aplicaciones y datos, así como soluciones de inteligencia de negocio y Power BI para obtener valor accionable de tus datos.
Palabras clave y posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi son capacidades centrales de Q2BSTUDIO y están integradas en nuestra oferta para ayudar a empresas a transformar sus procesos y productos con tecnología de vanguardia.
Conclusión: Construir este Agente Rastreador de Tareas fue una experiencia de aprendizaje que combina diseño de APIs, integración de protocolos y desarrollo en TypeScript con visión hacia la inteligencia artificial aplicada. En Q2BSTUDIO estamos listos para ayudarte a llevar proyectos similares a producción, desde el desarrollo a medida hasta la integración en la nube y la protección mediante ciberseguridad.
Contacto y siguientes pasos: Si quieres explorar cómo un agente IA puede integrarse en tus flujos de trabajo o necesitas una solución de software a medida para tu empresa, en Q2BSTUDIO podemos asesorarte y diseñar la mejor arquitectura para tu caso.
