Framework · Mastra
Mastra w skrócie
Framework TypeScript, który łączy w jednym pakiecie agenty, workflows z obsługą wstrzymywania i wznawiania, pamięć, evals i interfejs Studio. Można go dodać do aplikacji Next.js, Express lub Hono; rdzeń jest objęty licencją Apache-2.0, a katalogi ee/ — licencją enterprise.
Najlepszy do: Zespoły TypeScript, które chcą korzystać z jednego stosu do agentów, workflows, pamięci i evals.
Najważniejsze informacje
- Opiekun
- Mastra
- Języki
- TypeScript
- Licencja
- Apache-2.0 (core)
- Najnowsza wersja
@mastra/core 1.73.0· 1 października 2026- Repozytorium
- mastra-ai/mastra
- Opcja hostowana
- Mastra Cloud / Mastra Platform
Quickstart
Zainstaluj pakiet, skonfiguruj dane uwierzytelniające, a następnie uruchom najprostszego agenta z oficjalnej dokumentacji. Użyte identyfikatory modeli pochodzą z dokumentacji; dostęp do nich może nie być włączony na Twoim koncie.
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)Funkcje
| Dowolny model | Tak | Ciągi routera modeli w formacie provider/model |
|---|---|---|
| Klient MCP | Tak | |
| Serwer MCP | Tak | MCPServer udostępnia agenty, narzędzia, workflows, prompty i zasoby |
| Wielu agentów | Tak | Agenty mogą działać jako narzędzia innych agentów |
| Trwałe uruchomienia | Tak | Wstrzymywanie i wznawianie ze snapshotami w libSQL, Postgres i innych bazach |
| Zatwierdzanie przez człowieka | Tak | suspend() i resume() zbierają dane od człowieka |
| Śledzenie | Tak | Eksportery OTel do Langfuse, Braintrust, Datadog i LangSmith |
| Ewaluacje | Tak | Scorers działają na żywo z próbkowaniem albo offline w CI |
Najnowsze zmiany
- npm create mastra tworzy teraz szkielet uniwersalnego harnessu z workspace, narzędziami powłoki, pamięcią i harmonogramami.
- Mastra Factory jest przeznaczony do software factories opartych na agentach kodujących.