Voyage AI: Voyage Code 3
Voyage Code 3 יוצר ייצוגים וקטוריים לאחזור מטקסט לקוד, מקוד לקוד וממחרוזת תיעוד לקוד. חלון של 32,000 טוקנים, ממדי וקטורים לבחירה ופלט שעבר קוונטיזציה תומכים בחיפוש במאגרי קוד ובבחירת הקשר קוד לעוזרי תכנות.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-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 Code 3 יוצר ייצוגים וקטוריים לאחזור מטקסט לקוד, מקוד לקוד וממחרוזת תיעוד לקוד. חלון של 32,000 טוקנים, ממדי וקטורים לבחירה ופלט שעבר קוונטיזציה תומכים בחיפוש במאגרי קוד ובבחירת הקשר קוד לעוזרי תכנות.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- 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
- לא צוין כאשר נבחר מצב 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-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
FAQ · Voyage AI: Voyage Code 3
- אילו קלטים ותוצאות זמינים?
POST /v1/embeddings·voyage-code-3:text→embedding- באילו שדות הבקשה משתמשת?
POST /v1/embeddings·voyage-code-3:model,input