Framework · Mastra
Mastra em resumo
Um framework para TypeScript que reúne agentes, workflows com suspensão e retomada, memória, avaliações e a interface Studio em um único pacote. Pode ser integrado a aplicações Next.js, Express ou Hono; o núcleo usa a licença Apache-2.0, enquanto os diretórios ee/ usam uma licença empresarial.
Ideal para: Equipes TypeScript que querem uma stack única para agentes, workflows, memória e avaliações.
Principais informações
- Responsável pela manutenção
- Mastra
- Linguagens
- TypeScript
- Licença
- Apache-2.0 (core)
- Versão mais recente
@mastra/core 1.73.0· 1 de outubro de 2026- Repositório
- mastra-ai/mastra
- Opção hospedada
- Mastra Cloud / Mastra Platform
Início rápido
Instale o pacote, configure as credenciais e execute o agente mais simples da documentação oficial. Os IDs dos modelos são os usados na documentação e talvez não estejam habilitados na sua conta.
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)Recursos
| Qualquer modelo | Sim | Strings de roteamento de modelos no formato provedor/modelo |
|---|---|---|
| Cliente MCP | Sim | |
| Servidor MCP | Sim | MCPServer disponibiliza agentes, ferramentas, workflows, prompts e recursos |
| Multiagente | Sim | Agentes podem atuar como ferramentas para outros agentes |
| Execuções duráveis | Sim | Suspensão e retomada com snapshots em libSQL, Postgres e outros |
| Aprovação humana | Sim | suspend() e resume() coletam a entrada humana |
| Rastreamento | Sim | Exportadores OTel para Langfuse, Braintrust, Datadog e LangSmith |
| Avaliações | Sim | Os avaliadores são executados em produção com amostragem ou offline no CI |
Mudanças recentes
- npm create mastra agora cria a estrutura de um harness de uso geral com workspace, ferramentas de shell, memória e agendamentos.
- Mastra Factory é voltado a fábricas de software criadas com agentes de programação.