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
- לא צוין כאשר נבחר מצב 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