إطار عمل · Mastra
نظرة عامة على Mastra
إطار عمل TypeScript يجمع الوكلاء وسير العمل مع الإيقاف المؤقت والاستئناف والذاكرة والتقييمات وواجهة Studio في حزمة واحدة. يندمج مع تطبيقات Next.js أو Express أو Hono؛ والترخيص الأساسي Apache-2.0، بينما تستخدم المجلدات ee/ ترخيصًا للمؤسسات.
الأنسب لـ: فرق TypeScript التي تريد حزمة متكاملة للوكلاء وسير العمل والذاكرة والتقييمات.
معلومات أساسية
- الجهة المسؤولة عن الصيانة
- Mastra
- اللغات
- TypeScript
- الترخيص
- Apache-2.0 (core)
- أحدث إصدار
@mastra/core 1.73.0· 1 أكتوبر 2026- المستودع
- mastra-ai/mastra
- خيار الاستضافة
- Mastra Cloud / Mastra Platform
البدء السريع
ثبّت الحزمة، واضبط بيانات الاعتماد، ثم شغّل أبسط وكيل وفقًا للوثائق الرسمية. معرّفات النماذج هي المعتمدة في الوثائق، وقد لا تكون مفعّلة في حسابك.
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)الميزات
| أي نموذج | نعم | سلاسل موجّه النماذج بصيغة provider/model. |
|---|---|---|
| عميل MCP | نعم | |
| خادم MCP | نعم | يتيح MCPServer الوكلاء والأدوات وسير العمل والمطالبات والموارد. |
| متعدد الوكلاء | نعم | يمكن للوكلاء العمل كأدوات لوكلاء آخرين. |
| عمليات تنفيذ مستدامة | نعم | الإيقاف المؤقت والاستئناف باستخدام لقطات محفوظة في libSQL وPostgres وغيرها. |
| موافقة بشرية | نعم | تجمع suspend() وresume() مدخلات البشر. |
| التتبّع | نعم | مصدّرات OTel إلى Langfuse وBraintrust وDatadog وLangSmith. |
| التقييمات | نعم | تعمل أدوات التقييم مباشرةً مع أخذ عينات، أو دون اتصال في CI. |
التغييرات الأخيرة
- ينشئ npm create mastra الآن هيكلًا أوليًا لحزمة عامة الاستخدام، يتضمن مساحة عمل وأدوات shell وذاكرة وجداولًا زمنية.
- يستهدف Mastra Factory مصانع البرمجيات المبنية باستخدام وكلاء البرمجة.