„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 Assistant API beta v1 versijos. Šiuo metu palaikome tik v2. Peržiūrėkite šį migracijos vadovą, kad konvertuotumėte savo API iškvietimus iš v1 į v2

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 File Search įrankis?

`file_search` įrankis iškart įgyvendina kelias geriausias gavimo praktikas, kad padėtų iš failų išgauti tinkamus duomenis ir papildyti modelio atsakymus. Daugiau informacijos rasite mūsų kūrėjų dokumentacijoje.

Pagal numatytuosius nustatymus file_search įrankis naudoja šiuos nustatymus:

• Skilties dydis: 800 žetonų

• Skilčių persidengimas: 400 žetonų

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

• Didžiausias į kontekstą pridedamų skilčių 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 JSON režimas pasiekiamas Assistants API?

Taip, JSON režimas Assistants API pasiekiamas naudojant response_format parametrą 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 klaidą, pvz., „Apdorojant jūsų užklausą serveryje įvyko klaida. Atsiprašome! Galite pakartoti užklausą arba, jei klaida išlieka, susisiekti su mumis per Pagalbos centrą adresu help.openai.com. “ Ką turėčiau daryti?

Jei gaunate šią klaidą, tai gali reikšti, kad jūsų užklausa nustatyta netinkamai. Jei vis kartojate užklausą ir ji nepavyksta, pabandykite:

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

2. pridėti visas užklausos komandas kaip funkciją į tools

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.