.jpg)
Presentamos CodeMate, un agente de codificación impulsado por inteligencia artificial creado para ayudar a desarrolladores a escribir, depurar y refactorizar código en tiempo real. Este proyecto surge de la necesidad práctica de contar con un asistente ligero que comprenda el contexto del código, explique fragmentos, proponga mejoras y se integre de forma natural en plataformas de comunicación como Telex.im.
El reto consistió en diseñar una herramienta que acompañe el flujo diario de un desarrollador backend que salta entre proyectos, prueba APIs, depura lógica asíncrona y reutiliza fragmentos de código. CodeMate fue diseñado para entender contexto, explicar decisiones, refactorizar código y responder automáticamente evitando fricciones en la comunicación.
Tecnologías y arquitectura: CodeMate combina varias piezas para ofrecer un servicio estable y escalable. El motor de agentes se basa en Mastra, que facilita la definición y orquestación de agentes inteligentes. La comunicación con la plataforma de mensajería se realiza mediante el protocolo A2A y JSON RPC 2.0 de Telex.im. La lógica de servidor se implementó en Node.js con Express y el despliegue se realizó en Railway para integraciones CI CD rápidas. Como modelo LLM se utilizó OpenAI GPT 4o mini para la generación y explicación de código.
Flujo general: un mensaje de usuario llega desde Telex.im en formato JSON RPC 2.0, el servidor lo recibe y lo reenvía al agente Mastra que, mediante la integración con el modelo, genera una respuesta estructurada. Esa respuesta se encapsula siguiendo el formato esperado por Telex para que se muestre correctamente al usuario en la conversación.
Construcción del agente: Mastra permitió definir instrucciones claras para el agente, especificar el modelo LLM y establecer reglas de salida. En el servidor se implementó un manejador que valida la estructura JSON RPC entrante, extrae el texto del usuario, ejecuta la llamada al agente y formatea la respuesta envolviéndola en el objeto jsonrpc result.message que Telex requiere. Antes del despliegue se realizaron pruebas locales con clientes HTTP que simulan llamadas A2A para garantizar cumplimiento de protocolo y formato.
Pruebas y despliegue: las pruebas incluyeron llamadas simuladas desde scripts que replican el payload JSON RPC. Railway facilitó el despliegue automático desde GitHub y la gestión de variables de entorno como la clave del proveedor de IA y el puerto de la aplicación. Finalmente se registró el workflow en Telex.im y la conexión quedó activa permitiendo el flujo de mensajes en tiempo real.
Ejemplo de interacción: un desarrollador solicita refactorizar una función asincrónica por mejor legibilidad. El agente responde con una versión más clara que incorpora async await y un manejo de errores estructurado, explica las razones del cambio y ofrece alternativas según rendimiento o legibilidad. Este tipo de ayuda acelera revisiones de código y mejora la calidad de las bases de código.
Problemas encontrados y soluciones: manejo de respuestas vacías del LLM solucionado ajustando la configuración del modelo y forzando respuestas estructuradas desde Mastra; incompatibilidades con el formato A2A resueltas envolviendo todas las salidas en la estructura jsonrpc result.message; errores de conexión en Railway mitigados fijando explícitamente la variable de entorno PORT; falta de metadatos solucionada añadiendo contextId y taskId para facilitar trazabilidad en Telex.
Aprendizajes clave: el cumplimiento estricto del protocolo A2A es esencial para interoperabilidad; Mastra simplifica la creación de agentes al abstraer la orquestación y las reglas; Railway es ideal para despliegues rápidos; y un buen logging durante desarrollo reduce drásticamente el tiempo de depuración.
Consejos para replicar este proyecto: probar localmente el endpoint A2A antes de desplegar; usar variables de entorno para claves y puertos; mantener las instrucciones del agente simples y centradas en la tarea; aprovechar la abstracción de Mastra para acelerar el desarrollo; y registrar logs detallados en modo desarrollo.
Acerca de Q2BSTUDIO: en Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones empresariales. Ofrecemos servicios de desarrollo de software a medida y aplicaciones a medida, implantación de servicios cloud aws y azure, estrategias de inteligencia de negocio y proyectos de inteligencia artificial y agentes IA para empresas. También contamos con experiencia en ciberseguridad y pentesting para proteger entornos productivos y análisis de datos con Power BI como parte de nuestros servicios de servicios inteligencia de negocio.
Si tu empresa busca integrar IA en sus procesos, automatizar flujos o desplegar agentes IA conversacionales adaptados a necesidades reales, en Q2BSTUDIO ofrecemos consultoría y ejecución completa. Desde arquitecturas cloud en servicios cloud aws y azure hasta cuadros de mando en Power BI para análisis y toma de decisiones, nuestra propuesta cubre todo el ciclo de vida del producto digital.
CodeMate es un ejemplo práctico de cómo combinar agentes inteligentes, protocolos de comunicación y despliegue en la nube para crear asistentes que realmente ayudan a desarrolladores. Si quieres explorar cómo adaptar una solución similar a tus necesidades empresariales o conocer nuestras propuestas de inteligencia artificial para empresas, ponte en contacto con Q2BSTUDIO para una consultoría inicial.
Palabras clave: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi.
