Që nga 11 marsi 2025, kemi publikuar blloqet ndërtuese të platformës sonë të re të Agjentëve. Për detaje, shihni dokumentet tona API për Responses API, Tools duke përfshirë Web Search, File Search dhe Computer Use, si dhe Agents SDK tonë me Tracing. Bazuar në feedback-un tuaj për Assistants API beta, kemi përfshirë përmirësime kyçe në Responses API. Pasi të arrijmë barazi të plotë të veçorive, do të shpallim një plan për vjetërimin e Assistants API më vonë këtë vit, me datë të synuar ndërprerjeje në gjysmën e parë të 2026.
Pyetje të shpeshta
Çfarë është API-ja Assistants?
API-ja Assistants u mundëson zhvilluesve të krijojnë lehtësisht asistentë të fuqishëm me inteligjencë artificiale brenda aplikacioneve të tyre. Kjo API heq nevojën për të menaxhuar historikun e bisedave dhe ofron qasje në mjete të hostuara nga OpenAI, si Code Interpreter dhe Kërkimi në skedarë. API-ja mbështet gjithashtu thirrje funksioni të përmirësuara për mjete të palëve të treta.
A mund ta përdor ende versionin beta v1 të API-së Assistants?
Jo. Që prej 18 dhjetorit 2024, përdoruesit nuk kanë më qasje në versionin v1 të API-së beta Assistant. Aktualisht mbështesim vetëm v2. Shihni këtë udhëzues migrimi për t’i kaluar thirrjet tuaja të API-së nga v1 në v2.
Si mund të kem qasje në të?
Assistants API është i disponueshëm për këdo me një llogari OpenAI API, por është i vjetëruar dhe do të hiqet në gusht 2026. Për projekte të reja, përdorni në vend të tij Responses API. Nëse tashmë përdorni Assistants API, planifikoni migrimin tuaj te Responses API. Mund të hyni ende te asistentët ekzistues në Assistants Playground ndërsa API-ja mbetet e disponueshme.
Çfarë është një asistent?
Një asistent është një inteligjencë artificiale e krijuar për një qëllim të caktuar, që përdor modelet e OpenAI dhe mund të ketë qasje në skedarë, të mbajë rrjedha të qëndrueshme bisede dhe të thërrasë mjete.
Çfarë është një rrjedhë bisede?
Një rrjedhë bisede është një seancë bisede mes një asistenti dhe një përdoruesi. Rrjedhat e bisedës e thjeshtojnë zhvillimin e aplikacioneve duke ruajtur historikun e mesazheve dhe duke e shkurtuar atë kur biseda tejkalon gjatësinë e kontekstit të modelit.
Çfarë është mjeti Kërkimi në skedarë?
Mjeti file_search zbaton që në fillim disa nga praktikat më të mira të marrjes së informacionit, për t'ju ndihmuar të nxirrni të dhënat e duhura nga skedarët tuaj dhe të pasuroni përgjigjet e modelit.
Si parazgjedhje, mjeti file_search përdor cilësimet e mëposhtme:
Madhësia e pjesës: 800 tokenë
Mbivendosja e pjesëve: 400 tokenë
Modeli i përfaqësimit vektorial: text-embedding-3-large me 256 dimensione
Numri maksimal i pjesëve të shtuara në kontekst: 20
Çfarë kufizimesh ka për ngarkimin e skedarëve?
Kufizimet për ngarkimin e skedarëve janë:
512 MB për skedar
5 milionë tokenë për skedar
10 mijë skedarë për depo vektorësh
1 depo vektorësh për asistent
1 depo vektorësh për rrjedhë bisede
Kufiri i përgjithshëm i hapësirës së ruajtjes për çdo projekt në një organizatë është 100 GB.
Çfarë kufizimesh ka mjeti Kërkimi në skedarë?
Ka disa kufizime të njohura që po punojmë t'i adresojmë në muajt në vijim:
Aktualisht nuk mund të ndryshohen cilësimet e ndarjes në pjesë, të përfaqësimit vektorial ose të marrjes së informacionit.
Nuk mbështetet analizimi i imazheve brenda dokumenteve.
Nuk mbështetet marrja e informacionit nga skedarë me formate të strukturuara (si skedarët .csv ose .jsonl). Shihni llojet e skedarëve që mbështeten.
Cilët janë kufijtë e shpeshtësisë së kërkesave për API-në Assistants?
Kufijtë e shpeshtësisë së kërkesave për API-në Assistants nuk varen nga niveli i përdorimit dhe modeli. Në vend të kësaj, ka kufij të parazgjedhur sipas llojit të kërkesës, me disa përjashtime:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 kërkesa në minutë
Sa kushton Code Interpreter në API?
Code Interpreter kushton 0,03 $ për seancë. Nëse asistenti juaj thërret Code Interpreter njëkohësisht në dy rrjedha bisede të ndryshme, krijohen dy seanca të Code Interpreter (2 * 0,03 $). Si parazgjedhje, çdo seancë qëndron aktive për një orë. Kjo do të thotë se e paguani këtë tarifë vetëm një herë nëse përdoruesi juaj vazhdon t'i japë udhëzime Code Interpreter në të njëjtën rrjedhë bisede për deri në një orë.
Sa kushton Kërkimi në skedarë në API?
Kërkimi në skedarë kushton 0,10 $/GB në ditë për hapësirën e ruajtjes në depon e vektorëve (GB-ja e parë është falas). Madhësia e depos së vektorëve përcaktohet pasi skedari juaj të jetë analizuar, ndarë në pjesë dhe kthyer në përfaqësime vektoriale.
Çdo depo vektorësh e krijuar para datës 17 prill 2024 do të jetë falas deri në fund të vitit 2024. Pas kësaj, këto depo:
Do të faturohen me tarifat në fuqi (aktualisht 0,10 $/GB/ditë) nëse janë përdorur të paktën një herë në një ekzekutim Run të krijuar pas datës 17 prill 2024.
Do të fshihen nëse nuk janë përdorur në asnjë ekzekutim Run mes datës 17 prill 2024 dhe datës 31 dhjetor 2024. Kjo bëhet që të mos faturoheni për depo vektorësh që mund t'i keni krijuar para se të njoftohej ky ndryshim çmimi, por që nuk i keni përdorur kurrë.
A ka kufi për numrin e asistentëve që mund të krijoj?
Nuk ka kufi për numrin e asistentëve që një organizatë mund të krijojë.
A është i disponueshëm transmetimi i vazhdueshëm në API?
Po, transmetimi i vazhdueshëm është i disponueshëm në API-në Assistants.
A është i disponueshëm modaliteti JSON në API-në Assistants?
Po, modaliteti JSON është i disponueshëm në API-në Assistants përmes parametrit response_format në objektet Assistants ose Run.
A do të menaxhojë API-ja Assistants edhe kërkesat për thirrje funksionesh të palëve të treta?
Jo. Megjithëse thirrja e funksionit i mundëson modelit të zgjedhë mjete dhe të formatojë kërkesa për to, OpenAI nuk menaxhon ekzekutimin e thirrjeve të mjeteve të palëve të treta.
Si trajtohen të dhënat që i dërgoj OpenAI?
Ashtu si në pjesën tjetër të platformës sonë, të dhënat dhe skedarët e dërguar në API-në e OpenAI nuk përdoren kurrë për të trajnuar modelet tona dhe mund t'i fshini të dhënat tuaja kurdo që të dëshironi. Të dhënat e ngarkuara në API-në Assistants ruhen pa afat derisa një përdorues t'i fshijë manualisht.
A mund të përdoret DALL-E përmes API-së Assistants?
Aktualisht, DALL-E nuk është i disponueshëm.
A ka një UI për Assistants API?
Mund të shikoni Playground për Assistants API. Sigurohuni që jeni në pamjen Assistants në shiritin anësor majtas dhe po përdorni një model të pajtueshëm me Tools që dëshironi të aktivizoni.
Cili është kufiri i karaktereve për udhëzimet e asistentit në API-në Assistants?
Fusha e udhëzimeve të asistentit ka një gjatësi maksimale prej 256 000 karakteresh.
Po marr një gabim të tillë si: “Në server ndodhi një gabim gjatë përpunimit të kërkesës suaj. Na vjen keq për këtë! Mund ta provoni sërish kërkesën ose të na kontaktoni përmes qendrës sonë të ndihmës në help.openai.com nëse gabimi vazhdon. ” Çfarë duhet të bëj?
Nëse po merrni këtë gabim, kjo mund të nënkuptojë se kërkesa juaj nuk është strukturuar siç duhet. Nëse e provoni vazhdimisht kërkesën dhe ajo dështon, mund të provoni këto hapa:
ristrukturojeni kërkesën tuaj që çdo komandë e ngjashme me një funksion të trajtohet si funksion
shtoni çdo komandë të kërkesës suaj si funksion te tools
Pse mjeti im Kërkimi në skedarë nuk po funksionon mirë?
Kur përdorni mjetin Kërkimi në skedarë, ju rekomandojmë ta vendosni max_prompt_tokens në një vlerë jo më të vogël se 20 000. Për biseda më të gjata ose ndërveprime të shumta me Kërkimin në skedarë, merrni parasysh rritjen e këtij kufiri në 50 000 ose, mundësisht, heqjen e plotë të kufijve të max_prompt_tokens për të marrë rezultate me cilësinë më të lartë.
Si mund të jap komente?
Mirëpresim komentet tuaja në Forumin tonë të zhvilluesve, përmes qendrës së ndihmës në help.openai.com ose në Twitter te @OpenAIDevs.