Од 11 март 2025, ги објавивме градивните блокови на нашата нова платформа Agents. За детали, видете ја нашата API документација за нашиот Responses API, алатките вклучувајќи Web Search, File Search и Computer Use, како и нашиот Agents SDK со Tracing. Врз основа на вашите повратни информации за Assistants API beta, вклучивме клучни подобрувања во Responses API. Откако ќе постигнеме целосна еднаквост на функциите, подоцна оваа година ќе објавиме план за застарување на Assistants API, со целен датум за гасење во првата половина на 2026.
Што е Assistants API?
Assistants API им овозможува на програмерите лесно да градат моќни AI асистенти во своите апликации. Овој API ја отстранува потребата за управување со историјата на разговори и додава пристап до алатки хостирани од OpenAI, како Толкувач на кодови и File Search. API исто така поддржува подобрено повикување на функција за алатки од трети страни.
Дали сè уште можам да ја користам бета-верзијата v1 на API за асистенти?
Не. Од 18 декември 2024 година, корисниците веќе немаат пристап до верзијата v1 на бета-верзијата на API за асистенти. Во моментов поддржуваме само v2. Погледнете го овој водич за миграција за да ги префрлите вашите API-повици од v1 на v2.
Како да пристапам до него?
Assistants API е достапен за секој со OpenAI API сметка, но е застарен и ќе биде отстранет во август 2026. За нови проекти, наместо тоа користете го Responses API. Ако веќе го користите Assistants API, испланирајте ја вашата миграција кон Responses API. Сè уште можете да пристапувате до постојните асистенти во Assistants Playground додека API останува достапен.
Што е асистент?
Асистент претставува наменски изграден AI што ги користи моделите на OpenAI и може да пристапува до датотеки, да одржува постојани нишки и да повикува алатки.
Што е нишка?
Нишка е сесија на разговор меѓу асистент и корисник. Нишките го поедноставуваат развојот на апликации со складирање на историјата на пораки и нејзино скратување кога разговорот станува предолг за должината на контекстот на моделот.
Што е алатката за пребарување датотеки?
Алатката file_search стандардно применува неколку најдобри практики за пронаоѓање информации, помагајќи ви да ги извлечете соодветните податоци од датотеките и да ги збогатите одговорите на моделот. За повеќе информации, прочитајте ја нашата документација за програмери.
Стандардно, алатката file_search ги користи следниве поставки:
Големина на делот: 800 токени
Преклопување на деловите: 400 токени
Модел за вградување: text-embedding-3-large со 256 димензии
Максимален број делови додадени во контекстот: 20
Кои се ограничувањата за прикачување датотеки?
Ограничувањата за прикачување датотека се:
512 MB по датотека
5M токени по датотека
10k датотеки по векторско складиште
1 векторско складиште по асистент
1 векторско складиште по нишка
Вкупното ограничување за складирање за секој проект во организација е 100 GB.
Кои се ограничувањата на алатката File Search?
Имаме неколку познати ограничувања за кои работиме да додадеме поддршка во наредните месеци:
Во моментов нема начин да се изменат поставките за делење на делови, вградување или пребарување.
Не поддржуваме парсирање на слики во документи.
Не поддржуваме пребарувања над структурирани формати на датотеки (како датотеки .csv или .jsonl). Погледнете ги поддржаните типови датотеки.
Кои се ограничувањата на брзината за Assistants API?
Ограничувањата на брзината за Assistants API не се поврзани со нивото на користење и моделот. Наместо тоа, постојат стандардни ограничувања според тип на барање, со неколку исклучоци:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 барања во минута
Како се наплаќа Толкувач на кодови во API?
Толкувач на кодови се наплаќа $0.03 / сесија. Ако вашиот асистент истовремено повика Толкувач на кодови во две различни нишки, тоа ќе создаде две сесии на Толкувач на кодови (2 * $0.03). Секоја сесија стандардно е активна еден час, што значи дека би ја платиле оваа надомест само еднаш ако вашиот корисник продолжи да му дава инструкции на Толкувач на кодови во истата нишка до еден час.
Како се наплаќа File Search во API?
File Search се наплаќа $0.10/GB складирање во векторско складиште дневно (првиот GB складирање е бесплатен). Големината на векторското складиште се базира на добиената големина на векторското складиште откако вашата датотека ќе биде парсирана, поделена на делови и вградена.
Сите векторски складишта создадени пред 17 април 2024 ќе бидат бесплатни до крајот на 2024, по што тие или ќе бидат:
Наплатени според тековните тарифи (моментално $0.10/GB/ден) ако биле употребени барем еднаш во Run создаден по 17 април 2024.
Избришани ако не биле употребени во ниту еден Run помеѓу 17 април 2024 и 31 декември 2024 — ова е за да се избегне да ви биде наплатено за векторски складишта што можеби сте ги создале пред да биде објавена оваа промена на цените, но никогаш не сте ги користеле.
Дали има ограничување за тоа колку асистенти можам да создадам?
Нема ограничување за тоа колку асистенти може да создаде една организација.
Дали стримингот е достапен во API?
Да, стримингот е достапен во Assistants API.
Дали режимот JSON е достапен во API за асистенти?
Да, режимот JSON е достапен во API за асистенти преку параметарот response_format на објектите Assistants или Run.
Дали Assistants API ќе управува и со барања за повици на функции од трети страни?
Не. Иако повикувањето на функција му овозможува на моделот да избира алатки и да форматира барања за нив, извршувањето повици кон алатки од трети страни не го управува OpenAI.
Како се постапува со податоците што ги испраќам до OpenAI?
Како и со остатокот од нашата платформа, податоците и датотеките испратени до OpenAI API никогаш не се користат за обучување на нашите модели и можете да ги избришете вашите податоци кога и да ви треба. Податоците прикачени во Assistants API се чуваат неограничено додека корисникот рачно не ги избрише.
Дали DALL-E е достапен преку Assistants API?
Во моментов, DALL-E не е достапен.
Дали има UI за Assistants API?
Можете да го погледнете Playground за Assistants API. Осигурете се дека сте во приказот Assistants на левата странична лента и дека користите модел компатибилен со алатките што сакате да ги вклучите.
Кое е ограничувањето на знаци за инструкциите на асистентот во Assistants API?
Полето за инструкции на асистентот има максимална должина од 256.000 знаци.
Добивам грешка како „Серверот наиде на грешка при обработката на вашето барање. Се извинуваме за тоа! Може повторно да го испратите барањето или, ако грешката продолжи да се појавува, да нè контактирате преку нашиот Центар за помош на help.openai.com. “ Што треба да направам?
Ако ја добивате оваа грешка, можеби вашиот промпт не е правилно поставен. Ако барањето не успева и покрај повторените обиди, пробајте го следново:
преструктурирајте го промптот така што сите наредби што личат на функции ќе се третираат како функции
додајте ги сите наредби од промптот како функции во tools
Зошто мојата алатка File Search не работи добро?
Кога ја користите алатката File Search, препорачуваме max_prompt_tokens да се постави на најмалку 20.000. За подолги разговори или повеќе интеракции со File Search, размислете да го зголемите ова ограничување на 50.000 или, идеално, целосно да ги отстраните ограничувањата за max_prompt_tokens за да добиете резултати со највисок квалитет. Прочитајте повеќе тука.
Како можам да дадам повратни информации?
Би сакале да ги слушнеме вашите повратни информации на нашиот Форум за програмери, преку Центарот за помош на help.openai.com или на Twitter @OpenAIDevs.