Voyage AI: Voyage Code 2
ينشئ Voyage Code 2 تضمينات للشيفرة المصدرية والنصوص المرتبطة بها من أجل البحث الدلالي في المستودعات. وتستطيع الأسئلة باللغة الطبيعية أو مقاطع الشيفرة أو الاستعلامات التي تجمعهما استرجاع تنفيذات ذات صلة؛ ويستخدم هذا الإصدار نافذة سياق تبلغ 16,000 رمز ومتجهات ذات 1,536 بُعدًا.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
ينشئ Voyage Code 2 تضمينات عددية للشيفرة المصدرية والنصوص المرتبطة بها. وقد صُمم للاسترجاع الدلالي للشيفرة، حيث يصف المطور سلوكًا أو يقدم جزءًا من الشيفرة فيعثر نظام البحث على تنفيذات ذات صلة. وتشمل أمثلة الشركة المصنّعة أسئلة باللغة الطبيعية ومقاطع شيفرة ومزيجًا منهما كمدخلات للبحث.
استخدمه لبناء تجربة بحث في المستودع تتمحور حول أسئلة تطوير حقيقية. فقد يبحث مطور عن الدالة التي لا تزيل إلا أول محرف يطابق شرطًا وآخر محرف يطابقه، أو عن جزء من مشروع يطبق اجتيازًا معينًا لشجرة. جهّز استعلامات تعبر عن السلوك بدقة، بما فيها الشرط الذي يميز التنفيذ المقصود عن تنفيذ قريب لكنه غير صحيح.
فهرس الشيفرة بوحدات مفيدة بدلًا من تقسيم كل ملف عند عدد عشوائي من المحارف. احتفظ بتوقيع الدالة وجسمها والشرح ذي الصلة معًا. وعندما تعتمد دالة مساعدة على أنواع أو ثوابت محلية، احتفظ بقدر كافٍ من النص المحيط لفهم غرضها. وخزّن مسارات الملفات ومراجعات المستودع ومواضع المصدر خارج التضمين حتى تفتح النتيجة الشيفرة الأصلية مباشرة.
يوفر هذا الإصدار نافذة سياق تبلغ 16,000 رمز وينتج تضمينات ذات 1,536 بُعدًا. اضبط سعة فهرس المتجهات لهذا التمثيل، وحافظ على ارتباط تضمينات الاستعلامات والمستندات بالنموذج نفسه. ويمكن لمجموعة مفهرسة أصلًا باستخدام Voyage Code 2 الاحتفاظ بتمثيل استرجاع متسق أثناء تحديث سجلاتها المصدرية. وينبغي التعامل مع الانتقال إلى إصدار تضمين آخر بوصفه ترحيلًا للفهرس، مع مقارنة صريحة على المستودع نفسه.
لاستعلام باللغة الطبيعية، صف العملية والمدخلات والنتيجة ذات الصلة. ولاستعلام بالشيفرة، أرفق المقطع الذي تريد مطابقة منطقه واشرح أي شرط يهم البحث. فالبحث عن معالجة إعادة المحاولة مثلًا يمكن أن يحدد ما إذا كانت الشيفرة المطلوبة تعيد المحاولة بعد انتهاء مهلة أو بعد رد خطأ كامل. ويجب التحقق من هذا الفرق في المصدر المسترجع قبل استخدامه في تعديل.
حافظ على قابلية تتبع الوثائق والشيفرة المصدرية عند فهرستهما معًا. فقد يوفر مقطع تفسيري سياقًا مفيدًا، بينما يكون التنفيذ هو المادة التي يحتاج المطور إلى فحصها. ضع تسميات لأنواع السجلات هذه حتى تعرض صفحة البحث الوجهة الصحيحة ويستطيع مساعد البرمجة التمييز بين وصف ومصدر قابل للتنفيذ.
استخدم المقاطع المسترجعة كسياق للتنقل في المستودع أو اكتشاف التنفيذات أو الخطوة التالية لمساعد برمجي. واحتفظ بالمقطع ذي الصلة كاملًا وموضعه عند تمريره إلى المرحلة التالية. يساعد التشابه على العثور على شيفرة مرشحة؛ أما مراجعة المدخلات الفعلية والآثار الجانبية والعقود فتحدد ما إذا كان المرشح يحل المشكلة الحالية.
قيّم الاسترجاع على مجموعة أسئلة حقيقية لها إجابات معروفة في المصدر. أدرج دوال تغيرت أسماؤها وتعليقات مضللة وأدوات مساعدة متشابهة ذات حالات حدّية مختلفة واستعلامات تستخدم مفردات غير موجودة في الشيفرة. وتحقق من ظهور التنفيذ المتوقع ضمن النتائج المفيدة ومن توفير المقطع المعروض سياقًا كافيًا لتقييمه. احتفظ بهذه الأسئلة مع نمو المستودع حتى يمكن مقارنة تغييرات الاستخراج أو حدود المقاطع أو الفهرسة باستخدام المهام نفسها.
Ailoot Ultra · التضمينات POST /v1/embeddings voyage-code-2
voyage-code-2البداية
ينشئ Voyage Code 2 تضمينات للشيفرة المصدرية والنصوص المرتبطة بها من أجل البحث الدلالي في المستودعات. وتستطيع الأسئلة باللغة الطبيعية أو مقاطع الشيفرة أو الاستعلامات التي تجمعهما استرجاع تنفيذات ذات صلة؛ ويستخدم هذا الإصدار نافذة سياق تبلغ 16,000 رمز ومتجهات ذات 1,536 بُعدًا.
- المدخلات المقبولة
- النص
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text- الإخراج
embedding
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود voyage-code-2 الشروط: استخدم محدِّد نموذج Ailoot الدقيق. | القيمة الافتراضية— |
الحقلinput | النوعstring or array<string> | المتطلبمطلوب | القيم والحدود الشروط: نص أو قائمة نصوص؛ احتفظ بمتجه لكل عنصر بيانات مُعاد وبفهرس ذلك العنصر. | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, input |
المعلمةoptional | المواصفات |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتأرسل النص مع النموذج المختار؛ واحتفظ بكل متجه مُعاد وفهرسه. |
دورة الحياة: synchronous
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالأسعار الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.0004 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · التضمينات
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "voyage-code-2",
"input": "The quick brown fox jumps over the lazy dog"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o embeddings.json
# Keep every data item and its index, the full usage object and response headers.
استلام النتائج وحفظها
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra voyage-code-2
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Voyage AI: Voyage Code 2
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·voyage-code-2:text→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·voyage-code-2:model,input