Construir flujos de trabajo con agentes nunca fue sencillo hasta la llegada de plataformas como Mastra y Telex que facilitan enormemente la integración entre agentes IA y entornos colaborativos. En esta guía práctica traduzco y adapto un ejemplo real de integración entre un Agente Mastra y Telex usando A2A (App-to-App) para permitir comunicación fluida entre ambas plataformas.

Visión general: Telex es una plataforma educativa tipo Slack que admite apps y agentes que intercambian mensajes estructurados. Mastra es un framework moderno para crear, desplegar y escalar agentes de inteligencia artificial en producción. Combinadas, permiten que Telex envíe mensajes estructurados a Mastra, Mastra los procese con un agente y responda en formato JSON-RPC para que Telex los muestre al usuario en tiempo real.

Preparar Mastra localmente: antes de escribir código conviene instalar y configurar Mastra en el entorno de desarrollo. Los pasos principales son crear un proyecto, instalar los paquetes core de Mastra y definir el agente con sus instrucciones, modelo y herramientas. En el ejemplo se crea un agente llamado Weather Agent con instrucciones para consultar condiciones meteorológicas y una herramienta externa que obtiene datos actuales. También se configura memoria persistente con LibSQL para mantener contexto entre interacciones.

Formato de solicitud A2A: cuando Telex envía datos a un agente lo hace siguiendo el estándar JSON-RPC 2.0. Un mensaje A2A incluye campos como jsonrpc 2.0 id method y params donde params contiene el objeto message con campos role parts y messageId. Es importante que Mastra interprete correctamente ese formato, extraiga el contenido relevante y lo envíe al agente para su procesamiento.

Crear un endpoint A2A personalizado: Mastra permite registrar rutas API personalizadas para procesar solicitudes externas. En el ejemplo se crea una ruta tipo POST en /a2a/agent/:agentId que valida la petición JSON-RPC 2.0, carga el agente correspondiente, convierte los mensajes A2A al formato interno de Mastra, ejecuta el agente y construye una respuesta A2A con artifacts history y estado de la tarea. La respuesta incluye artefactos con texto y resultados de herramientas cuando las hay, además de un historial de conversación con mensajes de usuario y agente.

Vinculación y registro de la ruta en Mastra: dentro del archivo de inicialización de Mastra se registran workflows y agentes y se añade la ruta A2A al arreglo de apiRoutes. También se configura el almacenamiento observabilidad logger y opciones de servidor para generar documentación OpenAPI si se desea.

Despliegue a Mastra Cloud: una vez probado localmente se puede desplegar con la utilidad de Mastra para obtener una URL pública del estilo https://white-cloud-noon.mastra.cloud/a2a/agent/weatherAgent que será el endpoint a registrar en la configuración A2A de Telex. A partir de ese momento Telex podrá enviar mensajes directamente al agente y recibir respuestas en tiempo real.

Beneficios de esta integración: respuesta estructurada y trazable, capacidad de invocar herramientas desde el agente, persistencia de contexto y facilidad para exponer agentes a aplicaciones educativas u empresariales que usen A2A. Además la arquitectura facilita auditoría y escalado en producción.

Sobre Q2BSTUDIO: en Q2BSTUDIO somos una empresa de desarrollo de software que diseña soluciones a medida para clientes que necesitan aplicaciones robustas e innovadoras. Somos especialistas en aplicaciones a medida y software a medida y ofrecemos servicios avanzados de inteligencia artificial para empresas, agentes IA y desarrollo de workflows automatizados. También contamos con capacidades en ciberseguridad y pentesting para proteger sus sistemas y datos y con servicios cloud aws y azure para desplegar y escalar soluciones en la nube. Si busca potenciar sus procesos con automatización o desarrollar agentes IA integrados con plataformas colaborativas podemos ayudarle con soluciones completas y personalizadas.

Servicios y posicionamiento: nuestros servicios incluyen inteligencia de negocio y power bi para transformar datos en decisiones, así como consultoría en ia para empresas para definir estrategias y modelos de IA aplicables al negocio. Trabajamos integrando agentes IA en sistemas existentes, desarrollando pipelines de datos y desplegando en infraestructuras seguras y escalables. Con enfoque en seguridad ofrecemos auditorías y pruebas de intrusión para garantizar continuidad y confianza.

Recursos y contacto: si su proyecto requiere una solución a medida para integrar agentes IA y plataformas colaborativas podemos apoyarle desde el diseño hasta el despliegue en la nube. Conozca nuestros servicios de inteligencia artificial en Q2BSTUDIO Inteligencia Artificial y si necesita desarrollar una aplicación o software a medida visite nuestra página de desarrollo de aplicaciones y software multiplataforma para ver ejemplos y casos de éxito.

Conclusión: integrar Mastra y Telex mediante A2A ofrece un camino sólido para exponer agentes inteligentes a plataformas de mensajería y educación, con intercambio estandarizado mediante JSON-RPC y posibilidad de escalar en la nube. Si desea incorporar agentes IA, automatizar procesos o mejorar su inteligencia de negocio con Power BI cuente con Q2BSTUDIO para llevar la solución a producción con seguridad y escalabilidad.