اختر Auto أو TokenLab Verified أو Official لكل طلب، مع عرض الأسعار مسبقاً.اطلع على الجديد

Mistral: Codestral Embed

Codestral Embed هو نموذج التضمين من Mistral للبحث في الكود المصدري. يقوم بتعيين الأكواد والاستعلامات ذات الصلة إلى متجهات لاسترجاع المستودعات، مما يساعد مساعدي البرمجة في العثور على الدوال والملفات ذات الصلة قبل توليد الكود أو تعديله.
مقارنة النماذج
codestral-embed
متاحMistralتضمينمتزامن
الإدخال / الإخراج
$0.15 / $0.00
السياق
8K
الأنماط
تضمين

عن Codestral Embed

Codestral Embed هو أول نموذج تضمين (embedding) من Mistral AI مصمم خصيصاً للكود البرمجي. يقوم بتحويل ملفات المصدر، والمقتطفات، والأسئلة باللغة الطبيعية إلى متجهات (vectors) حتى يتمكن مساعد البرمجة من استرجاع الدوال الصحيحة قبل كتابة أو تعديل أي شيء. تشير Mistral إلى أن النموذج يتفوق على Voyage Code 3 وCohere Embed v4.0 ونموذج التضمين الكبير من OpenAI في تقييمات استرجاع الكود الخاصة بها. أما Mistral Embed، وهو نموذج تضمين النصوص للأغراض العامة من Mistral، فهو الخيار الأنسب للنصوص العادية.

نقاط القوة

  • تم تدريبه لاسترجاع الكود، ويغطي البحث من اللغة الطبيعية إلى الكود، والتشابه بين الأكواد، واسترجاع SQL ضمن مجموعة تقييمات Mistral.
  • يتم ترتيب أبعاد المخرجات حسب الأهمية، مما يتيح لك الاحتفاظ بأي عدد من الأبعاد الأولى لتقليص حجم الفهرس.
  • تفيد Mistral بأن استخدام 256 بعداً بدقة int8 يتفوق على نماذج تضمين الكود المنافسة التي اختبرتها.
  • مناسب للتوليد المعزز بالاسترجاع (RAG) لوكلاء البرمجة، واكتشاف التكرار، والتجميع، وتحليلات الكود.

متى تستخدم نموذجاً آخر

  • يقوم بالتضمين فقط؛ فهو لا يولد الكود أو يشرحه، لذا لا تزال بحاجة إلى نموذج محادثة للحصول على الإجابات.
  • تنصح Mistral باستخدام أجزاء (chunks) بحجم 3,000 حرف تقريباً مع تداخل قدره 1,000 حرف، لأن الأجزاء الأكبر تضعف جودة الاسترجاع.
  • بالنسبة للمستندات غير البرمجية مثل السياسات أو مقالات الدعم، يعد نموذج تضمين النصوص العام الخيار الأكثر ملاءمة.

البدء

  1. إنشاء مفتاح API

    أنشئ مفتاح في Console واستخدمه مع جميع النماذج على المنصة.

  2. إرسال طلبك الأول

    انسخ المثال الخاص بلغة البرمجة التي تستخدمها وقم بتشغيله مقابل نقطة النهاية (endpoint).

    تضميننقطة اتصال TokenLab
    POST/v1/embeddings
    curl -X POST "https://api.tokenlab.sh/v1/embeddings" \
      -H "Authorization: Bearer sk-xxx" \
      -H "Content-Type: application/json" \
      -d '{
      "encoding_format": "float",
      "model": "codestral-embed",
      "input": "The quick brown fox jumps over the lazy dog."
    }'

التسعير

ينطبق سعر Verified على مسار Verified، وهو الأقل تكلفة في معظم النماذج. سعر Official هو السعر المعلن من صانع النموذج وينطبق على مسار Official الأكثر موثوقية. يحاسب خيار Auto بناءً على المسار الذي يكمل الطلب.

تضمين

لكل 1M Token
سعر Official
المدخلات $0.15 / المخرجات $0.00 / قراءة الذاكرة المؤقتة $0.015
سعر Verified
—
خصم
—
أسعار كاش الـ prompt

قراءة الذاكرة المؤقتة

سعر Official
$0.015
سعر Verified
—
خصم
—

الاستخدام والنشاط

معدل النجاح هو نسبة الطلبات المكتملة. زمن الاستجابة هو مدة الاستجابة الكاملة؛ ويعني P95 أن 95% من الطلبات اكتملت ضمن ذلك الوقت.

الاستخدام والتوفر

آخر 24 ساعة
الطلبات
معدل النجاح
زمن الاستجابة P95
إجمالي الرموز
أداء النموذج
تظهر المقاييس بمجرد استيفاء حدود الخصوصية وحجم البيانات.

تستند البيانات إلى طلبات المستخدمين المجمعة، باستثناء عمليات التحقق من الحالة.

فتح في Console

افتح Codestral Embed في Console وجهز الرسالة للتعديل أو الإرسال.

ساعدني في تجربة codestral-embed عبر embedding في /v1/embeddings. اعرض النتيجة والتكلفة.

حالات الاستخدام

  • البحث في المستودعات لوكلاء البرمجة

    فهرسة كل دالة وملف في قاعدة الكود، ثم استرجاع أقرب المطابقات لوصف المهمة قبل أن يقوم الوكيل بتعديل الكود.

  • البحث عن الكود باللغة الطبيعية

    السماح للمطورين بكتابة سؤال مثل "كيف تتم معالجة عمليات إعادة المحاولة؟" والحصول على ملفات المصدر ذات الصلة بدلاً من نتائج الكلمات المفتاحية.

  • اكتشاف التكرار والنسخ المتطابقة تقريباً

    تضمين الدوال عبر الخدمات وتحديد الأزواج ذات المتجهات المتقاربة جداً، مما يشير إلى منطق منسوخ يستحق الدمج.

  • مطابقة المشكلات بالكود

    تضمين تقارير الأخطاء ومطابقتها مع الملفات الأكثر احتياجاً للإصلاح، كخطوة أولى لروبوتات الفرز.

أمثلة Prompt

أين نتحقق من توقيعات الـ webhook في هذا المستودع؟

def retry_with_backoff(fn, attempts=5): ... (تضمين دالة للعثور على مساعدين مشابهين في خدمات أخرى)

SELECT customer_id, SUM(total) FROM orders GROUP BY customer_id HAVING SUM(total) > 1000

هذا النموذج بتسعير مشروط. مجاميع الرموز الشهرية وحدها لا تنتج تقديرًا موثوقًا؛ استخدم التسعير التفصيلي لمواصفات الطلب وذاكرة التخزين المؤقت والنافذة الزمنية المعمول بها.

FAQ

فيم يُستخدم Codestral Embed؟

الاسترجاع عبر الكود المصدري. تقوم بتضمين أجزاء الكود والاستعلامات، وتخزين المتجهات، وجلب أقرب الأجزاء بناءً على التشابه. المهام النموذجية هي البحث الدلالي في الكود، واسترجاع السياق لوكلاء البرمجة، واكتشاف التكرار، وتجميع الكود حسب الغرض.

ما الفرق بين Codestral Embed وMistral Embed؟

Codestral Embed متخصص في الكود والاستعلامات المتعلقة به، بينما Mistral Embed هو نموذج نصي عام للمستندات، والتجميع، والتوليد المعزز بالاسترجاع عبر النصوص العادية. استخدم Codestral Embed للمستودعات البرمجية وMistral Embed لقواعد المعرفة والمقالات.

هل يمكنني تقليل حجم المتجه؟

نعم. تقوم Mistral بترتيب أبعاد المخرجات حسب الأهمية، لذا يمكنك الاحتفاظ ببادئة أقصر للحصول على فهرس أصغر. تشير Mistral إلى أن 256 بعداً بدقة int8 لا تزال تتفوق على نماذج تضمين الكود المنافسة التي اختبرتها، ولكن تحقق من دقة الاسترجاع (recall) على الكود الخاص بك.

كيف يجب أن أقسم الكود قبل تضمينه؟

توصي Mistral بأجزاء يبلغ حجمها حوالي 3,000 حرف مع تداخل قدره 1,000 حرف. الأجزاء الأكبر قللت من أداء الاسترجاع في اختباراتها. قم بالتقسيم عند حدود الدوال أو الفئات (classes) حيثما أمكن، واحتفظ بمسار الملف واسم الرمز مع كل جزء.

هل يقوم بتوليد الكود؟

لا. هو يعيد المتجهات فقط. قم بإقرانه بنموذج محادثة برمجية: يقوم Codestral Embed بالعثور على الكود ذي الصلة، ويقوم نموذج المحادثة بقراءته وكتابة التغيير.

كم تكلفة Codestral Embed؟

على TokenLab تكلف Codestral Embed المدخلات $0.15 / المخرجات $0.00 لكل 1M Token. التفاصيل الكاملة في جدول التسعير أعلاه. تعتمد الأسعار على وحدة الفوترة والمواصفات والاستخدام. قارن بين الشروط المتطابقة في التسعير التفصيلي للنموذج؛ السعر الواحد لا يحدد التكلفة الإجمالية.

ما نقطة النهاية التي يجب أن يستخدمها Codestral Embed؟

استخدم https://api.tokenlab.sh/v1/embeddings كافتراضي لـ Codestral Embed. إذا كانت الصيغة الأصلية للمزود مدعومة فإن API workbench يعرضها أيضاً.

ما العمليات التي يدعمها Codestral Embed؟

Codestral Embed يدعم تضمين. اختر عملية في API workbench أعلاه لرؤية نقطة النهاية وعينة الكود المطابقة.

مقارنة Codestral Embed

المصادر

تمت المراجعة في ٠٢‏/١٠‏/٢٠٢٦

المزيد من Mistral

نماذج ذات صلة