Skip to main content
Mastra هو إطار عمل بلغة TypeScript لبناء وكلاء الذكاء الاصطناعي وأدواتهم وسير العمل. اربطه بـ Venice عبر تهيئة نقطة نهاية نموذج مخصّصة متوافقة مع OpenAI.

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

إنشاء مشروع Mastra

أضف مفتاح Venice API إلى ملف .env الخاص بالمشروع الذي تم إنشاؤه:
احتفظ بملف .env خارج إدارة الإصدارات. لا تكشف مفتاح Venice API الخاص بك في التعليمات البرمجية التي تعمل في المتصفح.

إنشاء وكيل مدعوم بـ Venice

أنشئ وكيلًا ووجّه تهيئة النموذج الخاصة به إلى Venice API:
الجزء الأول من id هو تسمية التوجيه في Mastra. يرسل Mastra بقية معرّف النموذج، وهو venice-uncensored، إلى Venice.
اضبط url على عنوان URL الأساسي للـ API الموضح أعلاه. لا تُلحق /chat/completions؛ فـ Mastra يضيف هذا المسار.
سجّل الوكيل في نسخة Mastra الخاصة بك:
شغّل خادم التطوير وافتح عنوان URL الظاهر في الطرفية لاختبار الوكيل داخل Mastra Studio:

توليد استجابة

استرجع الوكيل المسجّل واستدعِ generate():

بث استجابة

استخدم stream() عندما ترغب في عرض المخرجات لحظة وصولها:

إضافة الأدوات

تستخدم أدوات Mastra مخططات Zod للتحقق من مدخلاتها ومخرجاتها. استخدم نموذج Venice يدعم استدعاء الدوال عند إرفاق أدوات بوكيل.
أرفق الأداة بوكيل:

توليد مخرجات مهيكلة

مرّر مخطط Zod عبر structuredOutput لاستقبال بيانات موثّقة:
إذا كان النموذج المختار لا يدعم وضع المخرجات المهيكلة في الـ API، فاضبط jsonPromptInjection: true داخل structuredOutput ليقوم Mastra بإضافة المخطط إلى التوجيه (prompt) بدلًا من ذلك.

تغيير النماذج

لاستخدام نموذج نصي آخر من Venice، حافظ على بادئة التوجيه venice/ واستبدل بقية معرّف النموذج:
تصفّح نماذج Venice المتاحة وتحقق من قدراتها قبل اختيار نموذج لاستدعاء الأدوات أو الرؤية أو المخرجات المهيكلة.

استكشاف الأخطاء وإصلاحها

تأكد من وجود VENICE_API_KEY في البيئة التي يعمل فيها Mastra، ثم أعِد تشغيل خادم التطوير بعد تعديل .env.
استخدم معرّف النموذج تمامًا كما هو معروض في صفحة النماذج. في Mastra، أضف إليه البادئة venice/، مثل venice/venice-uncensored.
اضبط عنوان URL للنموذج على https://api.venice.ai/api/v1. لا تستخدم نقطة النهاية الكاملة /chat/completions.
اختر نموذجًا يدعم استدعاء الدوال، ووضّح متى ينبغي للوكيل استخدام الأداة ضمن تعليماته، وعرّف الأداة باستخدام createTool().

وثائق Mastra

تعرّف على المزيد حول وكلاء Mastra وأدواتها وسير العمل

نماذج Venice

تصفّح النماذج والقدرات المدعومة