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 koristiti AgentKit: Praktični vodič od početka do kraja za izradu AI agenata

Ako ste čuli za 'AgentKit' i pitali se kako ga zapravo upotrijebiti, na pravom ste mjestu. U čemu je stvar: AgentKit nije jedan proizvod. Naziv se koristi za više ekosustava—ponajviše Coinbaseov AgentKit za onchain/Web3 radnje, Inngestov AgentKit za orkestriranje mreža agenata i razne tutorijale koji koriste OpenAI Agents SDK uz Coinbaseov komplet. Ovaj vodič objašnjava što je svaki AgentKit, zašto biste odabrali jedan umjesto drugog i kako ga postaviti korak po korak, uz profesionalne savjete i obrasce iz stvarnog svijeta koje možete ponovno upotrijebiti.

Prilazimo praktično i usmjereno na rješenja: brze usporedbe, jasno postavljanje, primjeri koji se mogu pokrenuti i zamke koje treba izbjegavati.

O kojem 'AgentKitu' govorite?

Coinbase AgentKit (CDP/Onchain): Omogućuje AI agentima upravljanje novčanicima, slanje onchain transakcija, implementaciju tokena i još mnogo toga u podržanim mrežama. Idealan je za izradu Web3-nativnih agenata (npr. botova za napojnice, deployera tokena, distributera NFT-ova). Vodiči za brzi početak i radionice su široko dostupni.

Inngest AgentKit: Okvir za definiranje agenata, alata i njihovo pokretanje unutar mreže, usmjeren na skalabilno izvršavanje temeljeno na događajima. Odličan je za orkestriranje više agenata, logiku ponovnog pokušaja i pozadinske tijekove rada.

Safe/Protocol Kits (kontekst): Ako vaš agent treba pametnu kontrolu računa (multisig, pravila, paketne pozive), Safeov Protocol Kit često se uparuje s onchain agentima za sigurno izvršavanje.

Ako vam je cilj brzo izraditi onchain AI agenta, počnite s Coinbase AgentKitom. Ako vam je potrebna robusna arhitektura s više agenata i raspoređivanje, Inngest AgentKit je snažan izbor. Mnogi timovi kombiniraju oboje: OpenAI Agents za zaključivanje + Coinbase AgentKit za onchain radnje + Inngest za orkestraciju.

: Vodič za brzu odluku

Želite Web3 agenta koji može premještati sredstva, implementirati tokene ili komunicirati s dapps → Koristite Coinbase AgentKit.

Potreban vam je trajan sustav pokretan događajima koji orkestrira više agenata/alata s ponovnim pokušajima i stanjem → Koristite Inngest AgentKit.

Za svog agenta trebate sigurnost novčanika poslovne razine ili multisig upravljanje → Integrirajte Safeov Protocol Kit uz svog agenta.

1. dio: Kako koristiti Coinbase AgentKit (Onchain agenti)

Zašto Coinbase AgentKit

Izgrađen za onchain zadatke odmah iz kutije (operacije novčanika, prijenosi, upravljanje tokenima)

Čisto iskustvo programera i alati za brzi početak

Idealan za botove/agente koji komuniciraju s korisnicima na društvenim mrežama (npr. X) i rješavaju radnje onchain

Pregled postavljanja

Instalirajte CLI i SDK (prema brzom početku) i konfigurirajte varijable okruženja za mrežu, ključeve i RPC krajnje točke.

Inicijalizirajte projekt i odaberite onchain mogućnosti koje su vam potrebne.

Povežite alate (npr. operacije novčanika, implementacija tokena) sa svojim agentom.

Povežite agenta s modelom zaključivanja (OpenAI ili slično) kako biste odlučili kada pozvati alate.

Slijedite službeni brzi početak da biste počeli raditi za nekoliko minuta. Za praktični vodič o izradi Web3 AI agenta koji upravlja novčanicima i komunicira na Twitteru/X, pogledajte QuickNode walkthrough i video demonstraciju o stvaranju AgentKit Twitter bota.

Primjer arhitekture

Sloj zaključivanja: LLM s pozivanjem funkcija/alata

Sloj radnji: Coinbase AgentKit alati (prijenos, implementacija tokena)

Upornost: Pohranite memoriju/ciljeve agenta u bazu podataka

Prednji dio: Chat UI ili društveni bot (X) za korisničke upite

Najbolje prakse

Načelo najmanje privilegije: ograničite ključeve agenta na potrebne opsege i male iznose

Pravila: definirajte eksplicitna pravila o tome kada su dopuštene onchain radnje

Zaštitne ograde: implementirajte pregled/potvrdu transakcija, ograničenja po vremenskom razdoblju

Mogućnost promatranja: zabilježite pozive alata, transakcije i izlaze modela radi revizije

Uobičajene zamke

Labavo upravljanje ključevima: nikada nemojte tvrdo kodirati tajne; koristite trezor

Neograničene radnje: zahtijevajte potvrde za prijenose velike vrijednosti

Nedostajuća ograničenja brzine: zaštitite RPC krajnje točke i društvene API-je

2. dio: Kako koristiti Inngest AgentKit (Mreže agenata i orkestracija)

Zašto Inngest AgentKit

Agenti kao prvoklasni, beskontaktni radnici s ciljevima i skupovima alata

Mreže za koordinaciju više agenata za složene tijekove rada

Dizajn pokretan događajima s ponovnim pokušajima i trajnim izvršavanjem

Započnite s brzim početkom da biste pokrenuli svog prvog agenta i pokrenuli ga unutar mreže. Pročitajte osnovne koncepte—agente, alate, mreže—prije ožičenja poslovne logike.

Koraci postavljanja

Definirajte cilj svog agenta i dostupne alate (API-je, interne usluge, onchain komplete).

Stvorite mrežu i registrirajte agente.

Emitirajte događaje za pokretanje agenata; koristite ponovne pokušaje i povlačenje za otpornost.

Dodajte mogućnost promatranja: zapisnike, tragove, ishode.

Obrasci orkestracije

Nadzornik-radnik: agent planiranja delegira zadatke specijalističkim agentima

Izvor događaja: promjene stanja pokreću agente da reagiraju (npr. payment_received → fulfillment_agent)

Čovjek u petlji: odobrenja za rizične radnje, s pauzom/nastavkom

Savjeti

Neka agenti budu bez stanja; prosljeđujte kontekst putem događaja/pohrana stanja

Verzirajte alate i upite za praćenje performansi tijekom vremena

Simulirajte načine kvara; provjerite idempotenciju za vanjske pozive

3. dio: Sigurno izvršavanje sa Safeom (nije obavezno, ali se preporučuje)

Ako vaš agent upravlja sredstvima ili izvršava administratorske operacije, integrirajte pametne račune s upravljanjem. Safeov Protocol Kit pruža stvaranje, konfiguraciju i izvršavanje za pametne račune i multisig tijekove.

Slučaj upotrebe: Onchain agent šalje transakcije, dok vlasnici (ljudi ili agenti nadzornici) supotpisuju

Prednost: Kontrole pravila, ograničenja potrošnje i siguran oporavak

Obrazac: Agent predlaže transakcije; mehanizam pravila (ili čovjek) potpisuje i izvršava

Korak po korak: Izrada minimalnog Onchain agenta

U nastavku je konceptualni tijek koji možete prilagoditi (neovisan o jeziku, u stilu pseudokoda). Pogledajte Coinbase brzi početak za radni kod i CLI naredbe.

Inicijalizirajte projekt i instalirajte ovisnosti

Stvorite direktorij projekta i instalirajte AgentKit SDK i svog LLM klijenta

Postavite varijable okruženja: RPC URL, privatni ključ ili upravljani novčanik, mreža

Definirajte alate i mogućnosti

Novčanik: get_balance, transfer(to, amount)

Tokeni: deploy_erc20(name, symbol, supply)

Čitajte/pišite pozive ugovora prema potrebi

Povežite model zaključivanja

Navedite sistemski upit koji definira ciljeve i ograničenja

Registrirajte alate sa shemama za sigurno pozivanje funkcija

Dodajte sigurnost i pravila

Provedite potvrdu za prijenose iznad praga

Ograničite dnevnu potrošnju, dopustite adrese primatelja za proizvodnju

Isporucite osnovno sučelje

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

Web/Chat: minimalno sučelje za slanje zadataka i prikaz potvrda

Prvo testirajte na testnoj mreži

Dohvatite sredstva iz slavine; provjerite zapisnike radnji i hashove transakcija

Prijeđite u proizvodnju s mogućnošću promatranja

Snimite telemetriju, upozorenja o neuspjelim transakcijama i odstupanja u ponašanju modela

Obrasci koji rade u proizvodnji

Planiraj-pa-djeluj: koristite model za ocrtavanje koraka prije pozivanja alata

Način rada suhog pokretanja: pregledajte transakcije i zatražite odobrenje

Proračunski omotnice: dajte svakom zadatku ograničenje potrošnje i vremenska ograničenja alata

Sintetičko praćenje: zakazani zadaci provjeravaju zdravlje agenta i RPC povezanost

Primjeri scenarija iz stvarnog svijeta

Bot za napojnice zajednice: Korisnici spominju bota na X; agent daje napojnice provjerenim novčanicima onchain

Nagrade za kupce: Agent prati onchain radnje i šalje nagradne tokene tjedno

DAO operacije: Agent izrađuje Safe transakcije za prijedloge; multisig potpisuje nakon pregleda

Pomoćnik za tržište: Agent navodi NFT-ove i odgovara na pitanja korisnika, izvršavajući trgovine nakon potvrde

Za vođenu izradu Web3 agenta pogledajte QuickNode tutorial i Coinbaseovu radionicu koja prolazi kroz integraciju Agents SDK + AgentKit.

Rješavanje problema: Brzi popravci

Moj agent ne može slati transakcije: Provjerite mrežu, postavke plina i dozvole ključa; prvo isprobajte testnu mrežu

Pozivi alata su nestabilni: Pooštrite sheme alata i provjeru valjanosti; dodajte upite za predprovjeru

Pokretanja su nestabilna: Dodajte ponovne pokušaje s povlačenjem; pratite RPC ograničenja brzine i kodove statusa

Sigurnosni problemi: Rotirajte ključeve, stavite sredstva u karantenu, prijeđite na odobrenja temeljena na Safeu

Usput: Ubrzajte svoj tijek rada uz Sider.AI

Vrijedno je napomenuti—ako ponavljate upite, kod za povezivanje i dokumente, pomoćnik može pomoći. Uz Sider.AI možete držati istraživanje, isječke koda i zapisnike eksperimenata organiziranima uz svoj uređivač, ubrzavajući petlje izrade-mjerenja-učenja za agente. Istražite ga ovdje:

Ključni zaključci

'AgentKit' se obično odnosi na Coinbaseov onchain alatni komplet i Inngestov komplet za orkestraciju—odaberite na temelju vaše potrebe za onchain radnjama u odnosu na koordinaciju više agenata.

Počnite s malim: testna mreža, minimalni alati, stroga pravila; dodajte mogućnosti postupno.

Za financijsku ili administrativnu ovlast integrirajte Safe za upravljanje i sigurnost.

Tretirajte agenta kao produkcijski softver: zapisivanje, upozorenja, ograničenja i ljudsko odobrenje.

Daljnje učenje

Coinbase AgentKit brzi početak i CLI

Radionica: OpenAI Agents SDK s Coinbase AgentKitom

Izradite Web3 AI agent walkthrough (QuickNode)

Inngest AgentKit brzi početak i koncepti

Safe Protocol Kit za sigurne pametne račune

FAQ

P1:Što je AgentKit i koji bih trebao koristiti? AgentKit se obično odnosi na Coinbase AgentKit za onchain radnje i Inngest AgentKit za orkestriranje agenata. Odaberite Coinbase za Web3 zadatke (novčanike, tokene) i Inngest za tijekove rada s više agenata, pokretane događajima.

P2:Kako mogu sigurno dopustiti AI agentu da premješta sredstva onchain? Koristite male iznose, stroge sheme alata i upite za potvrdu za rizične radnje. Za proizvodnju integrirajte Safe pametne račune i zahtijevajte multisig ili odobrenja pravila.

P3:Mogu li kombinirati OpenAI Agents s Coinbase AgentKitom? Da. Povežite svoj sloj zaključivanja (OpenAI Agents/pozivanje funkcija) s Coinbase AgentKit alatima. Mnogi programeri također dodaju Inngest za orkestraciju i ponovne pokušaje.

P4:Koje su uobičajene zamke pri korištenju AgentKita? Tvrdo kodiranje ključeva, preskakanje testnih mreža i dopuštanje neograničenih radnji su najveće. Dodajte ograničenja brzine, ograničenja potrošnje i robusnu mogućnost promatranja kako biste ostali sigurni.

P5:Gdje mogu pronaći brzi početak za izradu Web3 AI agenta? Započnite s Coinbaseovim AgentKit brzim početkom za postavljanje i primjere, plus tutorijale s QuickNodea i videozapise radionica za cjelovito vodstvo.