Framework · Mastra
Mastra de un vistazo
Un framework para TypeScript que reúne agentes, workflows con suspensión y reanudación, memoria, evaluaciones y la interfaz de Studio en un solo paquete. Se integra en aplicaciones Next.js, Express o Hono; el núcleo usa la licencia Apache-2.0, mientras que los directorios ee/ usan una licencia empresarial.
Ideal para: Equipos de TypeScript que quieren una sola stack para agentes, workflows, memoria y evaluaciones.
Datos clave
- Mantenedor
- Mastra
- Lenguajes
- TypeScript
- Licencia
- Apache-2.0 (core)
- Última versión
@mastra/core 1.73.0· 1 de octubre de 2026- Repositorio
- mastra-ai/mastra
- Opción alojada
- Mastra Cloud / Mastra Platform
Inicio rápido
Instala el paquete, configura las credenciales y ejecuta el agente más sencillo de la documentación oficial. Los ID de modelo son los que usa la documentación y puede que no estén habilitados en tu cuenta.
npm install @mastra/core@latest zod@latest typescript@latest @types/node@latest mastra@latest (or scaffold: npm create mastra@latest)// src/mastra/agents/weather-agent.ts
import { Agent } from '@mastra/core/agent'
import { weatherTool } from '../tools/weather-tool.ts'
export const weatherAgent = new Agent({
id: 'weather-agent',
name: 'Weather Agent',
instructions: `
You are a helpful weather assistant that provides accurate weather information.
Your primary function is to help users get weather details for specific locations. When responding:
- Include relevant details like humidity, wind conditions, and precipitation
- Keep responses concise but informative
Use the weatherTool to fetch current weather data.
`,
// Use a string in provider/model format, not provider:model or a provider object.
model: 'openai/gpt-5.6-sol',
tools: { weatherTool },
})
// run.mjs (after registering the agent in src/mastra/index.ts)
import { mastra } from './src/mastra/index.ts'
const agent = mastra.getAgentById('weather-agent')
const response = await agent.generate('Weather in SF')
console.log(response.text)Funciones
| Cualquier modelo | Sí | Cadenas del enrutador de modelos con el formato proveedor/modelo |
|---|---|---|
| Cliente MCP | Sí | |
| Servidor MCP | Sí | MCPServer expone agentes, herramientas, workflows, prompts y recursos |
| Multiagente | Sí | Los agentes pueden actuar como herramientas para otros agentes |
| Ejecuciones duraderas | Sí | Suspensión y reanudación con snapshots en libSQL, Postgres y otros |
| Aprobación humana | Sí | suspend() y resume() recopilan la intervención humana |
| Trazas | Sí | Exportadores OTel para Langfuse, Braintrust, Datadog y LangSmith |
| Evaluaciones | Sí | Los evaluadores se ejecutan en vivo con muestreo o sin conexión en CI |
Cambios recientes
- npm create mastra ahora crea un harness de uso general con workspace, herramientas de shell, memoria y programaciones.
- Mastra Factory está orientado a fábricas de software creadas con agentes de programación.