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.

Kako uporabljati AgentKit: Praktičen vodnik od začetka do konca za gradnjo agentov umetne inteligence

Če ste že slišali za »AgentKit« in se sprašujete, kako ga dejansko uporabiti, ste na pravem mestu. Toda pozor: AgentKit ni en sam izdelek. Ime uporablja več ekosistemov – predvsem Coinbaseov AgentKit za onchain/Web3 dejanja, Inngestov AgentKit za orkestriranje mrež agentov in različne vadnice, ki uporabljajo OpenAI Agents SDK skupaj s Coinbaseovim kompletom. Ta vodnik razkriva, kaj je vsak AgentKit, zakaj bi izbrali enega namesto drugega in kako ga korak za korakom nastaviti, s profesionalnimi nasveti in vzorci iz resničnega sveta, ki jih lahko ponovno uporabite.

Uporabili bomo praktičen in na rešitve usmerjen pristop: hitre primerjave, jasna nastavitev, izvedljivi primeri in pasti, ki se jim je treba izogniti.

O katerem »AgentKit« govorite?

Coinbase AgentKit (CDP/Onchain): Omogoča agentom umetne inteligence upravljanje denarnic, pošiljanje transakcij na verigi blokov, uvajanje žetonov in še več v podprtih omrežjih. Idealen je za gradnjo agentov, ki so domači v Web3 (npr. roboti za napitnine, uvajalci žetonov, distributerji NFT). Vodniki za hiter začetek in delavnice so na voljo.

Inngest AgentKit: Okvir za definiranje agentov, orodij in njihovo izvajanje znotraj omrežja, osredotočen na razširljivo izvajanje, ki ga poganjajo dogodki. Odličen je za orkestriranje več agentov, logiko ponovnega poskušanja in poteke dela v ozadju.

Safe/Protocol Kits (kontekst): Če vaš agent potrebuje pametno kontrolo računa (multisig, pravilnik, paketni klici), se Safe’s Protocol Kit pogosto uporablja skupaj z onchain agenti za varno izvajanje.

Če je vaš cilj hitro zgraditi onchain AI agenta, začnite s Coinbase AgentKit. Če potrebujete robustno arhitekturo z več agenti in razporejanje, je Inngest AgentKit odlična izbira. Mnoge ekipe kombinirajo oboje: OpenAI Agents za sklepanje + Coinbase AgentKit za onchain dejanja + Inngest za orkestracijo.

: Vodnik za hitro odločanje

Želite Web3 agenta, ki lahko premika sredstva, uvaja žetone ali komunicira z dapps → Uporabite Coinbase AgentKit.

Potrebujete trajen sistem, ki ga poganjajo dogodki in ki orkestrira več agentov/orodij s ponovnimi poskusi in stanjem → Uporabite Inngest AgentKit.

Za svojega agenta potrebujete varnost denarnice na ravni podjetja ali upravljanje z več podpisi → Integrirajte Safe’s Protocol Kit poleg svojega agenta.

1. del: Kako uporabljati Coinbase AgentKit (Onchain Agenti)

Zakaj Coinbase AgentKit

Izdelan za onchain naloge takoj iz škatle (operacije z denarnicami, prenosi, upravljanje žetonov)

Čista razvijalska izkušnja in orodja za hiter začetek

Idealen za robote/agente, ki komunicirajo z uporabniki na družbenih omrežjih (npr. X) in poravnavajo dejanja na verigi blokov

Pregled nastavitve

Namestite CLI in SDK (v skladu s hitrim začetkom) in konfigurirajte spremenljivke okolja za omrežje, ključe in RPC končne točke.

Inicializirajte projekt in izberite onchain zmogljivosti, ki jih potrebujete.

Povežite orodja (npr. operacije z denarnico, uvajanje žetonov) s svojim agentom.

Povežite agenta z modelom sklepanja (OpenAI ali podobnim), da se odloči, kdaj poklicati orodja.

Sledite uradnemu hitremu začetku, da začnete delovati v nekaj minutah. Za praktično vadnico o gradnji Web3 AI agenta, ki upravlja denarnice in komunicira na Twitterju/X, si oglejte QuickNode walkthrough in video predstavitev o ustvarjanju AgentKit Twitter bota.

Primer arhitekture

Sloje sklepanja: LLM s funkcijo/orodjem za klicanje

Sloje dejanja: Orodja Coinbase AgentKit (prenos, uvajanje žetonov)

Vztrajnost: Shranjevanje spomina/ciljev agenta v bazi podatkov

Vmesnik: Klepetalni vmesnik ali družabni robot (X) za uporabniške pozive

Najboljše prakse

Načelo najmanjših privilegijev: omejite ključe agenta na potrebna področja in majhna stanja

Pozivi pravilnika: določite izrecna pravila o tem, kdaj so dovoljena onchain dejanja

Varovala: implementirajte predogled/potrditev transakcije, omejitve na časovno okno

Opazovalnost: beležite klice orodij, transakcije in rezultate modela za revizijo

Pogoste pasti

Slabo upravljanje ključev: nikoli ne kodirajte skrivnosti; uporabite trezor

Neomejena dejanja: zahtevajte potrditve za prenose velike vrednosti

Manjkajoče omejitve hitrosti: zaščitite RPC končne točke in družbene API-je

2. del: Kako uporabljati Inngest AgentKit (Mreže agentov in orkestracija)

Zakaj Inngest AgentKit

Agenti kot prvovrstni, brezsistemski delavci s cilji in nabori orodij

Mreže za usklajevanje več agentov za kompleksne poteke dela

Zasnova, ki jo poganjajo dogodki, s ponovnimi poskusi in trajnim izvajanjem

Začnite s hitrim začetkom, da zaženete svojega prvega agenta in ga zaženete znotraj omrežja. Preberite temeljne koncepte – agenti, orodja, omrežja – preden povežete poslovno logiko.

Koraki nastavitve

Določite cilj svojega agenta in razpoložljiva orodja (API-ji, notranje storitve, onchain kompleti).

Ustvarite omrežje in registrirajte agente.

Oddajajte dogodke za sprožitev agentov; uporabite ponovne poskuse in odmik za odpornost.

Dodajte opazovalnost: dnevnike, sledi, izide.

Vzorci orkestracije

Nadrejeni-delavec: načrtovalni agent prenese naloge na specializirane agente

Vir dogodkov: spremembe stanja sprožijo odziv agentov (npr. payment_received → fulfillment_agent)

Človek v zanki: odobritve za tvegana dejanja, s premorom/nadaljevanjem

Nasveti

Ohranite agente brez stanja; posredujte kontekst prek dogodkov/shramb stanja

Različice orodij in pozivov za sledenje uspešnosti skozi čas

Simulirajte načine okvare; preverite idempotentnost za zunanje klice

3. del: Varno izvajanje s Safe (izbirno, vendar priporočljivo)

Če vaš agent upravlja sredstva ali izvaja administrativne operacije, integrirajte pametne račune z upravljanjem. Safe’s Protocol Kit zagotavlja ustvarjanje, konfiguracijo in izvajanje za pametne račune in multisig poteke.

Primer uporabe: Onchain agent odda transakcije, medtem ko lastniki (ljudje ali nadzorni agenti) so-podpisujejo

Prednost: Nadzor pravilnika, omejitve porabe in varno obnovitev

Vzorec: Agent predlaga transakcije; mehanizem pravilnika (ali človek) podpiše in izvede

Korak za korakom: Gradnja minimalnega Onchain Agenta

Spodaj je konceptualni potek, ki ga lahko prilagodite (jezikovno-agnostični, psevdokodni slog). Oglejte si Coinbaseov hiter začetek za delujočo kodo in ukaze CLI.

Inicializirajte projekt in namestite odvisnosti

Ustvarite projektno mapo in namestite AgentKit SDK in svojega LLM odjemalca

Nastavite spremenljivke okolja: RPC URL, zasebni ključ ali upravljana denarnica, omrežje

Določite orodja in zmogljivosti

Denarnica: get_balance, transfer(to, amount)

Žetoni: deploy_erc20(name, symbol, supply)

Po potrebi berite/pišite klice pogodb

Povežite model sklepanja

Zagotovite sistemski poziv, ki določa cilje in omejitve

Registrirajte orodja s shemami za varno klicanje funkcij

Dodajte varnost in pravilnike

Uveljavite potrditev za prenose nad pragom

Omejite dnevno porabo, dovolite seznam naslovov prejemnikov za proizvodnjo

Pošljite osnovni vmesnik

CLI: agent ask "Pošlji 0.01 ETH na 0x..."

Splet/Klepet: minimalen uporabniški vmesnik za oddajo nalog in prikaz potrdil

Najprej testirajte na testnem omrežju

Pridobite sredstva; preverite dnevnike dejanj in zgoščenke transakcij

Premaknite se v proizvodnjo z opazovalnostjo

Zajemite telemetrijo, opozorila o neuspelih transakcijah in odklone v vedenju modela

Vzorci, ki delujejo v proizvodnji

Načrtujte-nato-delujte: uporabite model za oris korakov pred priklicem orodij

Način suhega zagona: predoglejte si transakcije in prosite za odobritev

Proračunski ovoji: dajte vsaki nalogi omejitev porabe in časovne omejitve orodij

Sintetično spremljanje: načrtovane naloge preverjajo zdravje agenta in RPC povezljivost

Primeri scenarijev iz resničnega sveta

Robot za napitnine skupnosti: Uporabniki omenijo robota na X; agent napitnine preverjenim denarnicam na verigi blokov

Nagrade za stranke: Agent sledi onchain dejanjem in pošilja nagradne žetone tedensko

DAO operacije: Agent pripravi Safe transakcije za predloge; multisig podpiše po pregledu

Pomočnik na tržnici: Agent navede NFT-je in odgovarja na uporabniška vprašanja, izvaja posle po potrditvi

Za vodeno gradnjo Web3 agenta si oglejte QuickNode vadnico in Coinbaseovo delavnico, ki vas vodi skozi Agents SDK + AgentKit integracijo.

Odpravljanje težav: Hitre rešitve

Moj agent ne more poslati transakcij: Preverite omrežje, nastavitve plina in dovoljenja ključev; najprej poskusite s testnim omrežjem

Klici orodij so nestabilni: Poostrite sheme orodij in validacijo; dodajte pozive za predhodno preverjanje

Izvajanja so nestanovitna: Dodajte ponovne poskuse z odmikom; spremljajte omejitve hitrosti RPC in kode stanja

Varnostni pomisleki: Zasukajte ključe, osamite sredstva, premaknite se na odobritve na podlagi Safe

Mimogrede: Pospešite svoj potek dela s Sider.AI

Omeniti velja – če ponavljate pozive, lepilo kodo in dokumente, vam lahko pomaga pomočnik. S Sider.AI lahko raziskave, izrezke kode in dnevnike poskusov organizirate ob svojem urejevalniku, kar pospeši zanke gradnje-merjenja-učenja za agente. Raziščite ga tukaj:

Ključne ugotovitve

»AgentKit« se običajno nanaša na Coinbaseov onchain nabor orodij in Inngestov orkestracijski nabor – izberite glede na vašo potrebo po onchain dejanjih v primerjavi z usklajevanjem več agentov.

Začnite majhno: testno omrežje, minimalna orodja, strogi pravilniki; zmogljivosti dodajajte postopoma.

Za finančno ali administrativno avtoriteto integrirajte Safe za upravljanje in varnost.

Z agentom ravnajte kot s produkcijsko programsko opremo: beleženje, opozorila, omejitve in človeška odobritev.

Nadaljnje učenje

Coinbase AgentKit hiter začetek in CLI

Delavnica: OpenAI Agents SDK s Coinbase AgentKit

Gradnja Web3 AI agenta (QuickNode)

Inngest AgentKit hiter začetek in koncepti

Safe Protocol Kit za varne pametne račune

Pogosta vprašanja

V1: Kaj je AgentKit in katerega naj uporabim? AgentKit se običajno nanaša na Coinbase AgentKit za onchain dejanja in Inngest AgentKit za orkestriranje agentov. Izberite Coinbase za Web3 naloge (denarnice, žetoni) in Inngest za poteke dela z več agenti, ki jih poganjajo dogodki.

V2: Kako lahko varno dovolim AI agentu, da premika sredstva na verigi blokov? Uporabite majhna stanja, stroge sheme orodij in pozive za potrditev za tvegana dejanja. Za proizvodnjo integrirajte Safe pametne račune in zahtevajte multisig ali odobritve pravilnika.

V3: Ali lahko kombiniram OpenAI Agents s Coinbase AgentKit? Da. Povežite svojo plast sklepanja (OpenAI Agents/klicanje funkcij) z orodji Coinbase AgentKit. Mnogi razvijalci dodajo tudi Inngest za orkestracijo in ponovne poskuse.

V4: Katere so pogoste pasti pri uporabi AgentKit? Trdo kodiranje ključev, preskakovanje testnih omrežij in dovoljevanje neomejenih dejanj so glavne. Dodajte omejitve hitrosti, omejitve porabe in robustno opazovalnost, da ostanete varni.

V5: Kje lahko najdem hiter začetek za gradnjo Web3 AI agenta? Začnite s Coinbaseovim hitrim začetkom AgentKit za nastavitev in primere, plus vadnice iz QuickNode in video posnetke delavnic za celovito vodstvo.