„Assistants API“ (v2) DUK

Kas yra Assistants API?

Assistants API leidžia kūrėjams lengvai kurti galingus AI asistentus savo programose. Šis API pašalina poreikį valdyti pokalbių istoriją ir suteikia prieigą prie OpenAI priglobtų įrankių, tokių kaip Kodo interpretatorius ir File Search. API taip pat palaiko patobulintą funkcijų kvietimą trečiųjų šalių įrankiams.

Ar vis dar galiu naudoti Assistants API v1 beta versiją?

Ne. Nuo 2024 m. gruodžio 18 d. naudotojai nebeturi prieigos prie Assistants API beta versijos v1. Šiuo metu palaikome tik v2. Norėdami pakeisti API iškvietimus iš v1 į v2, žr. šį perkėlimo vadovą.

Kaip galiu jį pasiekti?

Assistants API pasiekiamas visiems, turintiems OpenAI API paskyrą, tačiau jis nebenaudojamas ir bus pašalintas 2026 m. rugpjūtį. Naujiems projektams vietoj jo naudokite Responses API. Jei jau naudojate Assistants API, suplanuokite migraciją į Responses API. Kol API tebėra pasiekiamas, esamus asistentus vis dar galite pasiekti Assistants Playground.

Kas yra asistentas?

Asistentas yra konkrečiam tikslui sukurtas AI, naudojantis OpenAI modelius, galintis pasiekti failus, išlaikyti nuolatines gijas ir kviesti įrankius.

Kas yra gija?

Gija yra pokalbio seansas tarp asistento ir naudotojo. Gijos supaprastina programų kūrimą saugodamos pranešimų istoriją ir ją sutrumpindamos, kai pokalbis tampa per ilgas modelio konteksto ilgiui.

Kas yra failų paieškos įrankis?

Įrankyje file_search iš karto įdiegtos kelios rekomenduojamos informacijos paieškos praktikos, padedančios iš failų išgauti reikiamus duomenis ir jais papildyti modelio atsakymus. Daugiau informacijos rasite mūsų kūrėjams skirtoje dokumentacijoje.

Pagal numatytuosius nustatymus įrankis file_search naudoja šiuos parametrus:

• Fragmento dydis: 800 tokenų

• Fragmentų persidengimas: 400 tokenų

• Įterpinių modelis: text-embedding-3-large, 256 matmenų

• Didžiausias į kontekstą įtraukiamų fragmentų skaičius: 20

Kokie yra failų įkėlimo apribojimai?

Failo įkėlimo apribojimai yra:

• 512 MB vienam failui

• 5 mln. žetonų vienam failui

• 10 tūkst. failų vienoje vektorių saugykloje

• 1 vektorių saugykla vienam asistentui

• 1 vektorių saugykla vienai gijai

Bendra kiekvieno organizacijos projekto saugyklos riba yra 100 GB.

Kokie yra File Search įrankio apribojimai?

Turime keletą žinomų apribojimų, kurių palaikymą planuojame pridėti artimiausiais mėnesiais:

1. Šiuo metu nėra būdo keisti skaidymo, įterpimo ar gavimo nustatymų.

2. Nepalaikome vaizdų analizavimo dokumentuose.

3. Nepalaikome gavimo iš struktūrizuotų failų formatų (pvz., .csv arba .jsonl failų). Žr. palaikomus failų tipus.

Kokie yra Assistants API užklausų dažnio ribojimai?

Assistants API užklausų dažnio ribojimai nėra susieti su naudojimo lygiu ir modeliu. Vietoj to taikomos numatytosios ribos pagal užklausos tipą, su keliomis išimtimis:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 užklausų per minutę

Kaip API apmokestinamas Kodo interpretatorius?

Kodo interpretatoriaus kaina yra 0,03 USD už seansą. Jei jūsų asistentas vienu metu iškviečia Kodo interpretatorių dviejose skirtingose gijose, tai sukurs du Kodo interpretatoriaus seansus (2 * 0,03 USD). Pagal numatytuosius nustatymus kiekvienas seansas aktyvus vieną valandą, todėl šį mokestį mokėtumėte tik vieną kartą, jei naudotojas iki vienos valandos toje pačioje gijoje toliau teiktų nurodymus Kodo interpretatoriui.

Kaip API apmokestinamas File Search?

File Search kainuoja 0,10 USD/GB vektorių saugyklos vietos per dieną (pirmasis GB saugyklos yra nemokamas). Vektorių saugyklos dydis pagrįstas galutiniu vektorių saugyklos dydžiu po to, kai jūsų failas išanalizuojamas, suskaidomas ir įterpiamas.

Visos vektorių saugyklos, sukurtos iki 2024 m. balandžio 17 d., bus nemokamos iki 2024 m. pabaigos, po to jos bus arba:

• Apmokestinamos pagal dabartinius tarifus (šiuo metu 0,10 USD/GB/dieną), jei jos buvo panaudotos bent kartą Run, sukurtame po 2024 m. balandžio 17 d.

• Ištrintos, jei jos nebuvo panaudotos nė viename Run nuo 2024 m. balandžio 17 d. iki 2024 m. gruodžio 31 d. — taip siekiama išvengti apmokestinimo už vektorių saugyklas, kurias galbūt sukūrėte prieš paskelbiant šį kainodaros pakeitimą, bet niekada nenaudojote.

Ar yra riba, kiek asistentų galiu sukurti?

Nėra ribos, kiek asistentų gali sukurti organizacija.

Ar API pasiekiamas srautinis perdavimas?

Taip, srautinis perdavimas pasiekiamas Assistants API.

Ar Assistants API galima naudoti JSON režimą?

Taip, JSON režimą Assistants API galima naudoti nurodžius parametrą response_format Assistants arba Run objektuose.

Ar Assistants API taip pat valdys užklausas dėl trečiųjų šalių funkcijų iškvietimų?

Ne. Nors funkcijų kvietimas leidžia modeliui pasirinkti įrankius ir suformatuoti jiems skirtas užklausas, trečiųjų šalių įrankių iškvietimų vykdymo OpenAI nevaldo.

Kaip tvarkomi duomenys, kuriuos siunčiu OpenAI?

Kaip ir likusioje mūsų platformos dalyje, OpenAI API perduoti duomenys ir failai niekada nenaudojami mūsų modeliams mokyti, o savo duomenis galite ištrinti, kai tik reikia. Į Assistants API įkelti duomenys saugomi neribotą laiką, kol naudotojas juos ištrina rankiniu būdu.

Ar DALL-E pasiekiamas per Assistants API?

Šiuo metu DALL-E nepasiekiamas.

Ar Assistants API turi naudotojo sąsają?

Assistants API galite išbandyti Playground. Įsitikinkite, kad kairėje šoninėje juostoje esate Assistants rodinyje ir naudojate modelį, suderinamą su įrankiais, kuriuos norite įjungti.

Koks yra Assistants API asistento instrukcijų simbolių limitas?

Asistento instrukcijų lauko maksimalus ilgis yra 256 000 simbolių.

Gaunu tokį klaidos pranešimą: „Apdorojant jūsų užklausą įvyko serverio klaida. Atsiprašome! Galite pakartoti užklausą, o jei klaida kartojasi, susisiekite su mumis per pagalbos centrą adresu help.openai.com. “ Ką turėčiau daryti?

Ši klaida gali reikšti, kad jūsų užklausa sukonfigūruota netinkamai. Jei pakartotinai siunčiama užklausa vis tiek nepavyksta, išbandykite šiuos sprendimus:

1. pertvarkykite užklausą taip, kad visos į funkcijas panašios komandos būtų traktuojamos kaip funkcijos

2. visas užklausoje esančias komandas įtraukite į tools kaip funkcijas

Kodėl mano File Search įrankis neveikia gerai?

Naudojant File Search įrankį, rekomenduojame nustatyti max_prompt_tokens ne mažiau kaip 20 000. Ilgesniems pokalbiams arba kelioms sąveikoms su File Search apsvarstykite galimybę padidinti šią ribą iki 50 000 arba, geriausia, visiškai pašalinti max_prompt_tokens ribas, kad gautumėte aukščiausios kokybės rezultatus. Skaitykite daugiau čia.

Kaip galiu pateikti atsiliepimų?

Norėtume išgirsti jūsų atsiliepimus mūsų kūrėjų forume, per Pagalbos centrą adresu help.openai.com arba Twitter platformoje @OpenAIDevs.