mastra

ماسسترا

Mastra هو إطار عمل TypeScript الذي يساعدك على بناء تطبيقات وميزات الذكاء الاصطناعي بسرعة. يمنحك مجموعة من البدائية التي تحتاجها: سير العمل ، والوكلاء ، والخرقة ، والتكامل ، والمزامنة ، و evals. يمكنك تشغيل Mastra على جهازك المحلي ، أو النشر على سحابة بدون خادم.

ميزات Mastra الرئيسية هي:

سمات	وصف
نماذج LLM	يدعم Mastra مجموعة متنوعة من مزودي LLM ، بما في ذلك Openai ، Anthropic ، Google Gemini. يمكنك اختيار النموذج والمزود المحدد ، واختيار مطالبات النظام ومستخدمها ، وتحديد ما إذا كان سيتم بث الاستجابة.
الوكلاء	الوكلاء هي أنظمة حيث يختار نموذج اللغة سلسلة من الإجراءات. في MastRA ، توفر الوكلاء نماذج LLM مع أدوات وسير عمل وبيانات متزامنة. يمكن للوكلاء استدعاء وظائفك الخاصة أو واجهات برمجة التطبيقات الخاصة بتكامل الجهات الخارجية والوصول إلى قواعد المعرفة التي تقوم بإنشائها.
أدوات	يتم كتابة الأدوات التي يمكن تنفيذها بواسطة الوكلاء أو سير العمل ، مع الوصول المدمج للتكامل والتحقق من صحة المعلمة. تحتوي كل أداة على مخطط يحدد مدخلاتها ، ودالة المنفذ التي تنفذ منطقها ، والوصول إلى عمليات التكامل التي تم تكوينها.
مهام سير العمل	تدفقات سير العمل هي آلات الحالة المستندة إلى الرسم البياني. لديهم حلقات ، وتفرع ، وينتظرون المدخلات البشرية ، وتضمين سير العمل الأخرى ، والتعامل مع الأخطاء ، والاحتجاز ، والتحليل وما إلى ذلك. يمكن بناؤها في رمز أو مع محرر مرئي. تحتوي كل خطوة في سير العمل على تتبع قياس الأوبنتيل.
خرقة	يتيح لك الجيل المتمثل في الاسترداد (RAG) بناء قاعدة معرفة للوكلاء. RAG هو خط أنابيب ETL مع تقنيات الاستعلام المحددة ، بما في ذلك التضخيم والتضمين والبحث في المتجهات.
التكامل والمزامنة	في MastRA ، المزامنة هي وظائف غير متزامنة يمكن نشرها كمهام خلفية عبر بيئات التنفيذ المختلفة. التكاملات هي عملاء واجهة برمجة التطبيقات التي يتم إنشاؤها تلقائيًا وآمنة من النوع لخدمات الطرف الثالث والتي يمكن استخدامها كأدوات للوكلاء أو الخطوات في سير العمل.
evals	EVALs هي اختبارات تلقائية تقوم بتقييم مخرجات LLM باستخدام الأساليب ذات القواعد النموذجية والإحصائية. كل تقييم يعيد درجة تطبيع بين 0-1 يمكن تسجيلها ومقارنتها. يمكن تخصيص EVALs مع المطالبات الخاصة بك ووظائف التسجيل.

بداية سريعة

المتطلبات الأساسية

• node.js (v20.0+)

احصل على مفتاح واجهة برمجة تطبيقات مزود LLM

إذا لم يكن لديك مفتاح API لمزود LLM ، فيمكنك الحصول على واحد من الخدمات التالية:

• Openai
• الإنسان
• جوجل الجوزاء

إذا لم يكن لديك حساب مع هؤلاء مقدمي الخدمات ، فيمكنك التسجيل والحصول على مفتاح API. يتطلب Openai و Hothropic بطاقة ائتمان للحصول على مفتاح API. الجوزاء لا وله طبقة حرة سخية لواجهة برمجة التطبيقات الخاصة بها.

إنشاء مشروع جديد

كخطوة أولى ، قم بإنشاء دليل مشروع وانتقل إليه:

mkdir hello-mastra
cd hello-mastra

بعد ذلك ، قم بتهيئة مشروع TypeScript باستخدام NPM:

npm init -y
npm install typescript tsx @types/node @mastra/core@alpha --save-dev

إضافة ملف index.ts

mkdir src
touch src/index.ts

ثم ، أضف هذا الرمز إلى src/index.ts :

 import { Agent } from '@mastra/core' ;

async function main ( ) {
  const agent = new Agent ( {
    name : 'story-writer' ,
    maxSteps : 3 ,
    model : {
      provider : 'OPEN_AI' ,
      name : 'gpt-4o' ,
      toolChoice : 'auto' ,
    } ,
    instructions : `You are a helpful assistant who writes creative stories.` ,
    tools : { } ,
  } ) ;

  const result = await agent . text ( {
    messages : [ 'Write a short story about a robot learning to paint.' ] ,
  } ) ;

  console . log ( 'Agent response:' , result . text ) ;
}

main ( ) ;

تشغيل البرنامج النصي

أخيرًا ، قم بتشغيل البرنامج النصي:

OPENAI_API_KEY= < your-openai-api-key > npx tsx src/index.ts

إذا كنت تستخدم الأنثروبور ، فقم بتعيين ANTHROPIC_API_KEY . إذا كنت تستخدم Gemini ، فقم بتعيين GOOGLE_GENERATIVE_AI_API_KEY .

يدعم

لدينا خلاف مجتمع مفتوح. تعال وقل مرحبًا وأخبرنا إذا كان لديك أي أسئلة أو تحتاج إلى أي مساعدة في تشغيل الأشياء.

من المفيد جدًا أيضًا إذا تركت المشروع نجمًا هنا في الجزء العلوي من الصفحة