DUK

Kas yra „Assistants“ API?

„Assistants“ API leidžia kūrėjams lengvai kurti galingus DI asistentus savo programėlėse. Naudojant šią API nebereikia tvarkyti pokalbių istorijos, be to, suteikiama prieiga prie OpenAI infrastruktūroje veikiančių įrankių, tokių kaip Kodo interpretatorius ir failų paieška. 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 – tai konkrečiam tikslui sukurtas DI, kuris naudoja OpenAI modelius ir gali pasiekti failus, palaikyti išliekančias pokalbių gijas bei kviesti įrankius.

Kas yra gija?

Gija – tai asistento ir naudotojo pokalbio seansas. Gijos supaprastina programėlių kūrimą: jose saugoma žinučių istorija, kuri sutrumpinama, kai pokalbis tampa per ilgas modelio konteksto langui.

Kas yra failų paieškos įrankis?

Įrankyje file_search iš karto taikomi keli geriausios informacijos gavimo praktikos metodai, padedantys iš failų išgauti reikiamus duomenis ir jais papildyti modelio atsakymus.

Pagal numatytuosius nustatymus įrankis file_search naudoja šias reikšmes:

• Fragmento dydis: 800 žetonų

• Fragmentų persidengimas: 400 žetonų

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

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

Kokie apribojimai taikomi failų įkėlimui?

Įkeliant failus taikomi šie apribojimai:

• 512 MB vienam failui

• 5 mln. žetonų vienam failui

• 10 tūkst. failų vienai vektorių saugyklai

• 1 vektorių saugykla vienam asistentui

• 1 vektorių saugykla vienai gijai

Bendras kiekvieno organizacijos projekto saugyklos limitas yra 100 GB.

Kokie yra failų paieškos įrankio apribojimai?

Yra keletas žinomų apribojimų, kuriuos siekiame pašalinti per ateinančius mėnesius:

1. Šiuo metu negalima keisti skaidymo į fragmentus, įterpinių kūrimo ar informacijos gavimo nustatymų.

2. Dokumentuose esančių vaizdų analizė nepalaikoma.

3. Informacijos gavimas iš struktūrinių failų formatų (pvz., .csv ar .jsonl failų) nepalaikomas. Žr. palaikomus failų tipus.

Kokie užklausų dažnio limitai taikomi „Assistants“ API?

„Assistants“ API užklausų dažnio limitai nepriklauso nuo naudojimo pakopos ir modelio. Vietoj to taikomi numatytieji limitai pagal užklausos tipą, su keliomis išimtimis:

• GET: 1 000 užklausų per minutę

• POST: 300 užklausų per minutę

• DELETE: 300 užklausų per minutę

Kokia Kodo interpretatoriaus naudojimo per API kaina?

Kodo interpretatoriaus seansas kainuoja 0,03 USD. Jei jūsų asistentas vienu metu iškviečia Kodo interpretatorių dviejose skirtingose gijose, sukuriami du Kodo interpretatoriaus seansai (2 × 0,03 USD). Pagal numatytuosius nustatymus kiekvienas seansas aktyvus vieną valandą. Tai reiškia, kad šį mokestį mokėsite tik vieną kartą, jei jūsų naudotojas iki valandos teiks nurodymus Kodo interpretatoriui toje pačioje gijoje.

Kokia failų paieškos naudojimo per API kaina?

Failų paieška kainuoja 0,10 USD už kiekvieną vektorių saugyklos GB per dieną (pirmasis saugyklos GB nemokamas). Vektorių saugyklos dydis nustatomas pagal jos užimamą vietą po to, kai jūsų failas išanalizuojamas, suskaidomas į fragmentus ir paverčiamas įterpiniais.

Visos vektorių saugyklos, sukurtos iki 2024 m. balandžio 17 d., bus nemokamos iki 2024 m. pabaigos, o vėliau jos bus:

• Apmokestinamos pagal galiojančius tarifus (šiuo metu 0,10 USD už GB per dieną), jei jos buvo bent kartą panaudotos vykdymo seanse („Run“), sukurtame po 2024 m. balandžio 17 d.

• Ištrintos, jei nuo 2024 m. balandžio 17 d. iki 2024 m. gruodžio 31 d. nebuvo panaudotos nė viename vykdymo seanse („Run“). Taip siekiame, kad jums nereikėtų mokėti už vektorių saugyklas, kurias galėjote sukurti prieš paskelbiant šį kainodaros pakeitimą, bet niekada nenaudojote.

Ar yra riba, kiek asistentų galiu sukurti?

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

Ar API palaiko srautinį perdavimą?

Taip, „Assistants“ API palaiko srautinį perdavimą.

Ar „Assistants“ API palaiko JSON režimą?

Taip, „Assistants“ API palaiko JSON režimą, kurį galima įjungti naudojant „Assistants“ arba „Run“ objektų parametrą response_format.

Ar „Assistants“ API taip pat tvarkys trečiųjų šalių funkcijų kvietimo užklausas?

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

Kaip tvarkomi mano OpenAI siunčiami duomenys?

Kaip ir visoje mūsų platformoje, OpenAI API perduoti duomenys ir failai niekada nenaudojami mūsų modeliams mokyti, o savo duomenis galite ištrinti bet kada. Į „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 asistento nurodymų simbolių limitas „Assistants“ API?

Didžiausias asistento nurodymų lauko ilgis yra 256 000 simbolių.

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

Jei gaunate šį klaidos pranešimą, gali būti, kad jūsų užklausa suformuluota netinkamai. Jei kartojant užklausą vis nepavyksta jos įvykdyti, išbandykite šiuos veiksmus:

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

2. pridėkite visas užklausoje esančias komandas kaip funkcijas prie tools

Kodėl mano failų paieškos įrankis veikia netinkamai?

Naudojant failų paieškos įrankį, rekomenduojame nustatyti ne mažesnę kaip 20 000 parametro max_prompt_tokens reikšmę. Jei pokalbiai ilgesni arba failų paieška naudojama kelis kartus, apsvarstykite galimybę padidinti šį limitą iki 50 000. Siekiant geriausių rezultatų, geriausia visiškai pašalinti max_prompt_tokens apribojimus.

Kaip galiu pateikti atsiliepimą?

Laukiame jūsų atsiliepimų mūsų kūrėjų forume, Pagalbos centre adresu help.openai.com arba „Twitter“ paskyroje @OpenAIDevs.