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.

Comment utiliser AgentKit : Un guide pratique de bout en bout pour la création d'agents d'IA

Si vous avez entendu parler d'"AgentKit" et que vous vous demandez comment le mettre réellement en œuvre, vous êtes au bon endroit. Voici le problème : AgentKit n'est pas un produit unique. Le nom est utilisé par plusieurs écosystèmes, notamment AgentKit de Coinbase pour les actions onchain/Web3, AgentKit de Inngest pour l'orchestration des réseaux d'agents, et divers tutoriels utilisant le SDK OpenAI Agents en parallèle avec le kit de Coinbase. Ce guide explique ce qu'est chaque AgentKit, pourquoi vous choisiriez l'un plutôt que l'autre, et comment le configurer étape par étape, avec des conseils de pro et des modèles du monde réel que vous pouvez réutiliser.

Nous adopterons une approche pratique et axée sur les solutions : comparaisons rapides, configuration claire, exemples exécutables et pièges à éviter.

De quel "AgentKit" parlez-vous ?

Coinbase AgentKit (CDP/Onchain) : Permet aux agents d'IA de gérer des portefeuilles, d'envoyer des transactions onchain, de déployer des tokens, et plus encore sur les réseaux pris en charge. Idéal pour la création d'agents natifs Web3 (par exemple, les bots de pourboire, les déployeurs de tokens, les distributeurs de NFT). Des guides de démarrage rapide et des ateliers sont largement disponibles.

Inngest AgentKit : Un framework pour définir des agents, des outils et les exécuter dans un réseau, axé sur une exécution évolutive et pilotée par les événements. Idéal pour orchestrer plusieurs agents, la logique de réessai et les workflows en arrière-plan.

Kits Safe/Protocol (contexte) : Si votre agent a besoin d'un contrôle de compte intelligent (multisig, politique, appels groupés), le Protocol Kit de Safe est souvent associé à des agents onchain pour une exécution sécurisée.

Si votre objectif est de créer rapidement un agent d'IA onchain, commencez par Coinbase AgentKit. Si vous avez besoin d'une architecture multi-agents robuste et d'une planification, Inngest AgentKit est un excellent choix. De nombreuses équipes combinent les deux : OpenAI Agents pour le raisonnement + Coinbase AgentKit pour les actions onchain + Inngest pour l'orchestration.

: Guide de décision rapide

Vous voulez un agent Web3 qui peut déplacer des fonds, déployer des tokens ou interagir avec des dapps → Utilisez Coinbase AgentKit.

Vous avez besoin d'un système durable, piloté par les événements, qui orchestre plusieurs agents/outils avec des tentatives et un état → Utilisez Inngest AgentKit.

Vous avez besoin d'une sécurité de portefeuille de niveau entreprise ou d'une gouvernance multisig pour votre agent → Intégrez le Protocol Kit de Safe avec votre agent.

Partie 1 : Comment utiliser Coinbase AgentKit (Agents Onchain)

Pourquoi Coinbase AgentKit

Conçu pour les tâches onchain prêtes à l'emploi (opérations de portefeuille, transferts, gestion des tokens)

Expérience de développement propre et outils de démarrage rapide

Idéal pour les bots/agents qui interagissent avec les utilisateurs sur les réseaux sociaux (par exemple, X) et règlent les actions onchain

Aperçu de la configuration

Installez la CLI et le SDK (conformément au démarrage rapide) et configurez les variables d'environnement pour le réseau, les clés et les points de terminaison RPC.

Initialisez un projet et choisissez les capacités onchain dont vous avez besoin.

Liez des outils (par exemple, les opérations de portefeuille, le déploiement de tokens) à votre agent.

Connectez l'agent à un modèle de raisonnement (OpenAI ou similaire) pour décider quand appeler les outils.

Suivez le démarrage rapide officiel pour être opérationnel en quelques minutes. Pour un tutoriel pratique sur la création d'un agent d'IA Web3 qui gère des portefeuilles et interagit sur Twitter/X, consultez la procédure pas à pas de QuickNode et une démonstration vidéo sur la création d'un bot Twitter AgentKit.

Exemple d'architecture

Couche de raisonnement : LLM avec appel de fonction/outil

Couche d'action : Outils Coinbase AgentKit (transfert, déploiement de token)

Persistance : Stocker la mémoire/les objectifs de l'agent dans une base de données

Front end : Interface utilisateur de chat ou bot social (X) pour les invites utilisateur

Meilleures pratiques

Principe du moindre privilège : limitez les clés de l'agent aux portées nécessaires et aux petits soldes

Invites de politique : définissez des règles explicites sur le moment où les actions onchain sont autorisées

Garde-fous : implémentez la prévisualisation/confirmation des transactions, les limites par fenêtre de temps

Observabilité : enregistrez les appels d'outils, les transactions et les sorties de modèles à des fins d'auditabilité

Pièges courants

Gestion laxiste des clés : ne jamais coder en dur les secrets ; utilisez un coffre-fort

Actions illimitées : exigez des confirmations pour les transferts de grande valeur

Limites de débit manquantes : protégez les points de terminaison RPC et les API sociales

Partie 2 : Comment utiliser Inngest AgentKit (Réseaux d'agents et orchestration)

Pourquoi Inngest AgentKit

Agents en tant que workers stateless de première classe avec des objectifs et des ensembles d'outils

Réseaux pour coordonner plusieurs agents pour des workflows complexes

Conception pilotée par les événements avec des tentatives et une exécution durable

Commencez par le démarrage rapide pour lancer votre premier agent et l'exécuter dans un réseau. Lisez les concepts de base (agents, outils, réseaux) avant de câbler la logique métier.

Étapes de configuration

Définissez l'objectif de votre agent et les outils disponibles (API, services internes, kits onchain).

Créez un réseau et enregistrez les agents.

Émettez des événements pour déclencher des agents ; utilisez les tentatives et le backoff pour la résilience.

Ajoutez de l'observabilité : logs, traces, résultats.

Modèles d'orchestration

Superviseur-worker : un agent de planification délègue des tâches à des agents spécialisés

Event-sourcing : les changements d'état déclenchent des agents pour réagir (par exemple, payment_received → fulfillment_agent)

Humain dans la boucle : approbations pour les actions risquées, avec pause/reprise

Conseils

Gardez les agents stateless ; transmettez le contexte via les événements/les magasins d'état

Versionnez les outils et les invites pour suivre les performances au fil du temps

Simulez les modes de défaillance ; vérifiez l'idempotence pour les appels externes

Partie 3 : Exécution sécurisée avec Safe (Facultatif mais recommandé)

Si votre agent gère des fonds ou exécute des opérations d'administration, intégrez des comptes intelligents avec gouvernance. Le Protocol Kit de Safe fournit la création, la configuration et l'exécution pour les comptes intelligents et les flux multisig.

Cas d'utilisation : Un agent onchain soumet des transactions, tandis que les propriétaires (humains ou agents superviseurs) co-signent

Avantage : Contrôles de politique, limites de dépenses et récupération sécurisée

Modèle : L'agent propose des transactions ; un moteur de politique (ou un humain) signe et exécute

Étape par étape : Création d'un agent onchain minimal

Vous trouverez ci-dessous un flux conceptuel que vous pouvez adapter (indépendant du langage, style pseudo-code). Consultez le démarrage rapide de Coinbase pour le code de travail et les commandes CLI.

Initialiser le projet et installer les dépendances

Créez un répertoire de projet et installez le SDK AgentKit et votre client LLM

Définissez les variables d'environnement : URL RPC, clé privée ou portefeuille géré, réseau

Définir les outils et les capacités

Portefeuille : get_balance, transfer(to, amount)

Tokens : deploy_erc20(name, symbol, supply)

Appels de contrat de lecture/écriture selon les besoins

Connecter le modèle de raisonnement

Fournissez une invite système qui définit les objectifs et les contraintes

Enregistrez les outils avec des schémas pour un appel de fonction sécurisé

Ajouter la sécurité et les politiques

Appliquez la confirmation pour les transferts au-dessus du seuil

Limitez les dépenses quotidiennes, autorisez les adresses de destinataire pour la production

Expédier une interface de base

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

Web/Chat : interface utilisateur minimale pour soumettre des tâches et afficher les reçus

Testez d'abord sur un testnet

Financer les fonds du faucet ; vérifiez les journaux d'actions et les hachages de transaction

Passer à la production avec l'observabilité

Capturez la télémétrie, les alertes sur les transactions échouées et la dérive du comportement du modèle

Modèles qui fonctionnent en production

Planifier puis agir : utilisez le modèle pour décrire les étapes avant d'invoquer les outils

Mode Dry-run : prévisualisez les transactions et demandez l'approbation

Enveloppes budgétaires : donnez à chaque tâche un plafond de dépenses et des délais d'attente des outils

Surveillance synthétique : les tâches planifiées valident la santé de l'agent et la connectivité RPC

Exemples de scénarios réels

Bot de pourboire communautaire : Les utilisateurs mentionnent le bot sur X ; l'agent donne des pourboires aux portefeuilles vérifiés onchain

Récompenses client : L'agent suit les actions onchain et envoie des tokens de récompense chaque semaine

Opérations DAO : L'agent rédige des transactions Safe pour les propositions ; multisig signe après examen

Assistant de marketplace : L'agent liste les NFT et répond aux questions des utilisateurs, en exécutant les transactions après confirmation

Pour une création guidée d'agent Web3, consultez le tutoriel QuickNode et l'atelier de Coinbase qui explique l'intégration du SDK Agents + AgentKit.

Dépannage : Corrections rapides

Mon agent ne peut pas envoyer de transactions : Vérifiez le réseau, les paramètres de gaz et les autorisations de clé ; essayez d'abord un testnet

Les appels d'outils sont erratiques : Resserrez les schémas d'outils et la validation ; ajoutez des invites de pré-vérification

Les exécutions sont instables : Ajoutez des tentatives avec backoff ; surveillez les limites de débit RPC et les codes d'état

Problèmes de sécurité : Faites pivoter les clés, mettez les fonds en quarantaine, passez aux approbations basées sur Safe

En passant : Accélérez votre flux de travail avec Sider.AI

Il convient de noter que si vous itérez sur les invites, le code de colle et les documents, un acolyte peut vous aider. Avec Sider.AI, vous pouvez garder la recherche, les extraits de code et les journaux d'expériences organisés à côté de votre éditeur, ce qui accélère les boucles de construction-mesure-apprentissage pour les agents. Explorez-le ici :

Principaux points à retenir

"AgentKit" fait généralement référence à la boîte à outils onchain de Coinbase et au kit d'orchestration de Inngest - choisissez en fonction de vos besoins en matière d'actions onchain par rapport à la coordination multi-agents.

Commencez petit : testnet, outils minimaux, politiques strictes ; ajoutez des capacités progressivement.

Pour l'autorité financière ou administrative, intégrez Safe pour la gouvernance et la sécurité.

Traitez l'agent comme un logiciel de production : journalisation, alertes, limites et approbation humaine.

Pour en savoir plus

Démarrage rapide et CLI de Coinbase AgentKit

Atelier : SDK OpenAI Agents avec Coinbase AgentKit

Créer une procédure pas à pas d'agent d'IA Web3 (QuickNode)

Démarrage rapide et concepts d'Inngest AgentKit,

Safe Protocol Kit pour les comptes intelligents sécurisés

FAQ

Q1 : Qu'est-ce qu'AgentKit et lequel dois-je utiliser ? AgentKit fait généralement référence à Coinbase AgentKit pour les actions onchain et Inngest AgentKit pour l'orchestration des agents. Choisissez Coinbase pour les tâches Web3 (portefeuilles, tokens) et Inngest pour les workflows multi-agents pilotés par les événements.

Q2 : Comment puis-je laisser en toute sécurité un agent d'IA déplacer des fonds onchain ? Utilisez de petits soldes, des schémas d'outils stricts et des invites de confirmation pour les actions risquées. Pour la production, intégrez les comptes intelligents Safe et exigez des approbations multisig ou de politique.

Q3 : Puis-je combiner OpenAI Agents avec Coinbase AgentKit ? Oui. Connectez votre couche de raisonnement (OpenAI Agents/appel de fonction) aux outils Coinbase AgentKit. De nombreux développeurs ajoutent également Inngest pour l'orchestration et les tentatives.

Q4 : Quels sont les pièges courants lors de l'utilisation d'AgentKit ? Le codage en dur des clés, le fait de sauter les testnets et d'autoriser les actions illimitées sont les plus importants. Ajoutez des limites de débit, des plafonds de dépenses et une observabilité robuste pour rester en sécurité.

Q5 : Où puis-je trouver un démarrage rapide pour créer un agent d'IA Web3 ? Commencez par le démarrage rapide d'AgentKit de Coinbase pour la configuration et les exemples, ainsi que les tutoriels de QuickNode et les vidéos d'atelier pour des conseils de bout en bout.