Construir un agente resumidor de IA en TypeScript utilizando Mastra (Parte 1)

Construir un agente resumidor de IA en TypeScript utilizando Mastra Parte 1

La evolución del desarrollo de inteligencia artificial es veloz. Más allá de llamadas simples a APIs, el verdadero potencial viene con agentes IA autónomos que razonan, usan herramientas y ejecutan tareas sin supervisión constante. En este artículo explicamos cómo crear un agente resumidor con Mastra, un framework pensado para TypeScript que facilita el desarrollo de agentes inteligentes y escalables.

Qué ofrece Mastra: agentes, herramientas y flujos de trabajo. Mastra es un framework open source orientado a desarrolladores que quieren construir agentes IA que piensan, planifican y actúan. Sus tres piezas clave son herramientas, agentes y workflows. Las herramientas son funciones reutilizables con entradas y salidas validadas. Los agentes son el razonador que decide qué herramientas invocar y cuándo. Los workflows definen secuencias de acciones que automatizan procesos complejos.

Requisitos previos. Conocimientos básicos de TypeScript y Node.js, Node.js v18 o superior, y una clave de API de Google AI para acceder a modelos como Gemini. Para scraping web se recomiendan librerías como axios y cheerio. Estos elementos permiten que el agente obtenga contenido de páginas y genere resúmenes coherentes.

Preparar el proyecto. Mastra incluye un CLI que agiliza la creación de proyectos. El flujo típico crea una estructura de carpetas en src mastra agents y tools. Para este ejemplo vamos a eliminar ejemplos innecesarios y crear dos componentes principales: una herramienta web scraper que extrae contenido de URLs y un agente summarizer que organiza la lógica de resumen.

Estructura recomendada del proyecto. Carpeta principal ai-summarizer con src mastra agents summarizer.ts tools web-scraper.ts un index.ts y un archivo .env para la clave GOOGLE_GENERATIVE_AI_API_KEY. También se incluye package.json y tsconfig.json. Instalar dependencias adicionales como cheerio y axios para el procesamiento de HTML y peticiones HTTP.

Diseño de la herramienta web scraper. La herramienta debe validar la entrada con Zod y devolver un objeto estructurado con campos como title content success y error. En la implementación es importante eliminar scripts estilos y elementos de navegación para extraer texto limpio, y limitar la longitud del contenido para evitar límites de tokens de los modelos.

Configuración de Mastra core. Registrar el agente dentro de la configuración de Mastra para que el framework conozca los agentes disponibles. El agente summarizer incluye instrucciones precisas sobre su rol: llamar a la herramienta de extracción al recibir una URL, manejar errores y generar un resumen estructurado con tema principal puntos clave y una idea principal.

Cómo debe resumir el agente. Las instrucciones guían al agente para producir resúmenes claros y profesionales: un Main Topic en una frase Key Points entre 3 y 5 elementos en formato conciso y un Key Takeaway en una frase. También debe indicar qué hacer si el contenido es demasiado corto o de baja calidad.

Prueba y desarrollo iterativo. Mastra ofrece un playground local para probar agentes y herramientas de forma interactiva. Ejecutar el servidor de desarrollo permite pegar una URL o texto directo y observar cómo el agente decide llamar a la herramienta de scraping y genera el resumen final. Este ciclo facilita depurar instrucciones y mejorar la experiencia.

Beneficios para empresas y cómo Q2BSTUDIO puede ayudar. Si tu organización busca soluciones de inteligencia artificial empresariales o software a medida, en Q2BSTUDIO ofrecemos desarrollo de aplicaciones a medida y servicios especializados en inteligencia artificial ciberseguridad y servicios cloud. Podemos integrar agentes IA en pipelines de automatización y en plataformas de inteligencia de negocio como Power BI. Si necesitas una solución de software a medida visita desarrollo de aplicaciones a medida y para proyectos de IA empresarial descubre nuestras opciones en inteligencia artificial para empresas.

Palabras clave y posicionamiento. Este enfoque es ideal para empresas interesadas en 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. Adoptar agentes que integren scraping análisis y resumen automático aporta ventajas operativas y mejor toma de decisiones.

Siguientes pasos. En la segunda parte de esta serie se mostrará cómo crear una interfaz frontend conectar el agente a una aplicación web y habilitar respuestas en streaming en tiempo real. Mientras tanto puedes adaptar las instrucciones del agente para casos de uso específicos como monitorización de noticias generación de briefs ejecutivos o integración con pipelines de BI.

Conclusión. Construir un agente resumidor con Mastra y TypeScript es una forma práctica de llevar inteligencia artificial a procesos reales. Si quieres que Q2BSTUDIO te acompañe en la creación de agentes IA o en proyectos de automatización ciberseguridad o servicios cloud aws y azure, contacta con nuestro equipo para diseñar una solución a medida que impulse tu transformación digital.