Creando mi primer agente usando Mastra

Aprende rápidamente a crear tu primer agente con Mastra en esta guía paso a paso. Encuentra cómo construir y configurar tu propio agente para automatizar tareas y simplificar tu trabajo.

lunes, 3 de noviembre de 2025 • 3 min de lectura • Equipo Q2BSTUDIO

Creando mi primer agente usando Mastra

En este artículo explico cómo construí un agente espiritual basado en la Bhagavad Gita usando Mastra e integrándolo con Telex.im, una plataforma de agentes IA pensada para comunidades educativas que actúa como alternativa a Slack y herramientas de automatización. El agente, llamado Gita Agent, ofrece versos seleccionados, inspiración diaria y orientación temática combinando sabiduría antigua con técnicas modernas de inteligencia artificial.

Visión y objetivo: crear un agente que haga accesible la sabiduría de la Bhagavad Gita mediante tecnología actual, permitiendo peticiones de versos concretos, versos aleatorios o consejos sobre temas como deber, acción y ética. La implementación buscó mantener contexto conversacional, robustez ante errores y una integración limpia con plataformas comunitarias como Telex.im.

Principales capacidades de Mastra usadas: sistema de herramientas para recuperar versos, almacenamiento persistente de memoria conversacional con LibSQLStore, arquitectura de agentes para manejar conversaciones complejas, protocolo A2A para comunicación entre agentes, observabilidad para monitorizar y depurar, gestión de rutas HTTP y seguridad de tipos con TypeScript.

Cómo aprovechamos Mastra: el sistema de agentes facilitó la comprensión de lenguaje natural y la gestión de instrucciones específicas para temas de la Gita. Se integró un modelo avanzado para generación y comprensión de texto, se construyó una herramienta personalizada para la recuperación y formateo de versos, y se implementaron validaciones de entrada y salida y políticas de reintento ante errores de API.

Detalle de la herramienta de versos: la parte más crítica fue diseñar un componente capaz de atender solicitudes específicas y aleatorias, respetar los límites de versos por capítulo, consultar un servicio externo de versos y devolver respuestas consistentes y bien formateadas para su consumo por Telex.im y otros clientes.

Integración A2A con Telex.im: la integración exigió cumplir con JSON-RPC 2.0, mantener un formato de mensajes correcto, validar respuestas y gestionar errores para asegurar comunicación segura y confiable entre agentes y la plataforma. Esto permitió que el agente funcione como un nodo dentro de un ecosistema mayor de agentes IA.

Desafíos encontrados: aleatoriedad de versos respetando límites por capítulo, manejo elegante de fallos en APIs externas, diseño de almacenamiento persistente para el contexto conversacional y mantener un formato de salida uniforme para distintos canales de integración.

Aprendizajes clave: el sistema de herramientas de Mastra es muy flexible y facilita extender capacidades especializadas; el protocolo A2A es sólido para comunicación entre agentes; utilizar TypeScript reduce errores en fases tempranas; y la gestión de errores y observabilidad son imprescindibles en entornos de producción.

Impacto y resultados: el agente responde a distintos tipos de solicitudes de versos, conserva el contexto de la conversación, ofrece orientación espiritual relevante y escala adecuadamente. La arquitectura implementada facilita añadir comentarios, categorización temática y soporte multilenguaje.

Sobre Q2BSTUDIO: como empresa de desarrollo de software y aplicaciones a medida, en Q2BSTUDIO somos especialistas en inteligencia artificial, ciberseguridad, servicios cloud aws y azure y soluciones de inteligencia de negocio. Ofrecemos servicios integrales desde el análisis hasta la producción, incluyendo desarrollo de agentes IA y soluciones personalizadas que integran modelos de lenguaje con infraestructuras seguras y escalables. Puedes conocer nuestros servicios de inteligencia artificial y cómo aplicamos IA para empresas en proyectos reales y en producción.

Ejemplos de mejoras futuras: añadir comentarios y contextualización a cada verso, clasificar versos por tema para búsquedas semánticas, soporte multilenguaje, mejorar la memoria conversacional con indexación semántica y añadir recitaciones de audio de los versos.

Arquitectura y flujo de trabajo: el agente central coordina herramientas de búsqueda de versos, mantiene memoria en LibSQLStore, expone rutas A2A para la integración con Telex.im y utiliza observabilidad integrada para diagnósticos. Para clientes empresariales que requieren soluciones a medida ofrecemos integración y despliegue gestionado como parte de nuestros servicios de software a medida.

Conclusión: combinar Mastra con una plataforma comunitaria como Telex.im permite crear agentes IA especializados que acercan contenidos antiguos a nuevos públicos. En Q2BSTUDIO podemos ayudar a transformar ideas en soluciones reales, desde agentes IA hasta plataformas seguras y escalables que integran inteligencia de negocio, power bi, ciberseguridad y servicios cloud aws y azure para maximizar el valor y la seguridad de tus proyectos.

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.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.