Gyakori kérdések

Mi az Assistants API?

Az Assistants API-val a fejlesztők egyszerűen készíthetnek nagy tudású AI-asszisztenseket az alkalmazásaikban. Ez az API átveszi a beszélgetési előzmények kezelését, és hozzáférést biztosít az OpenAI által üzemeltetett eszközökhöz, például a kódértelmezőhöz és a fájlkeresőhöz. Az API továbbfejlesztett funkcióhívást is támogat külső eszközökhöz.

Használhatom még az Assistants API v1 bétaverzióját?

Nem. A felhasználók 2024. december 18-tól már nem férnek hozzá az Assistants API béta v1 verziójához. Jelenleg csak a v2 verziót támogatjuk. Ebből az átállási útmutatóból megtudhatja, hogyan alakíthatja át API-hívásait v1-ről v2-re.

Hogyan férhetek hozzá?

Az Assistants API minden OpenAI API-fiókkal rendelkező felhasználó számára elérhető, de kivezetés alatt áll, és 2026 augusztusában eltávolítjuk. Új projektekhez helyette a Responses API-t használja. Ha már használja az Assistants API-t, tervezze meg az átállást a Responses API-ra. A meglévő asszisztensekhez továbbra is hozzáférhet az Assistants Playgroundban, amíg az API elérhető marad.

Mi az asszisztens?

Az asszisztens egy adott célra kialakított mesterséges intelligencia, amely az OpenAI modelljeit használja, és képes fájlokhoz hozzáférni, tartós beszélgetésszálakat fenntartani és eszközöket meghívni.

Mi a beszélgetésszál?

A beszélgetésszál egy asszisztens és egy felhasználó közötti beszélgetési munkamenet. A beszélgetésszálak leegyszerűsítik az alkalmazásfejlesztést: tárolják az üzenetelőzményeket, és lerövidítik őket, ha a beszélgetés meghaladja a modell kontextushosszát.

Mi a fájlkereső eszköz?

A file_search eszköz alapból számos bevált visszakeresési módszert alkalmaz, hogy segítsen kinyerni a megfelelő adatokat a fájljaidból a modell válaszainak kiegészítéséhez.

A file_search eszköz alapértelmezés szerint a következő beállításokat használja:

• Darabméret: 800 token

• Darabok közötti átfedés: 400 token

• Beágyazási modell: text-embedding-3-large, 256 dimenzióval

• A kontextushoz hozzáadott darabok maximális száma: 20

Milyen korlátozások vonatkoznak a fájlfeltöltésre?

A fájlfeltöltésre a következő korlátozások vonatkoznak:

• Fájlonként 512 MB

• Fájlonként 5 millió token

• Vektortáranként 10 000 fájl

• Asszisztensenként 1 vektortár

• Beszélgetésszálanként 1 vektortár

Egy szervezeten belül minden projekt teljes tárhelykorlátja 100 GB.

Milyen korlátai vannak a fájlkereső eszköznek?

Van néhány ismert korlátozás, amelyek feloldásán dolgozunk a következő hónapokban:

1. Jelenleg nem módosíthatók a darabolás, a beágyazás és a visszakeresés beállításai.

2. A dokumentumokban található képek feldolgozását nem támogatjuk.

3. A strukturált fájlformátumokban (például .csv vagy .jsonl fájlokban) való visszakeresést nem támogatjuk. Tekintsd meg a támogatott fájltípusokat.

Milyen kérésgyakorisági korlátok vonatkoznak az Assistants API-ra?

Az Assistants API kérésgyakorisági korlátai nem függnek a használati szinttől és a modelltől. Ehelyett kéréstípusonként vannak alapértelmezett korlátok, néhány kivétellel:

• GET: 1000 kérés/perc

• POST: 300 kérés/perc

• DELETE: 300 kérés/perc

Mennyibe kerül a kódértelmező használata az API-ban?

A kódértelmező díja munkamenetenként 0,03 USD. Ha az asszisztensed egyszerre két különböző beszélgetésszálban hívja meg a kódértelmezőt, az két kódértelmező-munkamenetet hoz létre (2 × 0,03 USD). Alapértelmezés szerint minden munkamenet egy órán át aktív. Ez azt jelenti, hogy csak egyszer kell megfizetned ezt a díjat, ha a felhasználód egy órán belül ugyanabban a beszélgetésszálban ad további utasításokat a kódértelmezőnek.

Mennyibe kerül a fájlkereső használata az API-ban?

A fájlkereső díja a vektortár tárhelye alapján napi 0,10 USD/GB (az első GB tárhely ingyenes). A vektortár méretét a fájl feldolgozása, darabolása és beágyazása után kapott méret alapján számítjuk ki.

A 2024. április 17. előtt létrehozott vektortárak 2024 végéig ingyenesek maradnak, ezt követően pedig:

• Az aktuális díjszabás szerint számlázzuk őket (jelenleg 0,10 USD/GB/nap), ha legalább egyszer használták őket egy 2024. április 17. után létrehozott futtatásban.

• Töröljük őket, ha 2024. április 17. és december 31. között egyetlen futtatásban sem használták őket. Így nem kell fizetned olyan vektortárakért, amelyeket esetleg az árváltozás bejelentése előtt hoztál létre, de soha nem használtál.

Van korlátja annak, hogy hány asszisztenst hozhatok létre?

Nincs korlátja annak, hogy egy szervezet hány asszisztenst hozhat létre.

Elérhető a streamelés az API-ban?

Igen, a streamelés elérhető az Assistants API-ban.

Elérhető a JSON-mód az Assistants API-ban?

Igen, a JSON-mód az Assistants vagy Run objektumok response_format paraméterével érhető el az Assistants API-ban.

Az Assistants API a külső funkcióhívásokhoz tartozó kéréseket is kezeli?

Nem. Bár a funkcióhívás lehetővé teszi, hogy a modell eszközöket válasszon ki és megfelelő formátumú kéréseket állítson össze hozzájuk, a külső eszközök hívásainak végrehajtását nem az OpenAI kezeli.

Hogyan kezeli az OpenAI az általam küldött adatokat?

Ahogy a platformunk többi részén, az OpenAI API-nak átadott adatokat és fájlokat soha nem használjuk modelljeink tanítására, és az adataidat bármikor törölheted. Az Assistants API-ba feltöltött adatokat határozatlan ideig tároljuk, amíg egy felhasználó manuálisan nem törli őket.

Elérhető a DALL-E az Assistants API-n keresztül?

A DALL-E jelenleg nem érhető el.

Van felhasználói felület az Assistants API-hoz?

Megtekintheti az Assistants API-hoz tartozó Playgroundot. Győződjön meg róla, hogy a bal oldalsáv Assistants nézetében van, és olyan modellt használ, amely kompatibilis a bekapcsolni kívánt Tools funkciókkal.

Mi az asszisztensnek szóló utasítások karakterkorlátja az Assistants API-ban?

Az asszisztensnek szóló utasítások mezőjének maximális hossza 256 000 karakter.

Ilyen hibaüzenetet kapok: „A szerveren hiba történt a kérésed feldolgozása közben. Elnézést kérünk! Próbáld meg újra elküldeni a kérést, vagy ha a hiba továbbra is fennáll, lépj kapcsolatba velünk a help.openai.com címen elérhető Súgóközponton keresztül. ” Mit tegyek?

Ez a hiba arra utalhat, hogy az utasításod nincs megfelelően összeállítva. Ha a kérés ismételt próbálkozások után is sikertelen, próbáld ki a következőket:

1. alakítsd át az utasítást úgy, hogy minden függvényszerű parancsot függvényként kezeljen

2. az utasításban szereplő minden parancsot adj hozzá függvényként a tools listához

Miért nem működik megfelelően a fájlkereső eszközöm?

A fájlkereső eszköz használatakor azt javasoljuk, hogy a max_prompt_tokens értékét legalább 20 000-re állítsd. Hosszabb beszélgetések vagy a fájlkereső többszöri használata esetén érdemes ezt a korlátot 50 000-re emelned. A legjobb eredmények érdekében azonban ideális esetben teljesen távolítsd el a max_prompt_tokens korlátot.

Hogyan küldhetek visszajelzést?

Örömmel fogadjuk visszajelzésedet a fejlesztői fórumunkon, a help.openai.com címen elérhető Súgóközponton keresztül, vagy a Twitteren az @OpenAIDevs fióknál.