Voyage AI: Voyage Code 3

ينشئ Voyage Code 3 تضمينات للاسترجاع من النص إلى الشيفرة ومن الشيفرة إلى الشيفرة ومن نص توثيق الدالة إلى الشيفرة. وتدعم نافذته البالغة 32,000 رمز وأبعاد المتجهات القابلة للاختيار والإخراج المكمّم البحث في المستودعات واختيار سياق الشيفرة لمساعدي البرمجة.

Ailoot Ultra · التضمينات POST /v1/embeddings voyage-code-3

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Voyage Code 3 هو نموذج تضمين متخصص في استرجاع الشيفرة المصدرية. وتصف الشركة المصنّعة مهام من اللغة الطبيعية إلى الشيفرة، ومن الشيفرة إلى الشيفرة، ومن نص توثيق الدالة إلى الشيفرة: فيستطيع سؤال العثور على تنفيذ، ومقطع شيفرة العثور على منطق مرتبط، ووصف دالة تحديد شيفرة ذات صلة. وينتج النموذج متجهات للاسترجاع، وليس ملفًا معدلًا أو برنامجًا مكتملًا.

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

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

تستوعب نافذة السياق البالغة 32,000 رمز مقاطع شيفرة كبيرة. استخدم هذه المساحة عمدًا: فقد تكون دالة كاملة وتبعياتها ذات الصلة أغنى بالمعلومات من كتلة عشوائية مقتطعة وسط تدفق التحكم. حافظ على تنسيق مصدر مقروء وعلى صياغة لغة البرمجة أثناء الاستخراج. وإذا تجاوز ملف مصدري نافذة الإدخال، فقسّمه عند حدود بنيوية مفيدة واحتفظ بالصلة بين المقاطع وملفها الأصلي.

يدعم Voyage Code 3 تضمينات ذات 2,048 أو 1,024 أو 512 أو 256 بُعدًا، مع تمثيلات بالفاصلة العائمة وتمثيلات من ثمانية بتات بإشارة أو دون إشارة وتمثيلات ثنائية. وتدعم هذه الضوابط أحجامًا مختلفة لفهارس المستودعات وإعدادات البحث. قيّم تمثيلًا مضغوطًا باستخدام عمليات البحث الحقيقية نفسها المستخدمة لخط الأساس الأكبر، وتحقق من بقاء الدالة أو الملف الصحيح ضمن النتائج المفيدة.

لمساعد برمجي، استرجع مقاطع المصدر ذات الصلة أولًا، ثم قدم تلك المقاطع ومراجع ملفاتها إلى المكوّن المسؤول عن الإجابة أو إجراء التغيير. تساعد مطابقة التشابه على اختيار السياق؛ لكنها لا تثبت أن تنفيذين قابلان للاستبدال. افحص المدخلات والآثار الجانبية والعقود المحيطة في الشيفرة المسترجعة قبل استخدامها لتوجيه تعديل.

افصل إصدارات المستودع غير المرتبطة عبر البيانات الوصفية، وحافظ على قابلية تتبع المراجعات المفهرسة. وإذا انتقلت دالة أو تغير سلوكها، فحدّث متجهها وموضعها المصدري معًا. وينبغي أن تصف إعدادات التضمين نفسها المصدر المفهرس واستعلاماته. وعند ترحيل فهرس، قارن النتائج بمجموعة الأسئلة القائمة حتى لا يغيّر نموذج أو تمثيل متجه جديد الشيفرة التي يراها المطور دون أن يتضح ذلك.

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

Ailoot Ultra · التضمينات POST /v1/embeddings voyage-code-3

voyage-code-3

Voyage AI /voyage-code-3

البداية

المدخلات المقبولة: النص
النتائج: embedding

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · التضمينات POST /v1/embeddings

الإدخال: text
الإخراج: embedding

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود voyage-code-3 الشروط: استخدم محدِّد نموذج 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 · التضمينات

curl · احفظ جميع المتجهات وبيانات الاستخدام

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "voyage-code-3",
  "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-3

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

voyage-code-3

FAQ · Voyage AI: Voyage Code 3

ما المدخلات والنتائج المتاحة؟: POST /v1/embeddings · voyage-code-3: text → embedding
ما الحقول التي يستخدمها الطلب؟: POST /v1/embeddings · voyage-code-3: model, input

Voyage AI: Voyage Code 3