Comment utiliser SQD pour alimenter vos agents IA Eliza : guide pratique 2025

Dans un monde où l'intelligence artificielle révolutionne chaque jour notre façon d'interagir avec les données, les agents IA autonomes deviennent progressivement les acteurs principaux de l'économie blockchain. En 2025, ces agents ne se contentent plus d'exécuter des tâches simples - ils analysent les marchés, effectuent des transactions et gèrent la liquidité avec une précision remarquable. Pour fonctionner efficacement, ces agents ont besoin d'accéder à des données structurées et contextualisées. C'est exactement ce que propose SQD avec son nouveau plugin pour ElizaOS.

Dans cet article, nous allons explorer comment utiliser le plugin SQD pour ElizaOS afin de créer des agents IA capables d'interagir avec les données blockchain de manière naturelle et intuitive. Nous verrons comment transformer un simple outil en ligne de commande en un assistant conversationnel puissant, capable d'extraire et d'analyser des données on-chain à la demande.

Qu'est-ce que SQD et pourquoi l'utiliser avec Eliza ?

SQD est une plateforme spécialisée dans l'extraction et l'analyse de données blockchain. Son plugin pour ElizaOS permet d'intégrer ces capacités directement dans des agents IA conversationnels. Mais avant d'entrer dans les détails techniques, comprenons pourquoi cette combinaison est si puissante.

ElizaOS est un framework qui permet de créer des agents IA conversationnels avancés. Le système s'étend via des plugins qui ajoutent des fonctionnalités spécifiques. Le plugin SQD apporte deux composants essentiels :

• Providers : Ils fournissent un flux continu de données à chaque cycle d'interaction de l'agent
• Actions : Des outils que l'agent peut invoquer à la demande pour effectuer des tâches spécifiques

Avec le plugin SQD, votre agent Eliza peut accéder à deux types de données essentielles de la blockchain :

1. Les transferts de tokens ERC20
2. Les événements de swap décodés sur Uniswap

Ces données peuvent être non seulement consultées mais aussi exportées dans différents formats (JSON, CSV, Parquet), ce qui facilite leur utilisation dans d'autres outils d'analyse ou processus automatisés.

Création d'un agent Cryo conversationnel avec SQD

Dans cette section, nous allons créer un agent IA qui fonctionne comme une version conversationnelle de Cryo, un outil en ligne de commande populaire pour l'extraction de données blockchain. Notre agent pourra extraire des transferts ERC20 et des événements de swap Uniswap, filtrer par adresse et plage de blocs, puis exporter les résultats dans différents formats.

Configuration de l'environnement

Commençons par configurer notre environnement de développement :

1. Clonez le fork SQD d'ElizaOS pour accéder aux dernières mises à jour :

git clone https://github.com/subsquid-labs/eliza.git

2. Configurez votre fichier d'environnement :

# Créez un fichier .env à partir de l'exemple
cp .env.example .env

# Installez les dépendances
pnpm install

Pour ce tutoriel, nous utiliserons OpenAI comme fournisseur de LLM, mais vous pouvez choisir celui qui vous convient. Si vous n'utilisez pas OpenAI, assurez-vous de définir USE_OPENAI_EMBEDDING=false dans votre fichier .env.

Ajoutez votre clé API OpenAI dans le fichier .env :

# Fichier .env
OPENAI_API_KEY=sk-***-***...

Actuellement, le plugin SQD ne prend en charge qu'une seule chaîne à la fois. Vous devez donc spécifier l'URL du portail et l'URL RPC pour la chaîne souhaitée. Dans notre exemple, nous utiliserons Arbitrum :

SQD_PORTAL_URL=https://portal.sqd.dev/datasets/arbitrum-one
# Utilisé pour récupérer les informations de base sur les tokens comme les décimales et le symbole
SQD_RPC_URL=https://arbitrum.llamarpc.com

Création du personnage de l'agent

Maintenant, créons un fichier de personnage pour notre agent Cryo :

touch characters/cryo.character.json

Dans ce fichier, nous définirons les caractéristiques de notre agent, y compris ses capacités et son comportement. Un élément crucial est la section où nous spécifions les plugins disponibles, notamment le plugin SQD :

{
  ...
  "plugins": ["@elizaos/plugin-sqd"]
  ...
}

Vous pouvez copier le fichier de personnage complet depuis ce lien pour gagner du temps.

Démarrage et test de l'agent

Une fois que tout est configuré, démarrons notre agent :

pnpm run dev --characters="characters/cryo.character.json"

Accédez à http://localhost:5173 depuis votre navigateur et sélectionnez le personnage Cryo.

Comment fonctionne le plugin SQD en arrière-plan

Le plugin SQD utilise une fonctionnalité à venir du SDK SQD 2.0 appelée "flux sans état" (stateless streams). Cette technologie permet d'extraire un grand volume de données on-chain en une seule requête, sans nécessiter d'indexeur. Les données sont diffusées directement depuis le réseau SQD vers votre agent.

Lorsque vous utilisez les providers SQD, vous définissez statiquement les paramètres d'extraction (adresse du contrat, plages de blocs, adresses d'expéditeur, etc.). Ces providers s'exécutent à chaque cycle de l'agent, enrichissant son contexte avec les dernières données disponibles.

En revanche, les actions SQD sont invoquées uniquement lorsque l'agent en a besoin. L'agent analyse le prompt de l'utilisateur pour extraire les paramètres nécessaires, comme les adresses de contrat ou les plages de blocs, puis exécute la requête correspondante. Ces actions peuvent également exporter les données extraites dans différents formats.

Améliorations possibles pour votre agent Cryo

Notre version conversationnelle de Cryo n'est qu'un point de départ. Voici quelques améliorations que vous pourriez envisager pour rendre votre agent encore plus puissant :

• Support multi-chaînes : Permettre à l'agent d'interroger plusieurs chaînes dans une seule requête
• Support multi-contrats : Extraire des données de plusieurs contrats en parallèle
• Amélioration de l'expérience utilisateur : Accepter les symboles de tokens (comme "WETH") au lieu d'exiger les adresses de contrat
• Expansion des ensembles de données : Ajouter la prise en charge d'autres types d'événements décodés
• Visualisation des données : Intégrer des capacités de visualisation pour les données extraites

Cas d'utilisation pratiques pour les agents alimentés par SQD

Les agents IA alimentés par SQD peuvent être utilisés dans divers scénarios :

1. Analyse de marché en temps réel

Créez un agent qui surveille les mouvements de tokens spécifiques et alerte sur des transactions importantes ou des modèles suspects. Par exemple, vous pourriez demander : "Alerte-moi si plus de 1 million de USDC sont transférés depuis cette adresse dans les prochaines 24 heures."

2. Recherche d'opportunités d'arbitrage

Développez un agent qui analyse les swaps Uniswap sur différentes paires de trading pour identifier des opportunités d'arbitrage. L'agent pourrait comparer les prix entre différents pools et suggérer des transactions potentiellement rentables.

3. Audit de portefeuille

Construisez un assistant qui aide les utilisateurs à comprendre l'historique de leurs transactions. Les utilisateurs pourraient demander : "Montre-moi tous mes transferts de WETH au cours des 30 derniers jours et calcule mon gain/perte net."

4. Analyse de protocole DeFi

Créez un agent qui analyse les métriques clés d'un protocole DeFi particulier, comme le volume de trading, la liquidité ou le nombre d'utilisateurs actifs. Cet agent pourrait générer des rapports périodiques ou répondre à des questions spécifiques sur la santé du protocole.

Conclusion

L'intégration de SQD avec ElizaOS ouvre de nouvelles possibilités passionnantes pour les agents IA dans l'écosystème blockchain. En donnant à vos agents la capacité d'accéder et d'analyser des données on-chain en temps réel, vous pouvez créer des assistants conversationnels puissants qui simplifient l'interaction avec la blockchain.

Notre exemple d'agent Cryo n'est qu'un aperçu de ce qui est possible. Avec un peu de créativité et d'expérimentation, vous pouvez développer des agents spécialisés qui répondent à des besoins spécifiques dans l'espace crypto.

Alors que nous entrons dans l'ère des agents autonomes, les outils comme SQD joueront un rôle crucial en fournissant le contexte et les données nécessaires pour prendre des décisions éclairées. L'avenir de l'économie blockchain sera façonné par ces agents intelligents, et ceux qui maîtrisent cette technologie aujourd'hui seront bien positionnés pour réussir demain.

N'hésitez pas à explorer le plugin SQD pour ElizaOS et à partager vos créations avec la communauté. L'innovation dans ce domaine ne fait que commencer, et les possibilités sont infinies.