What is AgentKit, and which one should I use?

AgentKit commonly refers to Coinbase AgentKit for onchain actions and Inngest AgentKit for orchestrating agents. Choose Coinbase for Web3 tasks (wallets, tokens) and Inngest for multi-agent, event-driven workflows.

How do I safely let an AI agent move funds onchain?

Use small balances, strict tool schemas, and confirmation prompts for risky actions. For production, integrate Safe smart accounts and require multisig or policy approvals.

Can I combine OpenAI Agents with Coinbase AgentKit?

Yes. Connect your reasoning layer (OpenAI Agents/function calling) to Coinbase AgentKit tools. Many devs also add Inngest for orchestration and retries.

What are common pitfalls when using AgentKit?

Hardcoding keys, skipping testnets, and allowing unbounded actions are the big ones. Add rate limits, spend caps, and robust observability to stay safe.

Where can I find a quickstart to build a Web3 AI agent?

Start with Coinbase’s AgentKit quickstart for setup and examples, plus tutorials from QuickNode and workshop videos for end-to-end guidance.

Az AgentKit használata: Gyakorlati, teljes körű útmutató AI ügynökök építéséhez

Ha hallottad az „AgentKit”-ről szóló híreket, és kíváncsi vagy, hogyan lehet ténylegesen munkába állítani, jó helyen jársz. Itt a bökkenő: az AgentKit nem egyetlen termék. A nevet több ökoszisztéma is használja – leginkább a Coinbase AgentKit-je az onchain/Web3 műveletekhez, az Inngest AgentKit-je az ügynökhálózatok vezényléséhez, valamint a különböző oktatóanyagok az OpenAI Agents SDK-val a Coinbase készlet mellett. Ez az útmutató kibontja, hogy melyik AgentKit micsoda, miért választanád az egyiket a másik helyett, és hogyan állítsd be lépésről lépésre, profi tippekkel és valós mintákkal, amelyeket újra felhasználhatsz.

Gyakorlati és megoldásorientált megközelítést alkalmazunk: gyors összehasonlítások, világos beállítás, futtatható példák és elkerülendő buktatók.

Melyik „AgentKit”-ről beszélsz?

Coinbase AgentKit (CDP/Onchain): Lehetővé teszi az AI ügynökök számára a pénztárcák kezelését, az onchain tranzakciók küldését, a tokenek telepítését és még sok mást a támogatott hálózatokon. Ideális Web3-natív ügynökök építéséhez (pl. borravaló botok, token telepítők, NFT terjesztők). Gyorsindító útmutatók és workshopok széles körben elérhetők.

Inngest AgentKit: Egy keretrendszer az ügynökök, eszközök definiálásához és a hálózaton belüli futtatásához, a skálázható, eseményvezérelt végrehajtásra összpontosítva.

Safe/Protocol Kit-ek (környezet): Ha az ügynöködnek intelligens számlavezérlésre (multisig, szabályzat, kötegelt hívások) van szüksége, a Safe Protocol Kit-jét gyakran párosítják onchain ügynökökkel a biztonságos végrehajtás érdekében.

Ha a célod egy onchain AI ügynök gyors létrehozása, kezdd a Coinbase AgentKit-tel. Ha robusztus, több ügynökből álló architektúrára és ütemezésre van szükséged, az Inngest AgentKit egy jó választás. Sok csapat kombinálja a kettőt: OpenAI Agents az érveléshez + Coinbase AgentKit az onchain műveletekhez + Inngest a vezényléshez.

: Gyors döntési útmutató

Olyan Web3 ügynökre van szükséged, amely képes pénzeszközöket mozgatni, tokeneket telepíteni vagy dApp-okkal interakcióba lépni → Használd a Coinbase AgentKit-et.

Tartós, eseményvezérelt rendszerre van szükséged, amely több ügynököt/eszközt vezényel újrapróbálkozásokkal és állapottal → Használd az Inngest AgentKit-et.

Vállalati szintű pénztárcabiztonságra vagy multisig irányításra van szükséged az ügynöködhöz → Integráld a Safe Protocol Kit-jét az ügynököd mellé.

1. rész: A Coinbase AgentKit használata (Onchain ügynökök)

Miért a Coinbase AgentKit?

Az onchain feladatokhoz beépítve (pénztárcaműveletek, átutalások, tokenkezelés)

Tiszta fejlesztői élmény és gyorsindító eszközök

Ideális olyan botokhoz/ügynökökhöz, amelyek a közösségi médiában (pl. X) lépnek kapcsolatba a felhasználókkal, és a műveleteket onchain rendezik.

Beállítás áttekintése

Telepítsd a CLI-t és az SDK-t (a gyorsindító szerint), és konfiguráld a környezeti változókat a hálózat, a kulcsok és az RPC végpontok számára.

Inicializálj egy projektet, és válaszd ki a szükséges onchain képességeket.

Kösd össze az eszközöket (pl. pénztárcaműveletek, token telepítés) az ügynököddel.

Kapcsold össze az ügynököt egy következtetési modellel (OpenAI vagy hasonló), hogy eldöntse, mikor hívja az eszközöket.

Kövesd a hivatalos gyorsindítót, hogy percek alatt elindulj. A pénztárcákat kezelő és a Twitteren/X-en interakcióba lépő Web3 AI ügynök építéséről szóló gyakorlati oktatóanyagért lásd a QuickNode bemutatót és egy videós bemutatót egy AgentKit Twitter bot létrehozásáról.

Példa architektúra

Következtetési réteg: LLM függvény/eszköz hívással

Műveleti réteg: Coinbase AgentKit eszközök (átutalás, token telepítés)

Perzisztencia: Az ügynök memóriájának/céljainak tárolása egy adatbázisban

Felhasználói felület: Chat UI vagy közösségi bot (X) a felhasználói kérésekhez

Bevált gyakorlatok

A legkisebb jogosultság elve: korlátozd az ügynökkulcsokat a szükséges hatókörökre és a kis egyenlegekre

Szabályzat kérések: határozz meg explicit szabályokat arról, hogy mikor engedélyezettek az onchain műveletek

Korlátok: tranzakció előnézet/megerősítés, időablakonkénti korlátok megvalósítása

Megfigyelhetőség: naplózd az eszközhívásokat, tranzakciókat és modellkimeneteket az auditálhatóság érdekében

Gyakori buktatók

Lax kulcskezelés: soha ne kódolj keményen titkokat; használj tárolót

Korlátlan műveletek: kérj megerősítést a nagy értékű átutalásokhoz

Hiányzó sebességkorlátozások: védd az RPC végpontokat és a közösségi API-kat

2. rész: Az Inngest AgentKit használata (Ügynökhálózatok és vezénylés)

Miért az Inngest AgentKit?

Az ügynökök elsőrangú, állapotmentes munkavállalókként, célokkal és eszközkészletekkel

Hálózatok több ügynök koordinálására összetett munkafolyamatokhoz

Eseményvezérelt tervezés újrapróbálkozásokkal és tartós végrehajtással

Kezdd a gyorsindítóval, hogy elindítsd az első ügynöködet, és futtasd egy hálózaton belül. Olvasd el az alapvető fogalmakat – ügynökök, eszközök, hálózatok –, mielőtt bekötnéd az üzleti logikát.

Beállítási lépések

Határozd meg az ügynök célját és a rendelkezésre álló eszközöket (API-k, belső szolgáltatások, onchain készletek).

Hozzon létre egy hálózatot, és regisztrálj ügynököket.

Bocsáss ki eseményeket az ügynökök elindításához; használj újrapróbálkozásokat és visszalépést a rugalmasság érdekében.

Adj hozzá megfigyelhetőséget: naplók, nyomkövetések, eredmények.

Vezénylési minták

Felügyelő-munkavállaló: egy tervező ügynök feladatokat delegál szakértő ügynököknek

Esemény-sourcing: az állapotváltozások ügynököket indítanak el a reagálásra (pl. payment_received → fulfillment_agent)

Ember a hurokban: jóváhagyások kockázatos műveletekhez, szüneteltetéssel/folytatással

Tippek

Tartsd az ügynököket állapotmentesen; add át a kontextust eseményeken/állapottárolókon keresztül

Verziószámozd az eszközöket és a kéréseket a teljesítmény időbeli nyomon követéséhez

Szimuláld a hiba módokat; ellenőrizd az idempotenciát a külső hívásokhoz

3. rész: Biztonságos végrehajtás a Safe-fel (opcionális, de ajánlott)

Ha az ügynököd pénzeszközöket kezel vagy adminisztratív műveleteket hajt végre, integrálj intelligens számlákat irányítással. A Safe Protocol Kit biztosítja az intelligens számlák és a multisig folyamatok létrehozását, konfigurálását és végrehajtását.

Használati eset: Egy onchain ügynök tranzakciókat küld be, míg a tulajdonosok (emberek vagy felügyelő ügynökök) aláírják azokat

Előny: Szabályozási ellenőrzések, költési limitek és biztonságos helyreállítás

Minta: Az ügynök tranzakciókat javasol; egy szabályzatmotor (vagy ember) aláírja és végrehajtja azokat

Lépésről lépésre: Minimális Onchain ügynök építése

Az alábbiakban egy fogalmi folyamat látható, amelyet adaptálhatsz (nyelvfüggetlen, pszeudokód stílusú). A működő kódért és a CLI parancsokért tekintsd meg a Coinbase gyorsindítót.

Projekt inicializálása és függőségek telepítése

Hozzon létre egy projektkönyvtárat, és telepítse az AgentKit SDK-t és az LLM klienst

Környezeti változók beállítása: RPC URL, privát kulcs vagy kezelt pénztárca, hálózat

Eszközök és képességek meghatározása

Pénztárca: get_balance, transfer(to, amount)

Tokenek: deploy_erc20(name, symbol, supply)

Szerződéshívások olvasása/írása szükség szerint

Következtetési modell csatlakoztatása

Adj meg egy rendszerkérést, amely meghatározza a célokat és a korlátokat

Regisztráld az eszközöket sémákkal a biztonságos függvényhívás érdekében

Biztonság és szabályzatok hozzáadása

Kényszeríts ki megerősítést a küszöbérték feletti átutalásokhoz

Korlátozd a napi költést, engedélyezd a címzettek címének listázását a termeléshez

Alapvető interfész szállítása

CLI: agent ask "Send 0.01 ETH to 0x..."

Web/Chat: minimális felhasználói felület a feladatok elküldéséhez és a nyugták megjelenítéséhez

Először tesztneten teszteld

Csapold meg a pénzeszközöket; ellenőrizd a műveletnaplókat és a tranzakciós hash-eket

Áttérés a termelésre megfigyelhetőséggel

Telemetria rögzítése, riasztások a sikertelen tranzakciókról és a modell viselkedésének eltolódása

A termelésben működő minták

Tervezz-majd-cselekedj: használd a modellt a lépések vázolására az eszközök meghívása előtt

Szárazfutási mód: a tranzakciók előnézete és jóváhagyás kérése

Költségvetési borítékok: adj minden feladathoz egy költési sapkát és eszköz időtúllépéseket

Szintetikus monitorozás: az ütemezett feladatok validálják az ügynök egészségét és az RPC kapcsolatot

Valós példahelyzetek

Közösségi borravaló bot: A felhasználók megemlítik a botot az X-en; az ügynök borravalót ad az ellenőrzött pénztárcáknak onchain

Ügyféljutalmak: Az ügynök nyomon követi az onchain műveleteket, és hetente jutalom tokeneket küld

DAO műveletek: Az ügynök Safe tranzakciókat tervez a javaslatokhoz; a multisig aláírja a felülvizsgálat után

Piactéri asszisztens: Az ügynök listázza az NFT-ket, és válaszol a felhasználói kérdésekre, a kereskedéseket a megerősítés után hajtja végre

A Web3 ügynökök építéséhez lásd a QuickNode oktatóanyagot és a Coinbase workshopját, amely az Agents SDK + AgentKit integrációt mutatja be.

Hibaelhárítás: Gyors javítások

Az ügynököm nem tud tranzakciókat küldeni: Ellenőrizd a hálózatot, a gázbeállításokat és a kulcsengedélyeket; próbálj ki először egy tesztnetet

Az eszközhívások rendszertelenek: Húzd meg az eszközsémákat és az érvényesítést; adj hozzá előzetes ellenőrzési kéréseket

A futások hibásak: Adj hozzá újrapróbálkozásokat visszalépéssel; figyeld az RPC sebességkorlátozásokat és az állapotkódokat

Biztonsági aggályok: Forgasd el a kulcsokat, karanténozd a pénzeszközöket, térj át a Safe-alapú jóváhagyásokra

Mellesleg: Gyorsítsd fel a munkafolyamatodat a Sider.AI segítségével

Érdemes megjegyezni – ha kéréseket, ragasztókódot és dokumentumokat iterálsz, egy segéd segíthet. A Sider.AI segítségével rendszerezetten tarthatod a kutatásokat, a kódrészleteket és a kísérleti naplókat a szerkesztőd mellett, felgyorsítva az ügynökök építési-mérési-tanulási ciklusait. Fedezd fel itt:

Főbb tudnivalók

Az „AgentKit” általában a Coinbase onchain eszközkészletére és az Inngest vezénylőkészletére utal – válassz az onchain műveletek vagy a több ügynökből álló koordináció szükségessége alapján.

Kezdd kicsiben: tesztnet, minimális eszközök, szigorú szabályzatok; fokozatosan adj hozzá képességeket.

Pénzügyi vagy adminisztratív jogosultság esetén integráld a Safe-et az irányítás és a biztonság érdekében.

Kezeld az ügynököt úgy, mint a termelési szoftvert: naplózás, riasztások, korlátok és emberi jóváhagyás.

További információk

Coinbase AgentKit gyorsindító és CLI

Workshop: OpenAI Agents SDK a Coinbase AgentKit-tel

Web3 AI ügynök építése (QuickNode)

Inngest AgentKit gyorsindító és fogalmak

Safe Protocol Kit a biztonságos intelligens számlákhoz

GYIK

Q1:Mi az az AgentKit, és melyiket kellene használnom? Az AgentKit általában a Coinbase AgentKit-re utal az onchain műveletekhez és az Inngest AgentKit-re az ügynökök vezényléséhez. Válaszd a Coinbase-t a Web3 feladatokhoz (pénztárcák, tokenek), az Inngestet pedig a több ügynökből álló, eseményvezérelt munkafolyamatokhoz.

Q2:Hogyan engedhetem meg biztonságosan egy AI ügynöknek, hogy pénzeszközöket mozgasson onchain? Használj kis egyenlegeket, szigorú eszközsémákat és megerősítési kéréseket a kockázatos műveletekhez. A termeléshez integráld a Safe intelligens számlákat, és kérj multisig vagy szabályzat jóváhagyásokat.

Q3:Kombinálhatom az OpenAI Agents-et a Coinbase AgentKit-tel? Igen. Kapcsold össze a következtetési réteget (OpenAI Agents/függvényhívás) a Coinbase AgentKit eszközökkel. Sok fejlesztő hozzáadja az Inngest-et a vezényléshez és az újrapróbálkozásokhoz is.

Q4:Melyek a gyakori buktatók az AgentKit használatakor? A kulcsok keménykódolása, a tesztnetek kihagyása és a korlátlan műveletek engedélyezése a legnagyobbak. Adj hozzá sebességkorlátozásokat, költési sapkákat és robusztus megfigyelhetőséget a biztonság érdekében.

Q5:Hol találok egy gyorsindítót egy Web3 AI ügynök építéséhez? Kezdd a Coinbase AgentKit gyorsindítójával a beállításhoz és a példákhoz, plusz a QuickNode oktatóanyagaival és a workshop videóival a teljes körű útmutatáshoz.