Pogosta vprašanja

Kaj je API Assistants?

API Assistants razvijalcem omogoča preprosto ustvarjanje zmogljivih pomočnikov z umetno inteligenco v njihovih aplikacijah. Ta API odpravlja potrebo po upravljanju zgodovine pogovorov in omogoča dostop do orodij, ki jih gosti OpenAI, kot sta Tolmač kod (Code Interpreter) in Iskanje po datotekah. API podpira tudi izboljšan priklic funkcij za orodja drugih ponudnikov.

Ali lahko še vedno uporabljam beta različico v1 API-ja Assistants?

Ne. Od 18. decembra 2024 uporabniki nimajo več dostopa do različice v1 beta API-ja Assistants. Trenutno podpiramo samo v2. Za pretvorbo klicev API-ja iz v1 v v2 si oglejte ta vodnik za prehod.

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 je umetna inteligenca, zasnovana za določen namen, ki uporablja modele družbe OpenAI ter lahko dostopa do datotek, ohranja trajne niti in kliče orodja.

Kaj je nit?

Nit je pogovorna seja med pomočnikom in uporabnikom. Niti poenostavljajo razvoj aplikacij, saj shranjujejo zgodovino sporočil in jo skrajšajo, ko pogovor preseže dolžino konteksta modela.

Kaj je orodje Iskanje po datotekah?

Orodje file_search že privzeto uporablja več najboljših praks za pridobivanje podatkov, da vam pomaga iz datotek pridobiti ustrezne podatke za dopolnitev odgovorov modela.

Orodje file_search privzeto uporablja naslednje nastavitve:

• Velikost odseka: 800 žetonov

• Prekrivanje odsekov: 400 žetonov

• Model za vektorske vložitve: text-embedding-3-large z 256 dimenzijami

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

Kakšne so omejitve pri nalaganju datotek?

Pri nalaganju datotek veljajo naslednje omejitve:

• 512 MB na datoteko

• 5 milijonov žetonov na datoteko

• 10.000 datotek na vektorsko shrambo

• 1 vektorska shramba na pomočnika

• 1 vektorska shramba na nit

Skupna omejitev prostora za shranjevanje za vsak projekt v organizaciji je 100 GB.

Kakšne so omejitve orodja Iskanje po datotekah?

Obstaja nekaj znanih omejitev, ki jih nameravamo odpraviti z dodajanjem podpore v prihodnjih mesecih:

1. Trenutno ni mogoče spreminjati nastavitev razdeljevanja na odseke, vektorskih vložitev ali pridobivanja podatkov.

2. Ne podpiramo razčlenjevanja slik v dokumentih.

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

Kakšne so omejitve pogostosti zahtev za API Assistants?

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

• GET: 1000 zahtev na minuto

• POST: 300 zahtev na minuto

• DELETE: 300 zahtev na minuto

Kako se obračunava uporaba orodja Tolmač kod (Code Interpreter) v API-ju?

Cena uporabe orodja Tolmač kod (Code Interpreter) je 0,03 USD na sejo. Če vaš pomočnik hkrati pokliče orodje Tolmač kod (Code Interpreter) v dveh različnih nitih, se ustvarita dve seji orodja Tolmač kod (Code Interpreter) (2 × 0,03 USD). Vsaka seja je privzeto aktivna eno uro. To pomeni, da ta znesek plačate le enkrat, če vaš uporabnik v isti niti največ eno uro daje navodila orodju Tolmač kod (Code Interpreter).

Kako se obračunava uporaba orodja Iskanje po datotekah v API-ju?

Cena uporabe orodja Iskanje po datotekah je 0,10 USD na GB prostora v vektorski shrambi na dan (prvi GB prostora je brezplačen). Velikost vektorske shrambe se določi po tem, ko je vaša datoteka razčlenjena, razdeljena na odseke in pretvorjena v vektorske vložitve.

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

• Obračunane po veljavnih cenah (trenutno 0,10 USD/GB/dan), če so bile vsaj enkrat uporabljene pri izvajanju (Run), ustvarjenem po 17. aprilu 2024.

• Izbrisane, če med 17. aprilom 2024 in 31. decembrom 2024 niso bile uporabljene pri nobenem izvajanju (Run). Tako vam ne bomo zaračunali vektorskih shramb, ki ste jih morda ustvarili pred objavo te spremembe cen, a jih nikoli niste uporabili.

Ali obstaja omejitev, koliko pomočnikov lahko ustvarim?

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

Ali je v API-ju na voljo pretočni prenos?

Da, pretočni prenos je na voljo v API-ju Assistants.

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

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

Ali bo API Assistants upravljal tudi zahteve za priklic funkcij drugih ponudnikov?

Ne. Priklic funkcij modelu sicer omogoča izbiro orodij in oblikovanje zahtev zanje, vendar OpenAI ne upravlja izvajanja klicev orodij drugih ponudnikov.

Kako se ravna s podatki, ki jih pošljem družbi OpenAI?

Tako kot drugod na naši platformi se podatki in datoteke, poslani v API OpenAI, nikoli ne uporabljajo za učenje naših modelov, svoje podatke pa lahko kadar koli izbrišete. Podatki, naloženi v API Assistants, se hranijo brez časovne omejitve, dokler jih uporabnik ročno ne izbriše.

Ali je DALL-E na voljo prek API-ja Assistants?

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.

Kolikšna je omejitev števila znakov za navodila pomočnika v API-ju Assistants?

Polje z navodili pomočnika lahko vsebuje največ 256.000 znakov.

Prikaže se mi napaka, kot je »Med obdelavo vaše zahteve je na strežniku prišlo do napake. Opravičujemo se za nevšečnosti! Zahtevo lahko poskusite poslati znova. Če se napaka ponavlja, se obrnite na nas prek centra za pomoč na help.openai.com. « Kaj naj storim?

Če se prikaže ta napaka, vaš poziv morda ni pravilno nastavljen. Če zahteva kljub ponovnim poskusom ne uspe, poskusite naslednje:

1. preoblikujte poziv tako, da se vsi ukazi, podobni funkcijam, obravnavajo kot funkcije

2. vse ukaze iz poziva dodajte kot funkcije v tools

Zakaj moje orodje Iskanje po datotekah ne deluje dobro?

Pri uporabi orodja Iskanje po datotekah priporočamo, da parameter max_prompt_tokens nastavite na najmanj 20.000. Za daljše pogovore ali več interakcij z orodjem Iskanje po datotekah razmislite o povečanju te omejitve na 50.000. Za najkakovostnejše rezultate pa je najbolje, da omejitve max_prompt_tokens povsem odstranite.

Kako lahko posredujem 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.