Станом на 11 березня 2025 року ми випустили будівельні блоки нашої нової платформи Agents. Докладніше див. нашу документацію API для Responses API, інструментів, зокрема Web Search, File Search і Computer Use, а також нашого Agents SDK з Tracing. На основі ваших відгуків щодо бета-версії Assistants API ми внесли ключові покращення до 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 залишається доступним.
Що таке Assistant?
Асистент — це спеціально створений AI, який використовує моделі OpenAI, може отримувати доступ до файлів, підтримувати сталі потоки та викликати інструменти.
Що таке Thread?
Потік — це сеанс розмови між асистентом і користувачем. Потоки спрощують розробку застосунків, зберігаючи історію повідомлень і скорочуючи її, коли розмова стає надто довгою для довжини контексту моделі.
Що таке інструмент пошуку файлів?
Інструмент file_search за замовчуванням реалізує кілька передових методів пошуку, щоб допомогти отримати з файлів потрібні дані й доповнити ними відповіді моделі. Докладнішу інформацію наведено в нашій документації для розробників.
За замовчуванням інструмент file_search використовує такі налаштування:
Розмір фрагмента: 800 токенів
Перекриття фрагментів: 400 токенів
Модель вбудовування: text-embedding-3-large із розмірністю 256
Максимальна кількість фрагментів, доданих до контексту: 20
Які обмеження діють для завантаження файлів?
Обмеження для завантаження файлу:
512 МБ на файл
5 млн токенів на файл
10 тис. файлів на векторне сховище
1 векторне сховище на асистента
1 векторне сховище на потік
Загальний ліміт сховища для кожного проєкту в організації становить 100 ГБ.
Які обмеження має інструмент 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/ГБ сховища векторного сховища на день (перший ГБ сховища безкоштовний). Розмір векторного сховища визначається його підсумковим розміром після аналізу, поділу на фрагменти та вбудовування вашого файлу.
Усі векторні сховища, створені до 17 квітня 2024 року, будуть безкоштовними до кінця 2024 року, після чого їх буде або:
Стягнуто оплату за поточними тарифами (зараз $0.10/ГБ/день), якщо вони були використані принаймні один раз у Run, створеному після 17 квітня 2024 року.
Видалено, якщо вони не використовувалися в жодному Run між 17 квітня 2024 року та 31 грудня 2024 року — це потрібно, щоб уникнути нарахування плати за векторні сховища, які ви могли створити до оголошення цієї зміни цін, але ніколи не використовували.
Чи є обмеження на кількість асистентів, які я можу створити?
Немає обмеження на кількість асистентів, які може створити організація.
Чи доступна потокова передача в API?
Так, потокова передача доступна в Assistants API.
Чи доступний режим JSON в API асистентів?
Так, режим JSON доступний в API асистентів через параметр response_format в об’єктах Assistant або 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.