K 11. březnu 2025 jsme vydali základní stavební bloky naší nové platformy Agents. Podrobnosti najdete v naší dokumentaci API k Responses API, nástrojům včetně Web Search, File Search a Computer Use a k našemu Agents SDK s Tracing. Na základě vaší zpětné vazby k beta verzi Assistants API jsme do Responses API začlenili klíčová vylepšení. Jakmile dosáhneme úplné parity funkcí, oznámíme později v tomto roce plán ukončení podpory Assistants API s cílovým datem vypnutí v první polovině roku 2026.
Časté dotazy
Co je Assistants API?
Assistants API umožňuje vývojářům snadno vytvářet výkonné AI asistenty ve svých aplikacích. Toto API odstraňuje nutnost spravovat historii konverzací a poskytuje přístup k nástrojům hostovaným společností OpenAI, jako jsou interpret kódu a vyhledávání v souborech. API také podporuje vylepšené volání funkce pro nástroje třetích stran.
Mohu nadále používat beta verzi v1 rozhraní Assistants API?
Ne. Od 18. prosince 2024 již uživatelé nemají přístup k verzi v1 beta verze rozhraní Assistants API. V současnosti podporujeme pouze verzi v2. Přečtěte si tento průvodce migrací, který vám pomůže převést volání API z verze v1 na v2.
Jak k němu získám přístup?
Assistants API je dostupné každému s účtem OpenAI API, ale je zastaralé a v srpnu 2026 bude odstraněno. Pro nové projekty místo něj použijte Responses API. Pokud už Assistants API používáte, naplánujte migraci na Responses API. Ke stávajícím asistentům můžete stále přistupovat v Assistants Playground, dokud bude API dostupné.
Co je asistent?
Asistent je AI vytvořená pro konkrétní účel, která využívá modely OpenAI a může přistupovat k souborům, uchovávat vlákna a volat nástroje.
Co je vlákno?
Vlákno je konverzační relace mezi asistentem a uživatelem. Vlákna zjednodušují vývoj aplikací tím, že ukládají historii zpráv a zkracují ji, když konverzace přesáhne délku kontextu modelu.
Co je nástroj pro vyhledávání v souborech?
Nástroj file_search už v základním nastavení využívá několik osvědčených postupů pro vyhledávání, které pomáhají získat z vašich souborů relevantní data a doplnit jimi odpovědi modelu.
Nástroj file_search používá tato výchozí nastavení:
Velikost úseku: 800 tokenů
Překryv úseků: 400 tokenů
Model pro tvorbu embeddingů: text-embedding-3-large s 256 dimenzemi
Maximální počet úseků přidaných do kontextu: 20
Jaká omezení platí pro nahrávání souborů?
Pro nahrávání souborů platí tato omezení:
512 MB na soubor
5 milionů tokenů na soubor
10 tisíc souborů na vektorové úložiště
1 vektorové úložiště na asistenta
1 vektorové úložiště na vlákno
Celkový limit úložiště pro každý projekt v organizaci je 100 GB.
Jaká omezení má nástroj pro vyhledávání v souborech?
Existuje několik známých omezení, na jejichž odstranění v nadcházejících měsících pracujeme:
Momentálně nelze měnit nastavení dělení na úseky, tvorby embeddingů ani vyhledávání.
Nepodporujeme zpracování obrázků v dokumentech.
Nepodporujeme vyhledávání ve strukturovaných formátech souborů (například .csv nebo .jsonl). Viz podporované typy souborů.
Jaké jsou limity počtu požadavků pro Assistants API?
Limity počtu požadavků pro Assistants API nejsou vázány na úroveň využití a model. Místo toho platí výchozí limity podle typu požadavku, s několika výjimkami:
GET: 1 000 požadavků za minutu
POST: 300 požadavků za minutu
DELETE: 300 požadavků za minutu
Kolik stojí interpret kódu v API?
Interpret kódu stojí 0,03 USD za relaci. Pokud váš asistent zavolá interpret kódu současně ve dvou různých vláknech, vytvoří se dvě relace interpretu kódu (2 × 0,03 USD). Každá relace je ve výchozím nastavení aktivní jednu hodinu. Pokud tedy uživatel během této hodiny zadává interpretu kódu pokyny ve stejném vlákně, zaplatíte tento poplatek pouze jednou.
Kolik stojí vyhledávání v souborech v API?
Vyhledávání v souborech stojí 0,10 USD za GB vektorového úložiště denně (první GB úložiště je zdarma). Velikost vektorového úložiště se určuje podle jeho výsledné velikosti po zpracování souboru, rozdělení na úseky a vytvoření embeddingů.
Všechna vektorová úložiště vytvořená před 17. dubnem 2024 budou do konce roku 2024 zdarma. Poté budou buď:
Zpoplatněna podle aktuálních sazeb (nyní 0,10 USD/GB/den), pokud byla použita alespoň jednou v běhu (Run) vytvořeném po 17. dubnu 2024.
Smazána, pokud nebyla použita v žádném běhu (Run) mezi 17. dubnem 2024 a 31. prosincem 2024. Díky tomu nebudete platit za vektorová úložiště, která jste případně vytvořili před oznámením této změny cen, ale nikdy nepoužili.
Existuje limit, kolik asistentů mohu vytvořit?
Počet asistentů, které může organizace vytvořit, není omezen.
Je v API dostupné streamování?
Ano, streamování je v Assistants API dostupné.
Je v Assistants API dostupný režim JSON?
Ano, režim JSON je v Assistants API dostupný prostřednictvím parametru response_format u objektů Assistants nebo Run.
Bude Assistants API spravovat i požadavky na volání funkcí třetích stran?
Ne. Volání funkce sice umožňuje modelu vybírat nástroje a formátovat pro ně požadavky, ale samotné provádění volání nástrojů třetích stran OpenAI nespravuje.
Jak se nakládá s daty, která posílám do OpenAI?
Stejně jako ve zbytku naší platformy se data a soubory předané do API OpenAI nikdy nepoužívají k trénování našich modelů a svá data můžete kdykoli smazat. Data nahraná do Assistants API se uchovávají bez časového omezení, dokud je uživatel ručně nesmaže.
Je DALL-E dostupný přes Assistants API?
DALL-E momentálně není dostupný.
Existuje pro Assistants API uživatelské rozhraní?
Pro Assistants API si můžete vyzkoušet Playground. Ujistěte se, že jste v zobrazení Assistants na levém postranním panelu a používáte model kompatibilní s nástroji, které chcete zapnout.
Jaký je limit počtu znaků pro pokyny asistenta v Assistants API?
Pole pro pokyny asistenta má maximální délku 256 000 znaků.
Zobrazuje se mi chybová zpráva typu „Při zpracování vašeho požadavku došlo na serveru k chybě. Omlouváme se! Můžete požadavek zopakovat, nebo nás v případě přetrvávající chyby kontaktovat prostřednictvím našeho centra nápovědy na help.openai.com. “ Co mám dělat?
Pokud se vám tato chyba zobrazuje, může to znamenat, že váš prompt není správně nastavený. Pokud požadavek selhává i při opakovaných pokusech, vyzkoušejte následující:
upravte strukturu promptu tak, aby se s příkazy připomínajícími funkce zacházelo jako s funkcemi
přidejte všechny příkazy z promptu jako funkce do tools
Proč můj nástroj pro vyhledávání v souborech nefunguje dobře?
Při používání nástroje pro vyhledávání v souborech doporučujeme nastavit max_prompt_tokens alespoň na 20 000. U delších konverzací nebo při opakovaném vyhledávání v souborech zvažte zvýšení tohoto limitu na 50 000. Pro co nejkvalitnější výsledky je ideální limity max_prompt_tokens zcela odstranit.
Jak mohu poskytnout zpětnou vazbu?
Uvítáme vaši zpětnou vazbu na našem fóru pro vývojáře, prostřednictvím Centra nápovědy na help.openai.com nebo na Twitteru @OpenAIDevs.