OpenAI
Оваа страница беше машински преведена. Погледнете ја оригиналната статија на англиски јазик.

ЧПП за Assistants API (v2)

Прегледајте ги функциите, ограничувањата и цените на Assistants API v2, како и миграцијата кон Responses API.

Ажурирано: 5 days ago

Од 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 им овозможува на програмерите лесно да создаваат моќни асистенти со ВИ во своите апликации. Ова API ја отстранува потребата да управувате со историјата на разговорите и овозможува пристап до алатки хостирани од OpenAI, како Толкувач на кодови и Пребарување датотеки. 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 останува достапен.

Што е асистент?

Асистентот е вештачка интелигенција создадена за одредена намена, која ги користи моделите на OpenAI и може да пристапува до датотеки, да одржува трајни нишки и да повикува алатки.

Што е нишка?

Нишката е сесија на разговор меѓу асистент и корисник. Нишките го поедноставуваат развојот на апликации така што ја чуваат историјата на пораките и ја скратуваат кога разговорот ќе ја надмине должината на контекстот што го поддржува моделот.

Што е алатката Пребарување датотеки?

Алатката file_search стандардно применува неколку најдобри практики за пронаоѓање податоци, за да ви помогне да ги извлечете соодветните податоци од вашите датотеки и да ги збогатите одговорите на моделот.

Стандардно, алатката file_search ги користи следниве поставки:

  • Големина на дел: 800 токени

  • Преклопување на делови: 400 токени

  • Модел за векторско претставување: text-embedding-3-large со 256 димензии

  • Максимален број делови додадени во контекстот: 20

Кои се ограничувањата за прикачување датотеки?

Ограничувањата за прикачување датотеки се:

  • 512 MB по датотека

  • 5 милиони токени по датотека

  • 10.000 датотеки по векторско складиште

  • 1 векторско складиште по асистент

  • 1 векторско складиште по нишка

Вкупното ограничување на просторот за складирање за секој проект во една организација е 100 GB.

Кои се ограничувањата на алатката Пребарување датотеки?

Постојат неколку познати ограничувања и работиме на нивно надминување во наредните месеци:

  1. Во моментов не може да се менуваат поставките за делење на делови, векторско претставување или пронаоѓање податоци.

  2. Не поддржуваме анализа на слики во документи.

  3. Не поддржуваме пронаоѓање податоци во структурирани формати на датотеки (како датотеки .csv или .jsonl). Погледнете ги поддржаните типови датотеки.

Кои се ограничувањата на бројот на барања за Assistants API?

Ограничувањата на бројот на барања за Assistants API не зависат од нивото на користење и моделот. Наместо тоа, постојат стандардни ограничувања според типот на барањето, со неколку исклучоци:

  • GET: 1000 барања во минута

  • POST: 300 барања во минута

  • DELETE: 300 барања во минута

Колку чини користењето на Толкувач на кодови преку API?

Толкувач на кодови чини 0,03 USD по сесија. Ако вашиот асистент го повика Толкувач на кодови истовремено во две различни нишки, ќе се создадат две сесии на Толкувач на кодови (2 * 0,03 USD). Стандардно, секоја сесија е активна еден час. Тоа значи дека ќе го платите овој надоместок само еднаш ако вашиот корисник продолжи да му дава инструкции на Толкувач на кодови во истата нишка во текот на тој час.

Колку чини користењето на Пребарување датотеки преку API?

Пребарување датотеки чини 0,10 USD по GB простор во векторското складиште на ден (првиот GB простор е бесплатен). Големината на векторското складиште се пресметува по анализата на датотеката, нејзиното делење на делови и нивното претворање во векторски претставувања.

Сите векторски складишта создадени пред 17 април 2024 година ќе бидат бесплатни до крајот на 2024 година, по што ќе бидат:

  • Наплатувани според важечките тарифи (моментално 0,10 USD/GB/ден) ако биле користени барем еднаш во извршување (Run) создадено по 17 април 2024 година.

  • Избришани ако не биле користени во ниту едно извршување (Run) меѓу 17 април и 31 декември 2024 година — за да не ви се наплаќа за векторски складишта што можеби сте ги создале пред објавувањето на оваа промена на цените, но никогаш не сте ги користеле.

Дали има ограничување за тоа колку асистенти можам да создадам?

Нема ограничување за тоа колку асистенти може да создаде една организација.

Дали API поддржува стримување?

Да, Assistants API поддржува стримување.

Дали режимот JSON е достапен во Assistants API?

Да, режимот JSON е достапен во Assistants API преку параметарот response_format во објектите Assistants или Run.

Дали Assistants API ќе управува и со барањата за повикување функции од трети страни?

Не. Иако повикувањето на функција му овозможува на моделот да избира алатки и да форматира барања за нив, OpenAI не управува со извршувањето на повиците до алатки од трети страни.

Како се постапува со податоците што ги испраќам до OpenAI?

Како и на остатокот од нашата платформа, податоците и датотеките испратени до API на OpenAI никогаш не се користат за обучување на нашите модели, а можете да ги избришете вашите податоци кога и да ви е потребно. Податоците прикачени во Assistants API се чуваат на неодредено време, сѐ додека корисникот рачно не ги избрише.

Дали DALL-E е достапен преку Assistants API?

Во моментов, DALL-E не е достапен.

Дали има UI за Assistants API?

Можете да го погледнете Playground за Assistants API. Осигурете се дека сте во приказот Assistants на левата странична лента и дека користите модел компатибилен со алатките што сакате да ги вклучите.

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

Колку знаци се дозволени за инструкциите за асистентот во Assistants API?

Полето за инструкции за асистентот има максимална должина од 256.000 знаци.

Добивам порака за грешка како: „На серверот настана грешка при обработката на вашето барање. Се извинуваме за тоа! Можете повторно да го испратите барањето или да нѐ контактирате преку нашиот центар за помош на help.openai.com ако грешката продолжи да се појавува. “ Што да направам?

Ако ја добивате оваа грешка, можно е вашиот промпт да не е правилно поставен. Ако барањето не успева ни по повторни обиди, пробајте го следново:

  1. преструктурирајте го промптот така што сите команди слични на функции ќе се третираат како функции

  2. додајте ја секоја команда од промптот како функција во tools

Зошто мојата алатка Пребарување датотеки не работи добро?

Кога ја користите алатката Пребарување датотеки, препорачуваме да го поставите max_prompt_tokens на најмалку 20.000. За подолги разговори или повеќе интеракции со Пребарување датотеки, размислете да го зголемите ова ограничување на 50.000. За најквалитетни резултати, најдобро е целосно да ги отстраните ограничувањата за max_prompt_tokens.

Како можам да дадам повратни информации?

Со задоволство би ги слушнале вашите повратни информации на нашиот Форум за програмери, преку Центарот за помош на help.openai.com или на Twitter @OpenAIDevs.

Дали оваа статија ви беше корисна?