Anthropic integráció
Gyors és érthető leírás, hogy hogyan kösd be a Anthropic fiókodat a Suara rendszerébe.
Haladási szint
0% · Befejezés: 4 perc
Mi az az Anthropic?
Az Anthropic a Claude nyelvi modellek fejlesztője. A Claude szöveget ír, összefoglal, kategorizál, kérdésekre válaszol, és tartalmat elemez. A modelleket API-n keresztül, a saját Anthropic-fiókod kulcsával érheted el.
Mire használhatod a Suarában?
Ha összekötöd az Anthropicot, az appod saját AI-funkciókat kaphat, a Claude modellekkel. Néhány példa:
Chat-asszisztens: az oldaladon egy ügyfélszolgálati vagy tanácsadó chatbot válaszol a látogatók kérdéseire.
Összefoglaló: az app hosszú szövegekből (cikk, jegyzet, levél) rövid összefoglalót készít.
Tartalomgenerálás: termékleírás, hírlevélszöveg vagy poszt készül egy megadott témából.
Jegyosztályozás: a beérkező kérések vagy hibajelentések kategóriát és sürgősséget kapnak.
A válaszok streamelhetők, vagyis szóról szóra jelennek meg a felületen, nem kell megvárni a teljes választ.
Az AI az alábbi műveleteket használja:
Üzenet küldése a Claude-nak: a modell választ ad egy kérdésre vagy utasításra. Megadható egy rendszerutasítás is (például „Magyarul válaszolj, közérthetően.”).
Tokenek számolása: megmutatja, hány tokenből áll egy szöveg, még a küldés előtt.
Modellek lekérdezése: kilistázza, mely modelleket éri el a kulcsod. Az AI ez alapján választ modellt, nem találgat.
Fontos tudnivaló a költségekről
A használatot közvetlenül az Anthropic-fiókod fizeti, a Suara ebből nem számol fel külön díjat. Az API-használathoz az Anthropic-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 a Console-ban é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 Anthropicot, 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 Anthropic Console-ban
Jelentkezz be az Anthropic Console-ba, vagy regisztrálj: https://console.anthropic.com
Nyisd meg az API-kulcsok oldalt: https://console.anthropic.com/settings/keys
Kattints a Create key gombra.
Adj a kulcsnak nevet (például „Suara”), majd hozd létre.
Másold ki a kulcsot.
Fontos: a kulcs csak egyszer jelenik meg, ezért másold ki rögtön. Ha elveszted, töröld, és hozz létre újat.
2. Kösd be a Suarában
A Suara oldalsávjában nyisd meg az Integrációk oldalt.
A Katalógusban keresd meg az Anthropicot. Az AI kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).
Kattints a Csatlakoztatás gombra. Megnyílik az „Anthropic csatlakoztatása” ablak.
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 a Console API-kulcs oldalára visz.
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.
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 Anthropic 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 a Claude-dal 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 Anthropic 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 projektekbe kötéshez be kell kapcsolni a Suara Cloudot. Ha még nincs bekapcsolva, kérd meg az AI-t a chatben. A kapcsolatot ettől függetlenül használhatod csak a chatben is (Csak chat), az appba bekötni később is lehet.
A bekötés után az AI az Anthropic-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 Anthropic 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 Anthropicot.
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 Anthropic Console-ban nincs letiltva vagy törölve.
A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett vagy lejárt. Generálj újat a Console-ban, é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 fizetésre vagy egyenlegre utal: Az Anthropic-fiókodban elfogyott az egyenleg, vagy nincs fizetési mód megadva. Töltsd fel az egyenleget a Console-ban.
A modell nem érhető el: Nem minden modell elérhető minden fiókon. 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 Anthropic a fiókodra érvényes sebességkorlátot alkalmaz. Csökkentsd a hívások számát, vagy kérj magasabb limitet az Anthropictól.