Comment créer un agent IA avec le framework Eliza ?

Objectif du tutoriel

L’objectif de ce tutoriel est de vous apprendre à créer un agent IA autonome capable de publier des posts sur X et d’interagir avec les utilisateurs à travers un chat.

Expert du whitepaper de Bitcoin et possédant un tempérament quelque peu extraverti et un style d’écriture décontracté, l’agent autonome Bitcoin CHAID sera utilisé comme exemple dans ce tutoriel.

Pré-requis

Avant de commencer, vous devez avoir plusieurs outils installés sur votre PC. Notez également qu’une expérience préalable en développement est fortement recommandée pour suivre ce tutoriel.

OS :

• Linux (ou WSL 2 si vous utilisez windows) ;

Logiciels :

Autres :

• Compte X vierge (identifiant, email, mot de passe) ;
• Clé API Anthropic ou OpenAI avec quelques crédits chargés (nécessaire pour la génération textuelle de l’agent IA).

Formez-vous avec Alyra pour intégrer l’écosystème blockchain

Publicité

Installation du framework Eliza

Une fois que tous les outils ont bien été installés, vous pouvez maintenant passer à la mise en place du framework Eliza sur votre PC. Ce tutoriel a été réalisé à partir de WSL 2 sur Windows, mais le procédé est identique sur Linux.

Commandes d’installation

Ouvrez un terminal dans le dossier que vous souhaitez et clonez le répertoire Eliza :

git clone https://github.com/elizaOS/eliza.git

Ensuite, entrez dans le répertoire et vérifiez que vous possédez la dernière version du framework, car le projet est en développement constant ce qui entraîne des mises à jour fréquentes :

cd eliza

git checkout $(git describe --tags --abbrev=0)

Ensuite, vous devez installer les dépendances du projet (cela peut prendre quelques minutes) :

pnpm install --no-frozen-lockfile

Vous pouvez obtenir des erreurs à cette étape. Cependant, ce n’est pas nécessairement problématique pour la suite, car cela peut provenir de packages optionnels, qui ne seront pas utilisés dans notre cas. Si les erreurs que vous obtenez proviennent des plugins, vous pouvez tout de même passer à l’étape suivante.

Enfin, vous pouvez build le projet :

pnpm build

Voilà ! Eliza a bien été installée et configurée sur votre PC, vous pouvez maintenant passer au remplissage des variables d’environnements qui seront nécessaires pour le bon fonctionnement de l’agent.

Troubleshooting

Voici quelques raisons possibles si vous obtenez des erreurs.

Version de Node.js

Vérifiez bien que vous possédez une version de Node.js supérieure à 23. Testez votre version avec la commande :

node --version

Si vous obtenez une erreur, redémarrez votre terminal. Si l’erreur persiste, réinstallez Node.js.

Enfin, si même après réinstallation vous obtenez le nom d’une version autre que 23.x.x, envisagez d’utiliser nvm pour changer la version utilisée par votre OS.

Erreur liée à Sharp

Si vous voyez une erreur en lien avec Sharp, exécuter la commande suivante, puis relancez :

pnpm install --include=optional sharp

Autres erreurs

Si des erreurs persistent, consultez la section Common Issues & Solutions de la documentation officielle d’Eliza.

Configurer les variables d’environnement

Vous devez désormais ajouter les variables d’environnement nécessaires pour que votre agent autonome puisse fonctionner. L’ensemble de ces variables se situe dans le fichier .env.example dans le répertoire racine du projet. Copiez le contenu de ce fichier dans un nouveau fichier nommé .env :

cp .env.example .env

Ensuite, lancez VS Code (vous pouvez simplement exécuter la commande code . à la racine de votre projet) puis ouvrez le fichier .env que vous venez de créer. Ne vous laissez pas intimider par le nombre de variables d’environnement et la taille du fichier, vous n’avez besoin que de remplir quelques lignes pour rendre votre agent fonctionnel.

En effet, votre agent ne nécessite que deux outils externes pour fonctionner : une API pour la génération de texte (OpenAI, Anthropic, etc), et les identifiants d’un compte X.

Commençez par remplir les informations du compte X vierge qui sera utilisé pour publier les tweets de l’agent autonome. Pour cela, retrouvez ces lignes dans le fichier :

Complétez les informations de votre compte X (la variable TWITTER_2FA_SECRET peut être laissée vide si vous n’avez pas mis en place de double ’authentification). Si vous le souhaitez, il est également possible de modifier les délais d’attente entre les posts de l’agent à l’aide des variables situées juste en dessous.

Ensuite, retrouvez les informations relatives à votre fournisseur de clé API. Dans cet exemple, nous avons choisi Anthropic et son modèle claude-3-5-sonnet-20241022. Si vous souhaitez faire de même, vous pouvez donc remplir la variable ANTHROPIC_API_KEY par votre clé API, et les 3 autres variables de modèle (small, medium et large) par claude-3-5-sonnet-20241022.

Remarque : Votre compte Anthropic doit être chargé avec des crédits que vous pouvez acheter directement depuis votre profil (quelques dollars suffisent amplement).

Votre environnement est prêt ! L’agent autonome aura à disposition l’ensemble des outils qui lui sont nécessaires. Passons maintenant à la création de la personnalité de notre agent.

Formez-vous avec Alyra pour intégrer l’écosystème blockchain

Publicité

Créer la personnalité de l’agent IA

La création de la personnalité d’un agent IA est la partie la plus importante dans l’utilisation du framework Eliza. C’est celle-ci qui donnera le caractère de votre agent, sa façon de penser, ses connaissances, son identité.

La personnalité d’un agent est décrite dans un fichier JSON, qui doit obligatoirement posséder certains champs :

• name : le nom de l’agent autonome ;
• modelProvider : le fournisseur de modèle IA (e.g., openai, anthropic, etc) ;
• clients : la liste des applications (e.g. X, Discord, etc) qui sont utilisées ;
• plugins : la liste des plugins qui sont utilisés.

Le reste des champs disponibles pour la création de votre agent sont optionnels, mais vivement recommandés, car ce sont eux qui décrivent sa personnalité.

Vous pouvez retrouver des exemples de personnages dans le dossier characters à partir desquels vous pouvez vous inspirer. De plus, vous pouvez également utiliser un outil développé par la communauté nommé Eliza Character Generator, qui vous permet de générer automatiquement le JSON de votre personnage à partir des informations que vous lui donnez. Pour plus de détails sur la création d’un personnage, n’hésitez pas à consulter la documentation officielle d’Eliza.

Si toutefois vous ne voulez pas créer votre propre personnage, vous pouvez directement prendre le fichier de la personnalité utilisée dans ce tutoriel : Bitcoin CHAiD. Pour ce faire, téléchargez le fichier bitcoinchaid.character.json et placez-le dans le dossier characters de votre projet.

Vous pouvez naviguer à travers le fichier pour comprendre sa structure. Un des éléments notables est le champ knowledge, qui contient l’ensemble des connaissances de l’agent autonome. Ici, le whitepaper de Bitcoin a été inséré et découpé en plusieurs champs.

Voici à quoi devrait ressembler le début de votre fichier :

La personnalité de votre agent IA est enfin prête ! Il ne reste plus qu’à l’exécuter.

Exécuter l’agent IA

Une fois votre projet Eliza configuré et votre personnalité définie dans un fichier character.json, vous pouvez l’exécuter. Pour faire cela, tapez la commande suivante à la racine de votre projet :

pnpm start --characters="characters/bitcoinchaid.character.json"

Cette commande peut prendre quelques minutes, car elle va créer votre agent IA à partir du fichier de sa personnalité. Ces données seront stockées dans sa base de données SQLite située dans data/db.sqlite. Si vous souhaitez éliminer la mémoire de votre agent IA (e.g. ses tweets et interactions avec les utilisateurs), vous pouvez supprimer le fichier db.sqlite. Celui-ci sera recréé automatiquement au lancement de l’agent.

En cas de message d’erreur Exit status 137, cela est dû à un problème de RAM et n’est pas obligatoirement problématique. Relancez simplement la commande, le processus recommencera là ou il s’est arrêté.

Lors de son premier lancement, l’agent IA publie un tweet sur X. Voici un exemple de ce qui pourrait s’afficher dans le terminal lorsque le lancement est terminé.

On constate que notre agent autonome nous informe qu’il a posté un tweet sur le compte X de Bitcoin CHAiD. Il suffit d’aller sur X pour vérifier cela.

Le tweet a bien été posté, votre agent IA fonctionne ! Notez que si vous n’avez pas modifié les variables POST_INTERVAL_MAX et POST_INTERVAL_MIN dans votre fichier .env, l’agent publiera par défaut un tweet toutes les 90 à 180 minutes. Toute modification dans le fichier .env devra inclure un reboot de l’agent pour être effectif.

Formez-vous avec Alyra pour intégrer l’écosystème blockchain

Publicité

Interagir avec son agent IA

Votre agent IA s’exécute et poste régulièrement des tweets ? Il est maintenant temps de savoir comment faire pour interagir avec lui. Dans notre exemple, 2 possibilités existent.

Mentionner l’agent sur X

La première solution pour communiquer avec votre agent est simplement de passer par X. Si vous le mentionnez ou bien répondez à l’une de ses publications, l’agent vous répondra automatiquement (cela peut prendre un certain délai, modifiable à l’aide des variables dans le fichier .env).

N’hésitez pas à le faire pour tester ses connaissances et sa capacité à réagir sur la plateforme.

Communiquer à travers un chat

La deuxième solution pour communiquer avec votre agent est de le faire à partir d’une interface de chat, à l’instar de ChatGPT. Heureusement, Eliza fournit une interface par défaut pour subvenir à vos besoins.

Pour lancer l’interface de discussion avec votre agent IA, laissez votre agent s’exécuter et ouvrez un nouveau terminal, puis dirigez-vous à la racine de votre projet. Ensuite, tapez la commande suivante :

pnpm start:client

Vous devriez obtenir ce résultat :

Ensuite, lancez votre navigateur Internet et connectez-vous à l’adresse locale affichée, ici http://localhost:5173/. La page Web devrait proposer la liste des agents IA qui s’exécutent actuellement sur votre machine. Sélectionnez votre agent IA, puis cliquez sur chat dans le menu à gauche de l’écran. Vous voici prêt à discuter avec votre agent IA !

Améliorer votre agent

Félicitations ! Vous avez créé votre premier agent IA à l’aide du framework Eliza. Cet agent possède une personnalité qui lui est propre, peut poster des publications sur X, répondre à des utilisateurs qui le mentionnent et discuter à travers une interface de chat. Cependant, nous n’avons exploité qu’une petite partie du framework qui possède un potentiel bien plus grand. Voici deux points que vous pouvez améliorer par la suite.

Développer la personnalité de votre agent IA

La première étape d’amélioration que vous pouvez suivre est d’améliorer votre personnage. Bien que notre exemple soit suffisant pour notre tutoriel, il est possible que celui-ci présente des limites, comme de la répétition lors de ses tweets. Pour limiter ces effets indésirables, développez le contenu dans votre fichier de personnalité.

Au plus vous placez d’information dans le fichier, au plus votre agent IA sera unique, intéressant, et difficilement prédictible.

Personnaliser ses fonctionnalités

Ensuite, l’étape supérieure est l’intégration de l’agent à travers d’autres applications, et l’utilisation des plugins pour agrandir ses fonctionnalités. Par exemple, le plugin solana-plugin permet de connecter l’agent avec la blockchain Solana. Aujourd’hui, il existe une large quantité de plugins qui vous permettront de personnaliser les capacités de votre agent IA.

Ne ratez pas le bullrun, rejoignez nos experts sur Cryptoast Academy

Publicité

Issu d’études en informatique et passionné par l’univers du Web 3 depuis 2020, je mets en commun mes compétences pour vulgariser des concepts techniques et aider les lecteurs à mieux comprendre la blockchain et son écosystème.