VoyageAI by MongoDB: voyage-code-4

Voyage AI voyage-code-4 — сұрақтар, мәселе сипаттамалары және бағдарламалаушы агенттің мақсаттары бойынша тиісті бастапқы кодты табуға арналған код эмбеддинг моделі. 32 000 токендік кірісті, 256, 512, 1024 немесе 2048 өлшемді, жылжымалы нүктелі және квантталған көрсетілімдерді қолдайды.

Ailoot Ultra · Эмбеддингтер POST /v1/embeddings voyageai/voyage-code-4

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

voyage-code-4 — Voyage AI-дың репозиторийден іздеуге және бағдарламалаушы агенттерге материал табуға арналған, кодқа маманданған эмбеддинг моделі. Ол іздеу белгілі идентификатордан емес, сұрақтан, ақау белгісінен немесе тапсырма сипаттамасынан басталғанда тиісті бастапқы кодты табуға көмектесуге арналған. Код пен мәтіндік ақпаратты іздеуге арналған сандық векторлар түрінде көрсетеді; репозиторийді өңдемейді және түзету генерацияламайды.

Зерттеліп жатқан мәселе бойынша кодты табыңыз

Өндіруші аяқталған pull request материалдарынан іріктелген, табиғи тілдегі сұрауларды кодпен байланыстыратын оқыту корпусын сипаттайды. Бұл негізінен бастапқы файлдар мен олардың docstring мәтіндеріне құрылған оқыту мысалдарынан елеулі айырмашылық: іздеу тапсырмасы зерттеуді қажет ететін әрекеттен бастала алады.

Мысалы, «Бос нәтиже сәтті операцияның сәтсіз деп белгіленуіне әкелетін жерді тап» деген сұрау дайындаңыз. Оқуға ыңғайлы бастапқы код бөлімдерін файл жолдарымен және тиісті түсіндірмелермен бірге индекстеу керек. Функция әрекетін түсіндіретін айналасындағы шарттарды сақтаңыз. Қайтарылған кандидат оқырманды немесе агентті өзі көрсететін бастапқы код бөліміне апаруы тиіс.

Семантикалық іздеу нақты идентификатор бойынша және толық мәтіндік іздеуді толықтыра алады. Функция атауы белгілі болса, дәл іздеу әлі де пайдалы. Тек ақау белгісі белгілі болса, векторлық іздеу тексеруге және басқа сұраумен нақтылауға болатын кандидаттарды ұсына алады.

Сұрау және құжат рөлдері

Voyage іздеу нұсқаулығы сұрауды корпус құжатынан query/document кіріс түрлері арқылы ажыратады. Код іздеу үшін мәселе немесе тапсырма сипаттамасын сұрау, ал индекстелген бастапқы кодты не құжаттаманы құжат ретінде қолданыңыз. Жарияланған үлгі эмбеддинг жасау кезінде әр рөлге арналған іздеу нұсқауларын қосады.

Кодтың бастапқы пішімін, атауларын және тиісті құжаттамасын вектордан бөлек қолжетімді сақтаңыз. Бастапқы код бөлімі үшін файл жолы мен орналасуын, бағдарламалау нұсқаулығы үшін тақырыбын сақтаңыз. Іздеуден кейін өңдеуді таңдамас бұрын нақты кодты және оны шақыратын код бөліктерін тексеріңіз. Кандидаттың қатыстылығы оның хабарланған мәселенің жалғыз себебі екенін дәлелдемейді.

Контекст және көрсетілім таңдаулары

Осы нақты модельдің жарияланған контекст ұзындығы — 32 000 токен. Әдепкі эмбеддингте 1024 өлшем бар; Matryoshka оқытуы арқылы 256, 512 және 2048 өлшемдеріне де қолдау көрсетіледі. Хабарландыру 32 биттік жылжымалы нүктелі, таңбалы және таңбасыз 8 биттік бүтін санды, сондай-ақ бинарлық көрсетілімдерді құжаттайды.

Жинақ үшін бір өлшем мен көрсетілімді таңдап, оларды метадеректерімен бірге сақтаңыз. Жылжымалы нүктелі векторлар мен квантталған көрсетілімдер сақтау және салыстыру кезінде өздеріне сәйкес өңдеуді талап етеді. Бинарлық көрсетілім вектор ақпаратын кәдімгі жылжымалы нүктелі координаттар тізімінен өзгеше кодтайды; іздеуге нәтиже дайындағанда бұл айырмашылықты сақтаңыз.

Ұзын файл үшін бастапқы орналасуын қалпына келтіруге болатын мағыналық тұтас бөлімдерді таңдаңыз. Шартты түсіндіру үшін функцияға іргелес тип анықтамасы немесе түсіндірме қажет болуы мүмкін, ал тым үлкен файлдың ішінде қатысы жоқ материал болуы ықтимал. Максимал контексті қолайлы бөлік өлшемі деп қабылдамай, бөлімді ізделетін тапсырмаға сәйкестендіріңіз.

Табылған бастапқы кодты дәлел ретінде пайдаланыңыз

Бағдарламалаушы агенттің практикалық үдерісі бастапқы код кандидаттарын табады, сол файлдарды оқиды, тиісті сілтемелерді қадағалайды және зерттеу барысында іздеуді тарылтады. Табылған мәтін пайымдау немесе өңдеу кезеңіне контекст болады. Кандидат дұрыс бастапқы кодпен салыстырылып тексерілуі үшін оның индекстелген репозиторий ревизиясымен байланысын сақтаңыз.

voyage-code-4 нұсқасының ерекше үлесі — бағдарламалаушы агенттер қолданатын мәселе сипаттамасынан кодты табу кезеңіне бағытталуы және өлшемдер мен көрсетілімдердің икемділігі. Оның шығысы — іздеу векторы; диагностика, өңдеу және тексеру нақты репозиторийге сүйенетін бөлек тапсырмалар болып қалады.

Ailoot Ultra · Эмбеддингтер POST /v1/embeddings voyageai/voyage-code-4

voyageai/voyage-code-4

VoyageAI by MongoDB /voyageai/voyage-code-4

Бастау

Қабылданатын кіріс деректері: Мәтін · token_ids
Нәтижелер: embedding

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Эмбеддингтер POST /v1/embeddings

Кіріс: text, token_ids
Шығыс: embedding
Контекст: 32 000 tokens
Шығыс пішімі: json

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер voyageai/voyage-code-4	Әдепкі—
Өріс`input`	Түрі`string\|string[]\|integer[]\|integer[][]`	ТалапМіндетті	Мәндер мен шектеулер Элементтердің ең аз саны: 1 Шарттар: Бос емес, біртекті пакет. Токендердің ID мәндері — теріс емес бүтін сандар. Кіріс бюджеті: Ең көбі: 32 000 · Мәтін бірлігі: UTF8 байттары · Токен бірлігі: токендер массивінің элементтері	Әдепкі—
Өріс`encoding_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер float	Әдепкіfloat
Өріс`dimensions`	Түрі`integer`	ТалапҚолдау көрсетілмейді	Мәндер мен шектеулер Ең азы: 1	Әдепкі—
Өріс`user`	Түрі`json_value`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Дереккөз бұл JSON метадерек өрісіне рұқсат береді; бастапқы провайдердегі нақты мағынасы модельге байланысты.	Әдепкі—
Өріс`session_id`	Түрі`json_value`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Дереккөз бұл JSON метадерек өрісіне рұқсат береді; бастапқы провайдердегі нақты мағынасы модельге байланысты.	Әдепкі—
Өріс`trace`	Түрі`json_value`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Дереккөз бұл JSON метадерек өрісіне рұқсат береді; бастапқы провайдердегі нақты мағынасы модельге байланысты.	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: provider.options қабылданбайды	Әдепкі—

Кіріс материалдарының үйлесімдері

text_to_embedding

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, input
Параметр`input_shapes`	Параметр талаптарыstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[]
Параметр`encoding_format`	Параметр талаптарыfloat
Параметр`dimensions_override`	Параметр талаптарыfalse
Параметр`max_input_budget_units`	Параметр талаптары32000
Параметр`multimodal_objects`	Параметр талаптарыfalse
Параметр`material_types`	Параметр талаптарыtext, token_ids

Өмірлік цикл: synchronous_json

Әрбір вектордың индексін және өлшемін сақтаңыз.

Модель атауының мультимодаль болуы осы нақты жолда кескін объектілерін қабылдауға рұқсат бермейді.

Тарифтер

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Стандартты тариф Жылдам режим таңдалғанда
Икемді режим: Стандартты тариф flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Стандартты тариф Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Ailoot мөлшерлемелері

Баптаулар бойынша бағалар

Баптау	Мөлшерлемелер кестесі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Төлем Кіріс · Кіріс токендері $0.00024 / 1K токен Шығыс · Шығыс токендері $0 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Эмбеддингтер

curlPython SDK

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "voyageai/voyage-code-4", "input": ["First document", "Second document"]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT

from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='voyageai/voyage-code-4',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)

Нәтижелерді алу және сақтау

Ailoot Ultra · Эмбеддингтер

json

Барлық дайын нәтижені сақтау

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

Әрбір векторды индексімен бірге сақтаңыз. Векторлар саны кіріс элементтерінің санына тең болуы керек; өлшемдері бірдей болуы керек.

Бастапқы жауапты тексеру қажет болса

Эмбеддинг тапсырмасы үшін жаңа эндпоинт енгізілмейді.

Жауап өрістері

Өріс	Түрі
Өріс`object`	Түріstring
Өріс`model`	Түріstring
Өріс`data[].index`	Түріinteger
Өріс`data[].embedding`	Түріfinite float[]
Өріс`usage`	Түріobject

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате	Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra voyageai/voyage-code-4

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

voyageai/voyage-code-4

FAQ · VoyageAI by MongoDB: voyage-code-4

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/embeddings · voyageai/voyage-code-4: text, token_ids → embedding
Сұрау қандай өрістерді пайдаланады?: POST /v1/embeddings · voyageai/voyage-code-4: model, input, encoding_format, provider
Қандай шектеулер қолданылады?: POST /v1/embeddings · voyageai/voyage-code-4: ctx: 32000; input.budget.maximum: 32000 (UTF8 байттары); input.min_items: 1

VoyageAI by MongoDB: voyage-code-4