Claude API integrálása az appodba

A Claude API integrálásához hozz létre API-kulcsot az Anthropic Claude Console-jában, tárold szerveroldali titokként (általában ANTHROPIC_API_KEY néven), és hívd a Messages API-t a saját szervereden lévő útvonalról, az Anthropic hivatalos SDK-k valamelyikével. Minden kérés megnevez egy modellt, beállítja a max_tokens értéket (a leghosszabb választ, amit elfogadsz), és a beszélgetést messages mezőként küldi, az utasításaidat pedig külön system promptban. Állíts be költséghatárt, streameld a hosszú válaszokat, és a sebességkorlát (429) és a túlterhelés (529) hibáit újrapróbálkozással kezeld.

Ez az útmutató a beállítást, a biztonságos kérési folyamatot, AI-építőknek szóló promptokat és a várható hibákat fedi le. Az Anthropic részletei az Anthropic dokumentációjából származnak, 2026 szeptemberi állapot szerint. A tokenek és az árazás általános működéséért olvasd el a hogyan használj LLM API-kat cikket.

Mire építhetsz vele

• Chat-asszisztensek és súgó-widgetek (hogyan építs AI-chatbot appot)
• Összefoglalók, átírások és megválaszolt levelezések piszkozatai
• Adatok kinyerése dokumentumokból, e-mailekből és űrlapokból
• Kérdések megválaszolása a saját tartalmadból
• Ágensek, amelyek az appod függvényeit hívják tool use segítségével

Tovább ötletekért lásd: hogyan adj AI-funkciókat az appodhoz.

A Messages API röviden

Az Anthropic API-referenciája szerint a kérés egy POST a https://api.anthropic.com/v1/messages címre, a következőkkel:

Az API állapotmentes: a beszélgetés folytatásához minden kéréssel újra el kell küldeni a korábbi köröket. Ezért lesz drágább egy hosszú chat üzenetenként.

Az Anthropic hivatalos SDK-kat ad Pythonhoz, TypeScripthez, C#-hoz, Gohoz, Javához, PHP-hez és Rubyhoz. Ezek beállítják a fejléceket, feldolgozzák a válaszokat, és támogatják a streamelést. Használd ezeket a nyers HTTP helyett, hacsak nincs rá komoly okod.

Modell kiválasztása

Az Anthropic több Claude-modellt kínál, amelyek a képességet a sebességgel és az árral váltják, és a kínálat változik. Válaszd a legkisebb modellt, amely jól elvégzi a feladatot, teszteld valódi példákon, és a modell-azonosítót konfigurációban tartsd, hogy kódmódosítás nélkül lehessen váltani. Az aktuális lehetőségekért és díjakért nézd meg az Anthropic modell- és árazási oldalait.

A fiók beállítása

1. Jelentkezz be a Claude Console-ba a platform.claude.com címen, és adj hozzá fizetési módot.
2. Hozz létre API-kulcsot. Környezetenként (teszt és éles) legyen külön kulcsod, hogy az egyiket visszavonhasd a másik megszakítása nélkül.
3. Állíts be költséghatárt. Az Anthropic hibaoldala szerint, ha a használat eléri a beállított költséghatárt, az API 400-as hibát ad, ezért az appodnak világos üzenetet kell mutatnia.
4. Nézd át a sebességkorlátokat a fiókodhoz a Console-ban; ezek szervezeti szinten mérődnek.

A kérési folyamat

1. A felhasználó az appodban cselekszik: üzenetet küld, rákattint az „Összefoglalás” gombra.
2. A böngésző a te szerveri útvonaladat hívja, soha nem közvetlenül az Anthropicot.
3. A szervered ellenőrzi, hogy a felhasználó be van-e jelentkezve és használhatja-e a funkciót, és alkalmaz felhasználónkénti korlátot.
4. Felépíti a kérést: a rendszerprompt a szabályaiddal, a felhasználó bemenete és az adatbázisodból a feladathoz szükséges adatok.
5. Meghívja a Messages API-t a környezetből olvasott kulccsal és ésszerű max_tokens értékkel.
6. Streamelve visszaküldi a választ a böngészőnek, és naplózza a válasz tokenhasználatát.

Lehetőségek és kompromisszumok

Promptok az AI-építődnek

Egy első funkció:

Adj hozzá egy „Kérdezz a dokumentumról” panelt. Hívjon egy szerveroldali útvonalat, POST /api/ask, amely ellenőrzi, hogy a felhasználó be van-e jelentkezve és a dokumentum tulajdonosa-e, majd meghívja a Claude Messages API-t a hivatalos Anthropic SDK-val és a titkos ANTHROPIC_API_KEY kulccsal. A modell-azonosítót a CLAUDE_MODEL titokból olvassa. Rendszerprompt: „Csak a megadott dokumentumból válaszolj. Ha a válasz nincs benne, mondd ezt.” Küldd el a dokumentum szövegét és a kérdést, állítsd be a max_tokens értéket 800-ra, streameld a választ az oldalra, és a kulcsot soha ne add ki a böngészőnek.

Korlátok és hibák:

Korlátozd felhasználónként óránként 20 kérdésre, az adatbázisban tárolva. Minden válaszból naplózd a bemeneti és kimeneti tokeneket a felhasználó azonosítójával és a kérés azonosítójával. 429 vagy 529 hiba esetén próbálkozz újra exponenciális visszalépéssel legfeljebb 3-szor, tiszteld a retry-after fejlécet, majd mutasd: „Az asszisztens foglalt, próbáld újra kicsit később.” Ha az API költséghatár-hibát jelez, mutasd: „Az AI-funkciók szünetelnek”, és értesítsd az adminisztrátort.

Hibák, amikre fel kell készülni

Az Anthropic hibadokumentációja alapján azok, amikbe az appod ténylegesen belefut:

Az Anthropic dokumentációja szerint a hivatalos SDK-k alapértelmezés szerint kétszer automatikusan újrapróbálják az átmeneti hibákat (kapcsolódási hibák, sebességkorlátok és 5xx hibák) exponenciális visszalépéssel, és ez konfigurálható. Minden válasz tartalmaz egy request-id fejlécet; naplózd, hogy a támogatás nyomon tudja követni a problémákat.

Gyakori hibák

• Hívás a böngészőből. A kulcsod nyilvánossá válik. Mindig a szerveren keresztül hívj. Lásd: hogyan őrizd biztonságban az API-kulcsaidat.
• Elfelejteni, hogy a max_tokens plafon, nem cél. Állítsd be a funkció szükségletére; túl alacsony csonkolja a válaszokat, túl magas hosszú, drága válaszok kockázatát hordozza.
• Szabályok a felhasználói üzenetben. Az állandó utasítások a system promptba tartoznak; a jogosultságok a kódodba.
• A teljes chat örökre küldése. Vágd vagy foglald össze a régi köröket, ahogy a beszélgetések nőnek.
• Nincs költséghatár vagy felhasználónkénti korlát.
• Modell-azonosító beégetése a kódba. A modellek frissülnek és kivezetésre kerülnek.
• A megállási ok figyelmen kívül hagyása. Ha a válasz azért állt meg, mert elérte a max_tokens értéket, szólj a felhasználónak, vagy emeld a plafont.

Ellenőrzőlista

• API-kulcs létrehozva a Claude Console-ban, szerveroldali titokként tárolva
• Külön kulcsok a teszteléshez és az éleshez
• Költséghatár beállítva; világos üzenet, ha eléri
• Minden kérés a szerveren megy, jogosultság-ellenőrzéssel
• A rendszerprompt tartalmazza a szabályokat; a modell-azonosító konfigurálható
• max_tokens funkciónként beállítva; a hosszú válaszok streamelve
• Felhasználónkénti sebességkorlát az appban
• 429 és 529 kezelve visszalépéssel; kérés-azonosítók naplózva
• Barátságos hibaállapot, ami nem töri el az oldalt
• Tesztelve üres, nagyon hosszú és ellenséges bemenetekkel

A Claude API használata a Mythexben

A Mythexen épített appokban a Claude-funkciók a saját Anthropic-kulcsodat használják, és az Anthropic-fiókodra terhelődnek, nem a Mythex build-kreditjeire. Ez független attól az ágenstől, amely a kódodat írja. Add hozzá az ANTHROPIC_API_KEY értéket projekt-titokként a /secrets oldalon, a projektbeállításokban vagy a csevegésben megjelenő titokkártyán, majd írd le a funkciót a fenti promptokhoz hasonlóan. Éles appnál a titok módosítása után publikálj újra. Kezdő prompt a AI-funkciók hozzáadása a saját API-kulcsokkal oldalon található. Ha szolgáltatók között választasz, a hogyan integráld az OpenAI API-t cikk ugyanezt tárgyalja az OpenAI-ra.

Kérdések