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.
KKK
Mis on Assistants API?
Assistants API võimaldab arendajatel hõlpsalt luua oma rakendustesse võimekaid tehisintellektiassistente. See API vabastab arendaja vestlusajaloo haldamisest ja annab juurdepääsu OpenAI majutatud tööriistadele, nagu Koodi tõlgendaja ja failiotsing. API toetab ka täiustatud funktsiooni kutsumist kolmandate osapoolte tööriistade kasutamiseks.
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 assistent?
Assistent on kindlaks otstarbeks loodud tehisintellekt, mis kasutab OpenAI mudeleid ning saab failidele juurde pääseda, püsivaid vestluslõimi säilitada ja tööriistu välja kutsuda.
Mis on vestluslõim?
Vestluslõim on assistendi ja kasutaja vaheline vestlusseanss. Vestluslõimed lihtsustavad rakenduste arendamist: need salvestavad sõnumiajaloo ja kärbivad seda, kui vestlus ületab mudeli kontekstipikkuse.
Mis on failiotsingu tööriist?
Tööriist file_search rakendab vaikimisi mitut infootsingu head tava, et leida sinu failidest õiged andmed mudeli vastuste täiendamiseks.
Vaikimisi kasutab tööriist file_search järgmisi seadeid:
Tüki suurus: 800 tokenit
Tükkide kattuvus: 400 tokenit
Vektorkujule teisendamise mudel: text-embedding-3-large, 256 mõõdet
Konteksti lisatavate tükkide maksimaalne arv: 20
Millised piirangud kehtivad failide üleslaadimisele?
Failide üleslaadimisele kehtivad järgmised piirangud:
512 MB faili kohta
5 miljonit tokenit faili kohta
10 000 faili vektorhoidla kohta
1 vektorhoidla assistendi kohta
1 vektorhoidla vestluslõime kohta
Organisatsiooni iga projekti salvestusruumi kogulimiit on 100 GB.
Millised on failiotsingu tööriista piirangud?
Teada on mõned piirangud, mille kõrvaldamisega töötame lähikuudel:
Praegu ei saa muuta tükeldamise, vektorkujule teisendamise ega infootsingu seadeid.
Dokumentides olevate piltide parsimist ei toetata.
Struktureeritud failivormingutest (nt .csv- või .jsonl-failidest) info otsimist ei toetata. Vaata toetatud failitüüpe.
Millised päringusageduse piirangud kehtivad Assistants API-le?
Assistants API päringusageduse piirangud ei sõltu kasutustasemest ega mudelist. Selle asemel kehtivad päringutüübipõhised vaikepiirangud, millel on paar erandit:
GET: 1000 päringut minutis
POST: 300 päringut minutis
DELETE: 300 päringut minutis
Kui palju maksab Koodi tõlgendaja kasutamine API kaudu?
Koodi tõlgendaja maksab 0,03 USA dollarit seansi kohta. Kui sinu assistent kutsub Koodi tõlgendaja korraga välja kahes erinevas vestluslõimes, luuakse kaks Koodi tõlgendaja seanssi (2 × 0,03 USA dollarit). Iga seanss on vaikimisi aktiivne ühe tunni. See tähendab, et maksad seda tasu vaid korra, kui sinu kasutaja annab Koodi tõlgendajale samas vestluslõimes juhiseid kuni ühe tunni jooksul.
Kui palju maksab failiotsingu kasutamine API kaudu?
Failiotsing maksab 0,10 USA dollarit vektorhoidla salvestusruumi gigabaidi kohta päevas (esimene GB on tasuta). Vektorhoidla maht arvestatakse pärast faili parsimist, tükeldamist ja vektorkujule teisendamist saadud mahu järgi.
Kõik enne 17. aprilli 2024 loodud vektorhoidlad on 2024. aasta lõpuni tasuta. Seejärel need kas:
Muutuvad tasuliseks kehtiva hinnakirja järgi (praegu 0,10 USA dollarit GB kohta päevas), kui neid on kasutatud vähemalt ühes pärast 17. aprilli 2024 loodud käivituses (Run).
Kustutatakse, kui neid pole 17. aprillist kuni 31. detsembrini 2024 kasutatud üheski käivituses (Run). Nii väldime tasu võtmist vektorhoidlate eest, mille võisid luua enne hinnamuudatuse väljakuulutamist, kuid mida sa pole kunagi kasutanud.
Kas loodavate assistentide arvule on piirang?
Organisatsioonis loodavate assistentide arvule piirangut ei ole.
Kas API toetab voogedastust?
Jah, Assistants API toetab voogedastust.
Kas Assistants API toetab JSON-režiimi?
Jah, Assistants API-s saab JSON-režiimi kasutada objektide Assistants või Run parameetri response_format kaudu.
Kas Assistants API haldab ka kolmandate osapoolte funktsioonide kutsumise päringuid?
Ei. Kuigi funktsiooni kutsumine võimaldab mudelil valida tööriistu ja vormistada neile päringuid, ei halda OpenAI kolmandate osapoolte tööriistade kutsete täitmist.
Kuidas käsitletakse andmeid, mille saadan OpenAI-le?
Nagu mujalgi meie platvormil, ei kasutata OpenAI API-le edastatud andmeid ega faile kunagi meie mudelite treenimiseks ning saad oma andmed igal ajal kustutada. Assistants API-sse üles laaditud andmeid säilitatakse tähtajatult, 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.

Kui pikk võib olla assistendi juhiste tekst Assistants API-s?
Assistendi juhiste välja maksimaalne pikkus on 256 000 märki.
Saan näiteks järgmise veateate: „Serveris tekkis sinu päringu töötlemisel viga. Vabandame! Võid päringu uuesti saata või vea püsimisel võtta meiega ühendust abikeskuse kaudu aadressil help.openai.com. “ Mida peaksin tegema?
See viga võib tähendada, et sinu viip pole õigesti koostatud. Kui päring ebaõnnestub ka korduval proovimisel, proovi järgmist:
muuda viiba ülesehitust nii, et funktsioonilaadseid käske käsitletaks funktsioonidena
lisa kõik viibas olevad käsud funktsioonidena parameetrisse tools
Miks minu failiotsingu tööriist hästi ei tööta?
Failiotsingu tööriista kasutamisel soovitame määrata parameetri max_prompt_tokens väärtuseks vähemalt 20 000. Pikemate vestluste või failiotsingu korduva kasutamise korral kaalu selle limiidi suurendamist 50 000-ni. Parima kvaliteediga tulemuste saamiseks on soovitatav max_prompt_tokens piirang üldse eemaldada.
Kuidas saan tagasisidet anda?
Ootame sinu tagasisidet meie arendajate foorumis, Abikeskuse kaudu aadressil help.openai.com või Twitteris kontol @OpenAIDevs.
