Alates 11. märtsist 2025 oleme välja andnud oma uue Agentsi platvormi ehitusplokid. Üksikasju leiate meie API dokumentatsioonist: Responses API, tööriistad, sealhulgas Web Search, File Search ja Computer Use, ning meie Agents SDK koos Tracinguga. Teie tagasiside põhjal Assistants API beetaversiooni kohta oleme lisanud Responses API-sse olulisi täiustusi. Pärast täieliku funktsioonide võrdsuse saavutamist kuulutame hiljem sel aastal välja Assistants API kasutuselt kõrvaldamise plaani, mille sihtlõpetamise kuupäev on 2026. aasta esimeses pooles.
Mis on Assistants API?
Assistants API võimaldab arendajatel hõlpsasti luua oma rakendustes võimsaid AI-assistente. See API eemaldab vajaduse hallata vestlusajalugu ja lisab juurdepääsu OpenAI hostitud tööriistadele, nagu Koodi tõlgendaja ja File Search. API toetab ka täiustatud funktsiooni kutsumist kolmandate osapoolte tööriistade jaoks.
Kas Assistants API v1 beetaversiooni saab endiselt kasutada?
Ei. Alates 18. detsembrist 2024 pole kasutajatel enam juurdepääsu Assistants API beetaversioonile v1. Praegu toetame ainult versiooni v2. API-kutsete versioonilt v1 versioonile v2 üleviimiseks lugege seda migreerimisjuhendit.
Kuidas sellele juurde pääsen?
Assistants API on saadaval kõigile, kellel on OpenAI API konto, kuid see on aegunud ja eemaldatakse 2026. aasta augustis. Uute projektide jaoks kasutage selle asemel Responses API-t. Kui kasutate juba Assistants API-t, planeerige migreerimine Responses API-le. Olemasolevatele assistentidele pääsete endiselt juurde Assistants Playgroundis, kuni API on saadaval.
Mis on Assistant?
Assistent on sihipäraselt loodud AI, mis kasutab OpenAI mudeleid ning saab kasutada faile, hoida püsivaid lõimi ja kutsuda tööriistu.
Mis on lõim?
Lõim on assistendi ja kasutaja vaheline vestlusseanss. Lõimed lihtsustavad rakenduste arendust, salvestades sõnumite ajaloo ja kärpides seda, kui vestlus muutub mudeli konteksti pikkuse jaoks liiga pikaks.
Mis on failiotsingu tööriist?
Tööriist file_search rakendab automaatselt mitut teabeotsingu head tava, et aidata teil failidest õigeid andmeid leida ja nendega mudeli vastuseid täiendada. Lisateavet leiate meie arendajadokumentatsioonist.
Tööriist file_search kasutab vaikimisi järgmisi seadeid:
Tekstilõigu suurus: 800 sõnet
Tekstilõikude ülekate: 400 sõnet
Manustusmudel: text-embedding-3-large, 256 mõõdet
Konteksti lisatavate tekstilõikude maksimaalne arv: 20
Millised on faili üleslaadimise piirangud?
Faili üleslaadimise piirangud on järgmised:
512 MB faili kohta
5 mln tokenit faili kohta
10 000 faili vektorhoidla kohta
1 vektorhoidla assistendi kohta
1 vektorhoidla lõime kohta
Organisatsiooni iga projekti üldine salvestusmahu piirang on 100 GB.
Millised on File Searchi tööriista piirangud?
Meil on mõned teadaolevad piirangud, mille toe lisamisega lähikuudel töötame:
Praegu ei ole võimalik muuta tükeldamise, manustamise ega otsingu seadeid.
Me ei toeta dokumentides olevate piltide parsimist.
Me ei toeta otsingut struktureeritud failivormingutest (näiteks .csv- või .jsonl-failidest). Vaadake toetatud failitüüpe.
Millised on Assistants API kiiruse piirangud?
Assistants API kiiruse piirangud ei ole seotud kasutustaseme ega mudeliga. Selle asemel kehtivad vaikimisi piirangud päringu tüübi järgi, mõne erandiga:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 päringut minutis
Kuidas on Koodi tõlgendaja API-s hinnastatud?
Koodi tõlgendaja hind on 0,03 $ seansi kohta. Kui teie assistent kutsub Koodi tõlgendajat korraga kahes erinevas lõimes, loob see kaks Koodi tõlgendaja seanssi (2 * 0,03 $). Iga seanss on vaikimisi aktiivne ühe tunni, mis tähendab, et maksate selle tasu ainult ühe korra, kui teie kasutaja jätkab Koodi tõlgendajale samas lõimes juhiste andmist kuni ühe tunni jooksul.
Kuidas on File Search API-s hinnastatud?
File Searchi hind on 0,10 $/GB vektorhoidla salvestusruumi kohta päevas (esimene GB salvestusruumi on tasuta). Vektorhoidla suurus põhineb vektorhoidla lõplikul suurusel pärast teie faili parsimist, tükeldamist ja manustamist.
Kõik enne 17. aprilli 2024 loodud vektorhoidlad on kuni 2024. aasta lõpuni tasuta, pärast mida need kas:
arveldatakse kehtivate hindade alusel (praegu 0,10 $/GB/päev), kui neid on vähemalt üks kord kasutatud Runis, mis loodi pärast 17. aprilli 2024.
kustutatakse, kui neid pole kasutatud üheski Runis ajavahemikus 17. aprill 2024 kuni 31. detsember 2024 — see aitab vältida arveldamist vektorhoidlate eest, mille võisite luua enne selle hinnamuudatuse väljakuulutamist, kuid mida te kunagi ei kasutanud.
Kas loodavate assistentide arvule on piirang?
Organisatsioonis loodavate assistentide arvule piirangut ei ole.
Kas API-s on voogedastus saadaval?
Jah, voogedastus on Assistants API-s saadaval.
Kas Assistants API-s saab kasutada JSON-režiimi?
Jah, JSON-režiimi saab Assistants API-s kasutada Assistants- või Run-objekti parameetri response_format kaudu.
Kas Assistants API haldab ka kolmandate osapoolte funktsioonikutsete päringuid?
Ei. Kuigi funktsiooni kutsumine võimaldab mudelil valida tööriistu ja vormindada neile päringuid, ei halda OpenAI kolmandate osapoolte tööriistade kutsete täitmist.
Kuidas käsitletakse andmeid, mida OpenAI-le saadan?
Nagu ka meie ülejäänud platvormil, ei kasutata OpenAI API-le edastatud andmeid ja faile kunagi meie mudelite treenimiseks ning saate oma andmed kustutada alati, kui seda vajate. Assistants API-sse üles laaditud andmeid säilitatakse määramata aja jooksul, kuni kasutaja need käsitsi kustutab.
Kas DALL-E on Assistants API kaudu saadaval?
Praegu ei ole DALL-E saadaval.
Kas Assistants API jaoks on olemas kasutajaliides?
Assistants API jaoks saate proovida Playgroundi. Veenduge, et olete vasakul külgribal vaates Assistants ja kasutate mudelit, mis ühildub tööriistadega, mille soovite sisse lülitada.
Milline on Assistants API-s assistendi juhiste tähemärgipiirang?
Assistendi juhiste välja maksimaalne pikkus on 256 000 tähemärki.
Saan näiteks veateate „Serveris ilmnes teie taotluse töötlemisel viga. Vabandame! Võite taotlust korrata või vea püsimisel võtta meiega ühendust abikeskuse help.openai.com kaudu. “ Mida peaksin tegema?
See viga võib tähendada, et teie viip pole õigesti seadistatud. Kui taotlus ebaõnnestub ka pärast korduvaid katseid, proovige järgmist.
struktureerige viip ümber nii, et kõiki funktsioonilaadseid käske käsitletaks funktsioonidena
lisage kõik viibus olevad käsud funktsioonidena parameetrisse tools
Miks minu File Searchi tööriist hästi ei tööta?
File Searchi tööriista kasutamisel soovitame seada max_prompt_tokens väärtuseks vähemalt 20 000. Pikemate vestluste või mitme File Searchiga suhtluse korral kaaluge selle piirangu suurendamist 50 000-ni või ideaaljuhul max_prompt_tokens piirangute täielikku eemaldamist, et saada parima kvaliteediga tulemused. Lugege lisaks siit.
Kuidas saan tagasisidet anda?
Ootame väga teie tagasisidet meie arendajate foorumis, Abikeskuse kaudu aadressil help.openai.com või Twitteris @OpenAIDevs.