Časté otázky

Čo je Assistants API?

Assistants API umožňuje vývojárom jednoducho vytvárať výkonných AI asistentov vo svojich aplikáciách. Toto API odstraňuje potrebu spravovať históriu konverzácií a poskytuje prístup k nástrojom hostovaným spoločnosťou OpenAI, ako sú Code Interpreter a vyhľadávanie v súboroch. API podporuje aj vylepšené volanie funkcie pre nástroje tretích strán.

Môžem naďalej používať beta verziu v1 rozhrania Assistants API?

Nie. Od 18. decembra 2024 už používatelia nemajú prístup k beta verzii v1 rozhrania Assistants API. V súčasnosti podporujeme iba verziu v2. Informácie o zmene volaní API z verzie v1 na v2 nájdete v tejto príručke k migrácii.

Ako k nemu získam prístup?

Assistants API je dostupné každému s účtom OpenAI API, ale je zastarané a bude odstránené v auguste 2026. Pre nové projekty namiesto neho používajte Responses API. Ak už používate Assistants API, naplánujte si migráciu na Responses API. K existujúcim asistentom môžete naďalej pristupovať v Assistants Playground, kým bude API dostupné.

Čo je asistent?

Asistent je AI vytvorená na konkrétny účel, ktorá využíva modely OpenAI a môže pristupovať k súborom, uchovávať vlákna a volať nástroje.

Čo je vlákno?

Vlákno je konverzačná relácia medzi asistentom a používateľom. Vlákna zjednodušujú vývoj aplikácií tým, že ukladajú históriu správ a skracujú ju, keď konverzácia presiahne dĺžku kontextu modelu.

Čo je nástroj na vyhľadávanie v súboroch?

Nástroj file_search už v základnom nastavení využíva niekoľko osvedčených postupov vyhľadávania, ktoré pomáhajú získať zo súborov správne údaje na doplnenie odpovedí modelu.

Nástroj file_search predvolene používa tieto nastavenia:

• Veľkosť úseku: 800 tokenov

• Prekrytie úsekov: 400 tokenov

• Model na tvorbu vektorových reprezentácií: text-embedding-3-large s 256 rozmermi

• Maximálny počet úsekov pridaných do kontextu: 20

Aké obmedzenia platia pri nahrávaní súborov?

Pri nahrávaní súborov platia tieto obmedzenia:

• 512 MB na súbor

• 5 miliónov tokenov na súbor

• 10 000 súborov na vektorové úložisko

• 1 vektorové úložisko na asistenta

• 1 vektorové úložisko na vlákno

Celkový limit úložiska pre každý projekt v organizácii je 100 GB.

Aké obmedzenia má nástroj na vyhľadávanie v súboroch?

Vieme o niekoľkých obmedzeniach, na ktorých odstránení v nadchádzajúcich mesiacoch pracujeme:

1. Momentálne nie je možné meniť nastavenia delenia na úseky, vektorových reprezentácií ani vyhľadávania.

2. Nepodporujeme spracovanie obrázkov v dokumentoch.

3. Nepodporujeme vyhľadávanie v štruktúrovaných formátoch súborov (napríklad v súboroch .csv alebo .jsonl). Pozrite si podporované typy súborov.

Aké limity počtu požiadaviek platia pre Assistants API?

Limity počtu požiadaviek pre Assistants API nezávisia od úrovne používania ani modelu. Namiesto toho s niekoľkými výnimkami platia predvolené limity podľa typu požiadavky:

• GET: 1 000 požiadaviek za minútu

• POST: 300 požiadaviek za minútu

• DELETE: 300 požiadaviek za minútu

Koľko stojí používanie nástroja Code Interpreter cez API?

Code Interpreter stojí 0,03 USD za reláciu. Ak váš asistent zavolá Code Interpreter súčasne v dvoch rôznych vláknach, vytvoria sa dve relácie nástroja Code Interpreter (2 × 0,03 USD). Každá relácia je predvolene aktívna jednu hodinu. Ak teda používateľ počas tejto hodiny zadáva nástroju Code Interpreter pokyny v tom istom vlákne, tento poplatok zaplatíte iba raz.

Koľko stojí vyhľadávanie v súboroch cez API?

Vyhľadávanie v súboroch stojí 0,10 USD za GB vektorového úložiska na deň (prvý GB úložiska je bezplatný). Veľkosť vektorového úložiska sa určuje podľa jeho výslednej veľkosti po spracovaní súboru, rozdelení na úseky a vytvorení vektorových reprezentácií.

Všetky vektorové úložiská vytvorené pred 17. aprílom 2024 budú do konca roka 2024 bezplatné. Potom budú buď:

• Účtované podľa platných sadzieb (aktuálne 0,10 USD/GB/deň), ak boli použité aspoň raz v spustení (Run) vytvorenom po 17. apríli 2024.

• Odstránené, ak neboli použité v žiadnom spustení (Run) od 17. apríla 2024 do 31. decembra 2024. Nebudeme vám tak účtovať poplatky za vektorové úložiská, ktoré ste možno vytvorili pred oznámením tejto zmeny cien, ale nikdy ste ich nepoužili.

Existuje limit, koľko asistentov môžem vytvoriť?

Počet asistentov, ktoré môže organizácia vytvoriť, nie je obmedzený.

Je v API dostupné streamovanie?

Áno, v Assistants API je dostupné streamovanie.

Je v Assistants API dostupný režim JSON?

Áno, režim JSON je v Assistants API dostupný prostredníctvom parametra response_format v objektoch Assistants alebo Run.

Bude Assistants API spravovať aj požiadavky na volanie funkcií tretích strán?

Nie. Hoci volanie funkcie umožňuje modelu vyberať nástroje a formátovať požiadavky pre ne, vykonávanie volaní nástrojov tretích strán nespravuje OpenAI.

Ako sa nakladá s údajmi, ktoré posielam spoločnosti OpenAI?

Rovnako ako na zvyšku našej platformy sa údaje a súbory odoslané do OpenAI API nikdy nepoužívajú na trénovanie našich modelov a svoje údaje môžete kedykoľvek odstrániť. Údaje nahrané do Assistants API sa uchovávajú bez časového obmedzenia, kým ich používateľ manuálne neodstráni.

Je DALL-E dostupný cez Assistants API?

DALL-E momentálne nie je dostupný.

Existuje používateľské rozhranie pre Assistants API?

Pre Assistants API si môžete vyskúšať Playground. Uistite sa, že ste v zobrazení Assistants na ľavom bočnom paneli a používate model kompatibilný s nástrojmi, ktoré chcete zapnúť.

Aký je limit počtu znakov pre pokyny asistenta v Assistants API?

Pole s pokynmi asistenta môže mať najviac 256 000 znakov.

Zobrazuje sa mi chyba, napríklad „Pri spracovaní vašej požiadavky došlo na serveri k chybe. Ospravedlňujeme sa! Môžete požiadavku zopakovať alebo nás kontaktovať prostredníctvom nášho centra pomoci na help.openai.com, ak chyba pretrváva. “ Čo mám robiť?

Ak sa vám zobrazuje táto chyba, môže to znamenať, že váš príkaz nie je správne zostavený. Ak požiadavka zlyháva aj po opakovaných pokusoch, skúste toto:

1. upravte štruktúru príkazu tak, aby sa všetky pokyny pripomínajúce funkcie spracúvali ako funkcie

2. pridajte všetky pokyny z príkazu do tools ako funkcie

Prečo môj nástroj na vyhľadávanie v súboroch nefunguje dobre?

Pri používaní nástroja na vyhľadávanie v súboroch odporúčame nastaviť max_prompt_tokens aspoň na 20 000. Pri dlhších konverzáciách alebo opakovanom vyhľadávaní v súboroch zvážte zvýšenie tohto limitu na 50 000. Na dosiahnutie čo najkvalitnejších výsledkov je ideálne limity max_prompt_tokens úplne odstrániť.

Ako môžem poskytnúť spätnú väzbu?

Radi uvítame vašu spätnú väzbu na našom fóre pre vývojárov, prostredníctvom Centra pomoci na help.openai.com alebo na Twitteri @OpenAIDevs.