Mistral: Codestral Embed
codestral-embed- الإدخال / الإخراج
- $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 حرف، لأن الأجزاء الأكبر تضعف جودة الاسترجاع.
- بالنسبة للمستندات غير البرمجية مثل السياسات أو مقالات الدعم، يعد نموذج تضمين النصوص العام الخيار الأكثر ملاءمة.
البدء
إنشاء مفتاح API
أنشئ مفتاح في Console واستخدمه مع جميع النماذج على المنصة.
إرسال طلبك الأول
انسخ المثال الخاص بلغة البرمجة التي تستخدمها وقم بتشغيله مقابل نقطة النهاية (endpoint).
تضميننقطة اتصال TokenLabPOST/v1/embeddingscurl -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
- —
- خصم
- —
قراءة الذاكرة المؤقتة
- سعر Official
- $0.015
- سعر Verified
- —
- خصم
- —
| سعر Officialلكل 1M Token | سعر Verifiedلكل 1M Token | خصم | |
|---|---|---|---|
| تضمين | المدخلات $0.15 / المخرجات $0.00 / قراءة الذاكرة المؤقتة $0.015 | — | — |
| أسعار كاش الـ prompt | |||
| قراءة الذاكرة المؤقتة | $0.015 | — | — |
الاستخدام والنشاط
معدل النجاح هو نسبة الطلبات المكتملة. زمن الاستجابة هو مدة الاستجابة الكاملة؛ ويعني 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
المصادر
تمت المراجعة في ٠٢/١٠/٢٠٢٦