Често задавани въпроси

Какво представлява Assistants API?

Assistants API позволява на разработчиците лесно да създават мощни AI асистенти в своите приложения. Този API премахва необходимостта от управление на историята на разговорите и предоставя достъп до инструменти, хоствани от OpenAI, като Интерпретатор на кодове и „Търсене във файлове“. API поддържа и подобрено извикване на функция за инструменти на трети страни.

Мога ли все още да използвам бета версията v1 на Assistants API?

Не. От 18 декември 2024 г. потребителите вече нямат достъп до бета версията v1 на Assistant 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 щ.д. на сесия. Ако асистентът ви извика Интерпретатора на кодове едновременно в две различни нишки, това ще създаде две сесии на Интерпретатора на кодове (2 * 0,03 щ.д.). По подразбиране всяка сесия е активна за един час. Това означава, че ще платите тази такса само веднъж, ако потребителят ви продължи да дава инструкции на Интерпретатора на кодове в същата нишка в рамките на един час.

Как се таксува „Търсене във файлове“ в API?

Цената за „Търсене във файлове“ е 0,10 щ.д. на GB място във векторното хранилище на ден (първият GB е безплатен). Размерът на векторното хранилище се определя след анализа, разделянето на фрагменти и векторизирането на файла ви.

Всички векторни хранилища, създадени преди 17 април 2024 г., ще бъдат безплатни до края на 2024 г., след което ще бъдат:

• Таксувани по действащите тарифи (в момента 0,10 щ.д./GB/ден), ако са използвани поне веднъж в Run, създаден след 17 април 2024 г.

• Изтрити, ако не са използвани в нито един Run между 17 април 2024 г. и 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 не е достъпен.

Има ли потребителски интерфейс за Assistants API?

Можете да разгледате Playground за Assistants API. Уверете се, че сте в изгледа Assistants в лявата странична лента и използвате модел, съвместим с инструментите, които искате да включите.

Какъв е лимитът за броя знаци в инструкциите за асистента в 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.