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.

Com utilitzar AgentKit: Una guia pràctica i integral per a la creació d'agents d'IA

Si has sentit a parlar d'"AgentKit" i t'has preguntat com posar-lo en pràctica, has arribat al lloc correcte. Aquí hi ha el truc: AgentKit no és un producte únic. El nom és utilitzat per múltiples ecosistemes, sobretot l'AgentKit de Coinbase per a accions onchain/Web3, l'AgentKit d'Inngest per a l'orquestració de xarxes d'agents i diversos tutorials que utilitzen l'OpenAI Agents SDK juntament amb el kit de Coinbase. Aquesta guia desempaqueta què és cada AgentKit, per què triaries un per sobre d'un altre i com configurar-lo pas a pas, amb consells professionals i patrons del món real que pots reutilitzar.

Adoptarem un enfocament pràctic i orientat a la solució: comparacions ràpides, configuració clara, exemples executables i trampes que cal evitar.

De quin "AgentKit" estàs parlant?

Coinbase AgentKit (CDP/Onchain): Permet als agents d'IA gestionar carteres, enviar transaccions onchain, desplegar tokens i més a través de xarxes compatibles. Ideal per a la construcció d'agents natius de Web3 (per exemple, bots de propines, desplegadors de tokens, distribuïdors de NFT). Hi ha guies d'inici ràpid i tallers disponibles àmpliament.

Inngest AgentKit: Un marc per definir agents, eines i executar-los dins d'una xarxa, centrat en l'execució escalable i basada en esdeveniments.

Kits segurs/de protocols (context): Si el teu agent necessita control de comptes intel·ligents (multisig, política, crides per lots), el Kit de protocols de Safe sovint es combina amb agents onchain per a una execució segura.

Si el teu objectiu és construir un agent d'IA onchain ràpidament, comença amb Coinbase AgentKit. Si necessites una arquitectura robusta i multiagent i una programació, Inngest AgentKit és una opció sòlida. Molts equips combinen ambdós: OpenAI Agents per al raonament + Coinbase AgentKit per a accions onchain + Inngest per a l'orquestració.

: Guia de decisió ràpida

Vols un agent Web3 que pugui moure fons, desplegar tokens o interactuar amb dapps → Utilitza Coinbase AgentKit.

Necessites un sistema durador i basat en esdeveniments que orquestri múltiples agents/eines amb intents repetits i estat → Utilitza Inngest AgentKit.

Necessites seguretat de cartera de nivell empresarial o governança multisig per al teu agent → Integra el Kit de protocols de Safe juntament amb el teu agent.

Part 1: Com utilitzar Coinbase AgentKit (agents onchain)

Per què Coinbase AgentKit

Creat per a tasques onchain fora de la caixa (operacions de cartera, transferències, gestió de tokens)

Experiència de desenvolupador neta i eines d'inici ràpid

Ideal per a bots/agents que interactuen amb els usuaris a les xarxes socials (per exemple, X) i resolen accions onchain

Visió general de la configuració

Instal·la la CLI i el SDK (segons l'inici ràpid) i configura les variables d'entorn per a la xarxa, les claus i els punts finals RPC.

Inicialitza un projecte i tria les capacitats onchain que necessites.

Vincula eines (per exemple, operacions de cartera, desplegament de tokens) al teu agent.

Connecta l'agent a un model de raonament (OpenAI o similar) per decidir quan trucar a les eines.

Segueix l'inici ràpid oficial per posar-te en marxa en minuts. Per a un tutorial pràctic sobre la construcció d'un agent d'IA Web3 que gestiona carteres i interactua a Twitter/X, consulta el tutorial de QuickNode i una demostració en vídeo sobre la creació d'un bot d'AgentKit per a Twitter.

Arquitectura d'exemple

Capa de raonament: LLM amb crida de funció/eina

Capa d'acció: Eines de Coinbase AgentKit (transferència, desplegament de tokens)

Persistència: Emmagatzema la memòria/objectius de l'agent en una base de dades

Front end: IU de xat o bot social (X) per a indicacions de l'usuari

Millors pràctiques

Principi del mínim privilegi: restringeix les claus de l'agent als àmbits necessaris i als petits saldos

Indicacions de política: defineix regles explícites sobre quan es permeten les accions onchain

Barreres de protecció: implementa la previsualització/confirmació de transaccions, els límits per finestra de temps

Observabilitat: registra les trucades d'eines, les transaccions i les sortides del model per a la capacitat d'auditoria

Trampes comunes

Gestió de claus laxa: mai codifiquis secrets; utilitza un magatzem

Accions sense límits: requereix confirmacions per a transferències de gran valor

Límits de velocitat que falten: protegeix els punts finals RPC i les API socials

Part 2: Com utilitzar Inngest AgentKit (xarxes d'agents i orquestració)

Per què Inngest AgentKit

Agents com a treballadors sense estat de primera classe amb objectius i conjunts d'eines

Xarxes per coordinar múltiples agents per a fluxos de treball complexos

Disseny basat en esdeveniments amb intents repetits i execució duradora

Comença amb l'inici ràpid per posar en marxa el teu primer agent i executar-lo dins d'una xarxa. Llegeix els conceptes bàsics (agents, eines, xarxes) abans de connectar la lògica empresarial.

Passos de configuració

Defineix l'objectiu del teu agent i les eines disponibles (API, serveis interns, kits onchain).

Crea una xarxa i registra agents.

Emet esdeveniments per activar agents; utilitza intents repetits i retrocés per a la resiliència.

Afegeix observabilitat: registres, traces, resultats.

Patrons d'orquestració

Supervisor-treballador: un agent planificador delega tasques a agents especialistes

Event-sourcing: els canvis d'estat activen agents per reaccionar (per exemple, payment_received → fulfillment_agent)

Humà-en-el-bucle: aprovacions per a accions arriscades, amb pausa/represa

Consells

Mantén els agents sense estat; passa el context mitjançant esdeveniments/magatzems d'estat

Eines de versió i indicacions per fer un seguiment del rendiment al llarg del temps

Simula modes de fallada; verifica la idempotència per a trucades externes

Part 3: Execució segura amb Safe (opcional però recomanable)

Si el teu agent gestiona fons o executa operacions d'administració, integra comptes intel·ligents amb governança. El Kit de protocols de Safe proporciona creació, configuració i execució per a comptes intel·ligents i fluxos multisig.

Cas d'ús: un agent onchain envia transaccions, mentre que els propietaris (humans o agents supervisors) co-signen

Benefici: controls de política, límits de despesa i recuperació segura

Patró: l'agent proposa transaccions; un motor de polítiques (o humà) signa i executa

Pas a pas: creació d'un agent onchain mínim

A continuació, es mostra un flux conceptual que pots adaptar (agnòstic del llenguatge, estil de pseudocodi). Consulta l'inici ràpid de Coinbase per obtenir codi de treball i ordres de la CLI.

Inicialitza el projecte i instal·la les dependències

Crea un directori de projecte i instal·la el SDK d'AgentKit i el teu client LLM

Estableix les variables d'entorn: URL RPC, clau privada o cartera gestionada, xarxa

Defineix eines i capacitats

Cartera: get_balance, transfer(to, amount)

Tokens: deploy_erc20(name, symbol, supply)

Trucades de contracte de lectura/escriptura segons sigui necessari

Connecta el model de raonament

Proporciona una indicació del sistema que defineix objectius i restriccions

Registra eines amb esquemes per a trucades de funció segures

Afegeix seguretat i polítiques

Aplica la confirmació per a les transferències per sobre del llindar

Limita la despesa diària, permet l'adreça del destinatari per a la producció

Envia una interfície bàsica

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

Web/Xat: IU mínima per enviar tasques i mostrar rebuts

Prova primer en una testnet

Fons de l'aixeta; verifica els registres d'accions i els hash de transaccions

Mou-te a la producció amb observabilitat

Captura la telemetria, les alertes sobre transaccions fallides i la deriva en el comportament del model

Patrons que funcionen en producció

Planifica i després actua: utilitza el model per descriure els passos abans d'invocar eines

Mode de prova: previsualitza les transaccions i demana aprovació

Sobres de pressupost: dóna a cada tasca un límit de despesa i temps d'espera d'eines

Monitoratge sintètic: les tasques programades validen l'estat de l'agent i la connectivitat RPC

Escenaris d'exemple del món real

Bot de propines de la comunitat: els usuaris mencionen el bot a X; l'agent dóna propines a carteres verificades onchain

Recompenses per als clients: l'agent fa un seguiment de les accions onchain i envia tokens de recompensa setmanalment

Operacions DAO: l'agent redacta transaccions segures per a propostes; multisig signa després de la revisió

Assistent de mercat: l'agent enumera els NFT i respon a les preguntes dels usuaris, executant intercanvis després de la confirmació

Per a una construcció guiada d'agents Web3, consulta el tutorial de QuickNode i el taller de Coinbase que explica la integració d'Agents SDK + AgentKit.

Resolució de problemes: solucions ràpides

El meu agent no pot enviar transaccions: comprova la xarxa, la configuració del gas i els permisos de la clau; prova primer una testnet

Les trucades d'eines són erràtiques: reforça els esquemes i la validació de l'eina; afegeix indicacions de comprovació prèvia

Les execucions són inconsistents: afegeix intents repetits amb retrocés; supervisa els límits de velocitat i els codis d'estat de RPC

Problemes de seguretat: rota les claus, posa en quarantena els fons, passa a aprovacions basades en Safe

Per cert: accelera el teu flux de treball amb Sider.AI

Val la pena assenyalar: si estàs iterant en indicacions, codi d'enganxament i documents, un company pot ajudar. Amb Sider.AI, pots mantenir la investigació, els fragments de codi i els registres d'experiments organitzats al costat del teu editor, accelerant els bucles de construcció-mesura-aprenentatge per als agents. Explora-ho aquí:

Principals conclusions

"AgentKit" es refereix normalment al conjunt d'eines onchain de Coinbase i al kit d'orquestració d'Inngest: tria en funció de la teva necessitat d'accions onchain vs. coordinació multiagent.

Comença petit: testnet, eines mínimes, polítiques estrictes; afegeix capacitats gradualment.

Per a autoritat financera o administrativa, integra Safe per a la governança i la seguretat.

Tracta l'agent com a programari de producció: registre, alertes, límits i aprovació humana.

Més informació

Inici ràpid i CLI de Coinbase AgentKit

Taller: OpenAI Agents SDK amb Coinbase AgentKit

Crea un tutorial d'agent d'IA Web3 (QuickNode)

Inici ràpid i conceptes d'Inngest AgentKit,

Kit de protocols segurs per a comptes intel·ligents segurs

Preguntes freqüents

Q1: Què és AgentKit i quin hauria d'utilitzar? AgentKit es refereix normalment a Coinbase AgentKit per a accions onchain i Inngest AgentKit per a l'orquestració d'agents. Trieu Coinbase per a tasques Web3 (carteres, tokens) i Inngest per a fluxos de treball multiagent i basats en esdeveniments.

Q2: Com puc permetre de manera segura que un agent d'IA mogui fons onchain? Utilitzeu petits saldos, esquemes d'eines estrictes i indicacions de confirmació per a accions arriscades. Per a la producció, integreu comptes intel·ligents segurs i requereix aprovacions multisig o de política.

Q3: Puc combinar OpenAI Agents amb Coinbase AgentKit? Sí. Connecta la teva capa de raonament (OpenAI Agents/trucada de funció) a les eines de Coinbase AgentKit. Molts desenvolupadors també afegeixen Inngest per a l'orquestració i els intents repetits.

Q4: Quines són les trampes comunes en utilitzar AgentKit? Codificar claus, ometre testnets i permetre accions sense límits són les més importants. Afegeix límits de velocitat, límits de despesa i una observabilitat robusta per mantenir-te segur.

Q5: On puc trobar un inici ràpid per crear un agent d'IA Web3? Comença amb l'inici ràpid d'AgentKit de Coinbase per a la configuració i els exemples, a més dels tutorials de QuickNode i els vídeos del taller per obtenir orientació d'extrem a extrem.