Pogosta vprašanja o Assistants API (v2)

Kaj je Assistants API?

Assistants API razvijalcem omogoča, da v svojih aplikacijah preprosto zgradijo zmogljive pomočnike AI. Ta API odpravlja potrebo po upravljanju zgodovine pogovorov in dodaja dostop do orodij, ki jih gosti OpenAI, kot sta Tolmač kod (Code Interpreter) in File Search. API podpira tudi izboljšan priklic funkcij za orodja tretjih oseb.

Ali lahko še vedno uporabljam Assistants API v1 beta?

Ne. Od 18. decembra 2024 uporabniki nimajo več dostopa do različice v1 beta Assistant API. Trenutno podpiramo samo v2. Oglejte si ta vodnik za migracijo, da svoje klice API pretvorite iz v1 v v2

Kako dostopam do njega?

Assistants API je na voljo vsem z računom OpenAI API, vendar je zastarel in bo odstranjen avgusta 2026. Za nove projekte namesto njega uporabite Responses API. Če že uporabljate Assistants API, načrtujte migracijo na Responses API. Do obstoječih pomočnikov lahko še vedno dostopate v Assistants Playground, dokler je API na voljo.

Kaj je pomočnik?

Pomočnik predstavlja namensko zasnovano AI, ki uporablja modele OpenAI ter lahko dostopa do datotek, vzdržuje trajne niti in kliče orodja.

Kaj je nit?

Nit je pogovorna seja med pomočnikom in uporabnikom. Niti poenostavijo razvoj aplikacij tako, da shranjujejo zgodovino sporočil in jo skrajšajo, ko pogovor postane predolg za dolžino konteksta modela.

Kaj je orodje File Search?

Orodje `file_search` že privzeto izvaja več najboljših praks pridobivanja, da vam pomaga iz datotek izvleči prave podatke za dopolnitev odgovorov modela. Za več informacij preberite našo dokumentacijo za razvijalce.

Orodje file_search privzeto uporablja naslednje nastavitve:

• Velikost dela: 800 žetonov

• Prekrivanje delov: 400 žetonov

• Model vdelovanja: `text-embedding-3-large` pri 256 dimenzijah

• Največje število delov, dodanih v kontekst: 20

Kakšne so omejitve za nalaganje datotek?

Omejitve za nalaganje datoteke so:

• 512 MB na datoteko

• 5 mio. žetonov na datoteko

• 10.000 datotek na vektorsko shrambo

• 1 vektorska shramba na pomočnika

• 1 vektorska shramba na nit

Skupna omejitev shrambe za vsak projekt v organizaciji je 100 GB.

Katere so omejitve orodja File Search?

Imamo nekaj znanih omejitev, za katere si v prihodnjih mesecih prizadevamo dodati podporo:

1. Trenutno ni mogoče spreminjati nastavitev razdeljevanja na dele, vdelovanja ali pridobivanja.

2. Razčlenjevanja slik v dokumentih ne podpiramo.

3. Ne podpiramo pridobivanj iz strukturiranih oblik zapisa datotek (kot so datoteke .csv ali .jsonl). Oglejte si podprte vrste datotek.

Kakšne so omejitve hitrosti za Assistants API?

Omejitve hitrosti za Assistants API niso vezane na raven uporabe in model. Namesto tega veljajo privzete omejitve glede na vrsto zahteve, z nekaj izjemami:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 zahtev na minuto

Kako se v API-ju zaračunava Tolmač kod (Code Interpreter)?

Tolmač kod (Code Interpreter) stane 0,03 USD na sejo. Če vaš pomočnik hkrati pokliče Tolmača kod (Code Interpreter) v dveh različnih nitih, to ustvari dve seji Tolmača kod (Code Interpreter) (2 * 0,03 USD). Vsaka seja je privzeto aktivna eno uro, kar pomeni, da bi to pristojbino plačali samo enkrat, če uporabnik do ene ure še naprej daje navodila Tolmaču kod (Code Interpreter) v isti niti.

Kako se v API-ju zaračunava File Search?

File Search stane 0,10 USD/GB prostora v vektorski shrambi na dan (prvi GB prostora je brezplačen). Velikost vektorske shrambe temelji na končni velikosti vektorske shrambe, ko je vaša datoteka razčlenjena, razdeljena na dele in vdelana.

Vse vektorske shrambe, ustvarjene pred 17. aprilom 2024, bodo do konca leta 2024 brezplačne, nato pa bodo:

• Zaračunane po trenutnih cenah (trenutno 0,10 USD/GB/dan), če so bile vsaj enkrat uporabljene v Run, ustvarjenem po 17. aprilu 2024.

• Izbrisane, če niso bile uporabljene v nobenem Run med 17. aprilom 2024 in 31. decembrom 2024 — s tem preprečimo, da bi vam zaračunali vektorske shrambe, ki ste jih morda ustvarili pred objavo te spremembe cen, a jih niste nikoli uporabili.

Ali obstaja omejitev, koliko pomočnikov lahko ustvarim?

Ni omejitve glede števila pomočnikov, ki jih lahko ustvari organizacija.

Ali je pretakanje na voljo v API-ju?

Da, pretakanje je na voljo v Assistants API.

Ali je način JSON na voljo v Assistants API?

Da, način JSON je v Assistants API na voljo prek parametra response_format v objektih Assistants ali Run.

Ali bo Assistants API upravljal tudi zahteve za priklice funkcij tretjih oseb?

Ne. Čeprav priklic funkcij modelu omogoča, da izbere orodja in oblikuje zahteve zanje, OpenAI ne upravlja izvajanja klicev orodij tretjih oseb.

Kako se obravnavajo podatki, ki jih pošljem OpenAI?

Tako kot pri preostanku naše platforme se podatki in datoteke, posredovani v OpenAI API, nikoli ne uporabljajo za učenje naših modelov, svoje podatke pa lahko izbrišete, kadar koli to potrebujete. Podatki, naloženi v Assistants API, se hranijo za nedoločen čas, dokler jih uporabnik ročno ne izbriše.

Ali je DALL-E na voljo prek Assistants API?

DALL-E trenutno ni na voljo.

Ali obstaja uporabniški vmesnik za Assistants API?

Za Assistants API si lahko ogledate Playground. Prepričajte se, da ste v pogledu Assistants v levi stranski vrstici in uporabljate model, združljiv z orodji, ki jih želite omogočiti.

Kakšna je omejitev znakov za navodila pomočnika v Assistants API?

Polje z navodili pomočnika ima največjo dolžino 256.000 znakov.

Prikazuje se mi napaka, kot je »Strežnik je naletel na napako med obdelavo vaše zahteve. Oprostite za to! Zahtevo lahko poskusite znova ali se, če napaka ne izgine, obrnete na nas prek našega centra za pomoč na help.openai.com. « Kaj naj storim?

Če se vam prikazuje ta napaka, lahko pomeni, da vaš poziv ni pravilno nastavljen. Če zahtevo večkrat poskusite znova in še vedno ne uspe, poskusite naslednje:

1. poskrbite, da boste poziv preoblikovali tako, da bo vse ukaze, podobne funkcijam, obravnaval kot funkcije

2. dodajte vse ukaze v svojem pozivu kot funkcijo v tools

Zakaj moje orodje File Search ne deluje dobro?

Pri uporabi orodja File Search priporočamo, da max_prompt_tokens nastavite na najmanj 20.000. Za daljše pogovore ali več interakcij z orodjem File Search razmislite o povečanju te omejitve na 50.000 ali, v idealnem primeru, o popolni odstranitvi omejitev max_prompt_tokens za najkakovostnejše rezultate. Več preberite tukaj.

Kako lahko pošljem povratne informacije?

Veseli bomo vaših povratnih informacij na našem forumu za razvijalce, prek Centra za pomoč na help.openai.com ali na Twitterju @OpenAIDevs.