OpenAI integráció

Mi az az OpenAI?

Az OpenAI a GPT nyelvi modellek fejlesztője. A modellek szöveget írnak, összefoglalnak, kérdésekre válaszolnak, és szövegből számokká alakított „jelentésvektort” (embeddinget) is tudnak készíteni. A modelleket API-n keresztül, a saját OpenAI-fiókod kulcsával érheted el.

Mire használhatod a Suarában?

Ha összekötöd az OpenAI-t, az appod saját AI-funkciókat kaphat. Néhány példa:

• Chat-asszisztens: az oldaladon egy chatbot válaszol a látogatók kérdéseire.

• Szöveggenerálás: termékleírás, hírlevélszöveg vagy válaszvázlat készül egy megadott témából.

• Szemantikus keresés: az embeddingek segítségével az app jelentés szerint keres a tartalmak között, nem csak pontos szóegyezésre.

• Tartalommoderálás: az app felismeri a nem megfelelő felhasználói tartalmakat (például kommenteket).

A válaszok streamelhetők, vagyis fokozatosan jelennek meg a felületen, nem kell megvárni a teljes választ.

Az AI az alábbi műveleteket használja:

• Chat-válasz kérése: a modell választ ad egy kérdésre vagy utasításra.

• Válasz kérése a Responses API-n: az OpenAI újabb, egységes válaszkérő végpontja.

• Embedding készítése: a szöveget számsorrá alakítja, amelyet keresésre és hasonlóság-számításra lehet használni.

• Moderálás: megvizsgálja, hogy egy szöveg tartalmaz-e kifogásolható tartalmat.

• Modellek lekérdezése: kilistázza, mely modelleket éri el a kulcsod. A modellkínálat fiókonként eltér, ezért az AI ebből választ, nem találgat.

Fontos tudnivaló a költségekről

A használatot közvetlenül az OpenAI-fiókod fizeti, a Suara ebből nem számol fel külön díjat. Az API-használathoz az OpenAI-fiókodban fizetési módnak vagy feltöltött egyenlegnek kell lennie. Az appod minden hívása a te egyenlegedet terheli, ezért az OpenAI platformon érdemes költési limitet beállítani.

Biztonság

Az API-kulcs titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja az OpenAI-t, a gateway pedig a háttérben hozzáadja a kulcsot. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Beállítás lépésről lépésre

1. Szerezd meg az API-kulcsot az OpenAI platformon

1. Jelentkezz be az OpenAI API-platformra, vagy regisztrálj: https://platform.openai.com

2. Nyisd meg az API-kulcsok oldalt: https://platform.openai.com/api-keys

3. Kattints a Create new secret key gombra.

4. Adj a kulcsnak nevet (például „Suara”), majd hozd létre.

5. Másold ki a kulcsot.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg az OpenAI-t. Az AI kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik az „OpenAI csatlakoztatása” ablak.

4. Illeszd be a másolt kulcsot az API kulcs mezőbe. A beillesztett érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás az OpenAI API-kulcs oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben, és a használat a te fiókodat terheli.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a kulcshoz elérhető modelleket, és ha a kulcs érvényes, a kapcsolat OpenAI néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „Építs az oldalra egy chatbotot, amely GPT-vel válaszol a látogatók kérdéseire.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között az OpenAI mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI az OpenAI-hívásokat az app szerveroldali (edge function) részében generálja. A kulcs így nem kerül a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt az OpenAI kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új API-kulcs mentése, ha lecserélted vagy törölted a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem érik el az OpenAI-t.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a kulcs helyesen lett kimásolva (szóköz nélkül), és hogy az OpenAI platformon nincs törölve.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett vagy lejárt. Generálj újat az OpenAI platformon, és mentsd el a Kulcsok frissítése résznél.

• Az app nem kap választ az AI-tól: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• Hibaüzenet kvótára vagy egyenlegre utal: Az OpenAI-fiókodban elfogyott az egyenleg, vagy nincs fizetési mód megadva. A ChatGPT-előfizetés nem számít bele, az API-hoz külön kell egyenleget feltölteni az OpenAI platformon.

• A modell nem érhető el: A modellkínálat fiókonként eltér. Kérd meg az AI-t, hogy kérdezze le az elérhető modelleket, és válasszon közülük.

• Túl sok kérés miatt hibát kapok: Az OpenAI a fiókodra érvényes sebességkorlátot alkalmaz. Csökkentsd a hívások számát, vagy kérj magasabb limitet az OpenAI-tól.