Începând cu 11 martie 2025, am lansat componentele de bază ale noii noastre platforme Agents. Pentru detalii, consultă documentația noastră API pentru Responses API, instrumente precum Web Search, File Search și Computer Use, precum și Agents SDK cu Tracing. Pe baza feedbackului tău pentru Assistants API beta, am integrat îmbunătățiri cheie în Responses API. După ce vom atinge paritatea completă a funcționalităților, vom anunța un plan de perimare pentru Assistants API mai târziu în acest an, cu o dată țintă de retragere în prima jumătate a anului 2026.
Întrebări frecvente
Ce este API-ul Assistants?
API-ul Assistants le permite dezvoltatorilor să creeze cu ușurință asistenți AI puternici în aplicațiile lor. Acest API elimină necesitatea gestionării istoricului conversațiilor și oferă acces la instrumente găzduite de OpenAI, precum Interpretor de coduri și Căutare în fișiere. API-ul oferă și funcționalități îmbunătățite pentru apelarea funcțiilor în cazul instrumentelor terțe.
Mai pot folosi versiunea beta v1 a API-ului Assistants?
Nu. Începând cu 18 decembrie 2024, utilizatorii nu mai au acces la versiunea v1 beta a API-ului Assistant. În prezent, acceptăm doar v2. Consultați acest ghid de migrare pentru a vă converti apelurile API din v1 în v2.
Cum îl accesez?
Assistants API este disponibil pentru oricine are un cont OpenAI API, dar este perimat și va fi eliminat în august 2026. Pentru proiecte noi, folosește în schimb Responses API. Dacă folosești deja Assistants API, planifică migrarea la Responses API. Poți accesa în continuare asistenții existenți în Assistants Playground cât timp API-ul rămâne disponibil.
Ce este un asistent?
Un asistent este o inteligență artificială creată pentru un anumit scop, care folosește modelele OpenAI și poate accesa fișiere, păstra fire de conversație persistente și apela instrumente.
Ce este un fir de conversație?
Un fir de conversație este o sesiune de conversație între un asistent și un utilizator. Firele de conversație simplifică dezvoltarea aplicațiilor prin stocarea istoricului mesajelor și trunchierea acestuia atunci când conversația depășește lungimea contextului modelului.
Ce este instrumentul Căutare în fișiere?
Instrumentul file_search aplică implicit mai multe bune practici de regăsire a informațiilor, pentru a te ajuta să extragi datele potrivite din fișierele tale și să îmbunătățești răspunsurile modelului.
În mod implicit, instrumentul file_search folosește următoarele setări:
Dimensiunea fragmentelor: 800 de tokenuri
Suprapunerea fragmentelor: 400 de tokenuri
Model de reprezentare vectorială: text-embedding-3-large cu 256 de dimensiuni
Numărul maxim de fragmente adăugate în context: 20
Care sunt restricțiile pentru încărcarea fișierelor?
Restricțiile pentru încărcarea unui fișier sunt:
512 MB per fișier
5 milioane de tokenuri per fișier
10.000 de fișiere per depozit vectorial
1 depozit vectorial per asistent
1 depozit vectorial per fir de conversație
Limita totală de stocare pentru fiecare proiect dintr-o organizație este de 100 GB.
Care sunt limitările instrumentului Căutare în fișiere?
Există câteva limitări cunoscute pe care lucrăm să le eliminăm în lunile următoare:
În prezent, setările de fragmentare, reprezentare vectorială sau regăsire a informațiilor nu pot fi modificate.
Nu acceptăm analiza imaginilor din documente.
Nu acceptăm regăsirea informațiilor în formate de fișiere structurate (cum ar fi fișierele .csv sau .jsonl). Vezi tipurile de fișiere acceptate.
Care sunt limitele de frecvență pentru API-ul Assistants?
Limitele de frecvență pentru API-ul Assistants nu depind de nivelul de utilizare și de model. În schimb, există limite implicite în funcție de tipul cererii, cu câteva excepții:
GET: 1.000 de cereri pe minut
POST: 300 de cereri pe minut
DELETE: 300 de cereri pe minut
Cum se taxează utilizarea instrumentului Interpretor de coduri în API?
Tariful pentru Interpretor de coduri este de 0,03 USD pe sesiune. Dacă asistentul tău apelează simultan instrumentul Interpretor de coduri în două fire de conversație diferite, se creează două sesiuni de Interpretor de coduri (2 * 0,03 USD). Fiecare sesiune este activă implicit timp de o oră, ceea ce înseamnă că plătești această taxă o singură dată dacă utilizatorul tău continuă să dea instrucțiuni instrumentului Interpretor de coduri în același fir de conversație timp de cel mult o oră.
Cum se taxează utilizarea instrumentului Căutare în fișiere în API?
Tariful pentru Căutare în fișiere este de 0,10 USD/GB pe zi pentru stocarea în depozitul vectorial (primul GB de stocare este gratuit). Dimensiunea depozitului vectorial se calculează după ce fișierul tău este analizat, împărțit în fragmente și convertit în reprezentări vectoriale.
Toate depozitele vectoriale create înainte de 17 aprilie 2024 vor fi gratuite până la sfârșitul anului 2024, după care vor fi:
Taxate la tarifele în vigoare (în prezent, 0,10 USD/GB/zi), dacă au fost folosite cel puțin o dată într-o execuție Run creată după 17 aprilie 2024.
Șterse dacă nu au fost folosite în nicio execuție Run între 17 aprilie 2024 și 31 decembrie 2024, pentru a evita taxarea depozitelor vectoriale pe care le-ai creat înainte de anunțarea acestei modificări de tarif, dar pe care nu le-ai folosit niciodată.
Există o limită pentru câți asistenți pot crea?
Nu există nicio limită pentru câți asistenți poate crea o organizație.
Este disponibilă transmiterea în flux prin API?
Da, transmiterea în flux este disponibilă prin API-ul Assistants.
Modul JSON este disponibil în API-ul Assistants?
Da, modul JSON este disponibil în API-ul Assistants prin parametrul response_format al obiectelor Assistants sau Run.
API-ul Assistants va gestiona și cererile de apelare a funcțiilor terțe?
Nu. Deși apelarea funcțiilor permite modelului să selecteze instrumente și să formateze cererile pentru acestea, executarea apelurilor către instrumente terțe nu este gestionată de OpenAI.
Cum sunt gestionate datele pe care le trimit către OpenAI?
Ca și în restul platformei noastre, datele și fișierele transmise către API-ul OpenAI nu sunt niciodată folosite pentru a antrena modelele noastre, iar tu îți poți șterge datele oricând dorești. Datele încărcate în API-ul Assistants sunt stocate pe termen nelimitat, până când un utilizator le șterge manual.
DALL-E este disponibil prin API-ul Assistants?
Momentan, DALL-E nu este disponibil.
Există o interfață UI pentru Assistants API?
Poți consulta Playground pentru Assistants API. Asigură-te că ești în vizualizarea Assistants din bara laterală stângă și că folosești un model compatibil cu instrumentele pe care dorești să le activezi.
Care este limita de caractere pentru instrucțiunile asistentului în API-ul Assistants?
Câmpul pentru instrucțiunile asistentului are o lungime maximă de 256.000 de caractere.
Primesc un mesaj de eroare de tipul „Serverul a întâmpinat o eroare la procesarea cererii tale. Ne pare rău! Poți reîncerca cererea sau ne poți contacta prin centrul nostru de asistență de la help.openai.com dacă eroarea persistă. ” Ce ar trebui să fac?
Dacă primești această eroare, este posibil ca solicitarea ta să nu fie configurată corect. Dacă reîncerci cererea și aceasta eșuează în continuare, iată câteva lucruri pe care le poți încerca:
restructurează solicitarea astfel încât orice comandă de tip funcție să fie tratată ca o funcție
adaugă fiecare comandă din solicitare ca funcție în tools
De ce instrumentul Căutare în fișiere nu funcționează bine?
Când folosești instrumentul Căutare în fișiere, îți recomandăm să setezi max_prompt_tokens la cel puțin 20.000. Pentru conversații mai lungi sau interacțiuni multiple cu instrumentul Căutare în fișiere, ia în considerare creșterea acestei limite la 50.000 sau, ideal, eliminarea completă a limitelor max_prompt_tokens, pentru a obține rezultate de cea mai bună calitate.
Cum pot oferi feedback?
Ne-ar face plăcere să primim feedbackul tău pe Forumul pentru dezvoltatori, prin Centrul de asistență de la help.openai.com sau pe Twitter, la @OpenAIDevs.