Agents IA : ce qu'ils sont et comment créer le vôtre étape par étape

Tout le monde parle des agents IA. Mais si vous demandez à la plupart des gens ce qu'est réellement un agent, vous obtenez une réponse vague du genre « IA qui fait des choses de manière autonome ».

La réalité est bien plus utile que ça. Les agents ne forment pas une catégorie. Ce sont un spectre.

Ce guide explique où se situent les différents outils IA sur ce spectre, ce qui sépare une simple interaction avec un LLM d'un véritable workflow agentique, et comment construire votre propre agent avec Claude Code et le connecter à Telegram, sans écrire de code vous-même.

Avant d'entrer dans le vif du sujet, suivez-moi sur X et rejoignez mon canal Telegram que je viens de créer, où je publie du contenu IA tous les jours. Les deux sont gratuits.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

Ce qui fait d'une chose un agent

Demander à Claude « qu'est-ce que je devrais publier aujourd'hui ? » n'est pas un agent. C'est une conversation.

Dire à Claude « trouve les trois sujets tendance en IA en ce moment, choisis celui avec le plus de potentiel d'engagement, rédige un post dans mon style et enregistre-le dans un fichier » et le voir faire tout cela sans que vous touchiez à rien, ça c'est un agent.

La différence n'est pas le modèle. C'est la structure qui l'entoure.

Un agent possède trois choses qu'une conversation ordinaire n'a pas : des outils qu'il peut appeler de lui-même (recherche, systèmes de fichiers, exécution de code, API externes), une mémoire qui persiste entre les tâches (pas seulement au sein d'une même session), et une boucle qui continue de tourner jusqu'à ce que la tâche soit terminée (pas jusqu'à ce qu'il génère une seule réponse).

Plus vous ajoutez de ces trois éléments, moins vous êtes impliqué. C'est l'idée.

Le spectre : de la conversation à l'agent

À une extrémité, vous avez une simple conversation. Vous demandez, Claude répond, la session se termine. Pas d'outils, pas d'objectif continu, pas de capacité à agir dans le monde.

Un cran au-dessus : Claude avec des outils activés. Quand Claude cherche sur le web avant de répondre, lit un fichier joint ou génère une image, il est déjà légèrement agentique. Vous ne lui avez pas dit de faire ces choses étape par étape, il a décidé tout seul qu'il en avait besoin.

Plus haut : les workflows multi-étapes. Vous donnez un objectif, Claude le décompose en étapes, exécute chacune, vérifie le résultat et livre une sortie finalisée. Vous n'intervenez pas entre les étapes.

Au sommet : les agents totalement autonomes. L'agent s'exécute selon un planning, surveille les entrées, appelle des services externes et accomplit des tâches complexes sans intervention humaine. Vous définissez l'objectif une fois et vérifiez le résultat.

La différence entre le bas et le haut n'est pas un modèle différent. C'est ce qui entoure le modèle : des outils qu'il peut appeler, une mémoire qui conserve le contexte, et une boucle qui continue jusqu'à ce que la tâche soit terminée.

Types d'agents que vous pouvez construire aujourd'hui

Pour vous donner une idée de ce à quoi les agents peuvent ressembler aujourd'hui, j'ai rassemblé quelques exemples ci-dessous. Ce ne sont pas des limites – vous pouvez construire ce qui correspond à votre situation spécifique.

Agent de recherche : rassemble des informations sur un sujet, lit plusieurs sources, extrait ce qui compte et livre un résumé structuré. Vous lui donnez une question. Il vous donne une réponse qui aurait pris des heures à compiler manuellement.

Agent d'écriture : écrit du contenu selon un système que vous définissez. Donnez-lui votre ton, votre format, votre public et votre sujet. Il gère les brouillons, les réécritures et les corrections sans que vous ayez à gérer chaque phrase.

Agent de code : écrit du code, l'exécute, lit les erreurs, les corrige et continue. Vous décrivez ce que le code doit faire. L'agent s'occupe de l'implémentation et de la boucle de débogage.

Agent professionnel : gère les tâches professionnelles répétitives : rédaction d'e-mails, traitement des demandes clients, qualification des leads, génération de rapports. Fonctionne en pilote automatique une fois que vous avez défini les règles.

Agent personnel : gère votre emploi du temps, organise les tâches, prépare des briefings et s'occupe du travail de planification que vous faites manuellement chaque jour.

Construire votre premier agent – Commencez ici

Vous allez utiliser Claude Code pour construire un bot Telegram qui tourne sur un serveur distant et utilise Claude comme cerveau. Claude Code écrit tout le code pour vous, vous décrivez simplement ce que vous voulez en anglais courant. Une fois configuré, toute communication avec le bot se fait directement via Telegram.

L'ensemble de la configuration prend environ 10 à 20 minutes. Vous n'avez pas besoin de savoir coder.

Modèles de prompt système – À coller dans le Prompt 2

Lorsque vous exécutez le Prompt 2 de la configuration ci-dessous, vous devez décrire le type d'agent que vous souhaitez. Voici des modèles prêts à l'emploi : copiez celui qui correspond, collez-le dans le Prompt 2 à l'endroit où il est écrit « L'agent doit être : », et Claude Code construira cet agent spécifique. Adaptez les détails à votre situation.

Agent de recherche

1Vous êtes un agent de recherche. Votre travail consiste à rassembler, analyser et synthétiser des informations sur tout sujet que je vous donne.
2
3Lorsque vous recevez une tâche de recherche :
41. Identifiez les 3 à 5 sous-questions les plus importantes à traiter
52. Recherchez des informations sur chacune d'elles
63. Évaluez la qualité et la pertinence de chaque source
74. Extrayez uniquement ce qui répond directement à la question
85. Livrez un résumé structuré comprenant : les résultats clés, les preuves à l'appui et les lacunes que vous n'avez pas pu combler
9
10Format : utilisez des titres, des puces et des sections claires.
11Si vous n'êtes pas sûr de quelque chose, dites-le explicitement.
12N'ajoutez pas de remplissage. Chaque phrase doit apporter une information.

Agent d'écriture

1Vous êtes un agent d'écriture. Vous rédigez du contenu dans ma voix et mon style.
2
3Mon style :
4- Conversationnel, direct, pas de langage corporate
5- Phrases et paragraphes courts
6- Chiffres précis et exemples plutôt que des affirmations vagues
7- Terminer toujours par quelque chose que le lecteur devrait faire ou considérer
8
9Lorsque vous recevez une tâche d'écriture :
101. Demandez le sujet, le public et la longueur souhaitée s'ils ne sont pas fournis
112. Rédigez un premier brouillon
123. Relisez-le en fonction de mes règles de style
134. Livrez la version finale prête à publier
14
15N'ajoutez jamais d'introductions inutiles. Commencez par le point le plus important.

Agent de code

1Vous êtes un agent de code. Votre travail consiste à écrire, déboguer et améliorer du code.
2
3Lorsque vous recevez une tâche de codage :
41. Confirmez votre compréhension de ce que le code doit faire
52. Écrivez la solution avec des commentaires clairs
63. Identifiez tous les cas limites ou échecs potentiels
74. S'il y a des erreurs, déboguez-les systématiquement avant de demander de l'aide
8
9Règles :
10- Écrivez un code propre et lisible avec des noms de variables significatifs
11- Incluez toujours la gestion des erreurs
12- Expliquez en langage clair ce que fait chaque section majeure
13- Si vous n'êtes pas sûr des exigences, posez une question de clarification avant de continuer

Agent d'e-mails professionnels

1Vous êtes un agent d'e-mails professionnels. Vous rédigez des e-mails professionnels en mon nom.
2
3Mon style de communication :
4- Direct et respectueux
5- Pas de formalités inutiles
6- Allez à l'essentiel dès la première phrase
7- Terminez par une prochaine étape claire
8
9Lorsque vous recevez une tâche d'e-mail :
101. Identifiez l'objectif de l'e-mail (informer, demander, suivre, confirmer)
112. Rédigez un objet qui reflète le but de l'e-mail
123. Rédigez l'e-mail en 3 à 5 courts paragraphes maximum
134. Terminez par une action claire ou une prochaine étape
14
15Écrivez toujours des e-mails prêts à être envoyés, pas des modèles avec des blancs à remplir.

Agent de planification personnelle

1Vous êtes mon agent de planification personnelle. Vous m'aidez à organiser mon travail, à prioriser les tâches et à planifier ma semaine.
2
3Lorsque je partage mes tâches ou objectifs :
41. Identifiez ce qui est urgent vs. important
52. Suggérez une séquence réaliste basée sur les dépendances
63. Estimez le temps nécessaire pour chaque tâche
74. Signalez tout ce qui pourrait être délégué ou éliminé
8
9Lorsque je décris un projet :
10- Décomposez-le en actions concrètes immédiates
11- Identifiez la chose la plus importante à faire en premier
12- Créez une simple liste de contrôle que je peux suivre
13
14Restez pratique. Pas de remplissage motivationnel. Juste le plan.

Ce dont vous avez besoin avant de commencer

1 – une clé API Claude depuis console.anthropic.com. C'est une clé développeur, vous payez à l'utilisation, pas un abonnement mensuel fixe. Pour un bot personnel qui envoie 50 messages par jour, le coût est de 1 à 5 $ par mois selon le modèle choisi.

2 – un token de bot Telegram depuis BotFather.

3 – un VPS sous Linux. Pour un bot Telegram personnel, vous n'avez pas besoin de quelque chose de puissant – 1 CPU, 1 Go de RAM et 20 Go de stockage sont plus que suffisants. N'importe quel forfait de base chez DigitalOcean, Hetzner ou Vultr fera l'affaire et coûte entre 4 et 6 $ par mois. Une fois le serveur obtenu, installez Claude Code en exécutant npm i -g @anthropic-ai/claude-code dans votre terminal.

Quel modèle Claude utiliser pour votre bot et ce que cela coûte réellement :

Pour la plupart des bots personnels, Sonnet 4.6 est le bon choix : assez puissant pour toutes les tâches et abordable pour une utilisation quotidienne. Utilisez Haiku 4.5 si vous voulez minimiser les coûts. Opus 4.8 n'a de sens que pour un agent d'analyse complexe où la qualité de la réponse est cruciale.

Construire votre premier agent – Étape 1

Ouvrez le terminal de votre VPS et lancez Claude Code. Collez ce prompt et laissez-le tout construire.

Donnez une personnalité à l'agent

1Construis-moi un bot Telegram qui utilise l'API Claude comme cerveau.
2
3Exigences :
4- Langage : Python
5- Bibliothèque pour Telegram : python-telegram-bot
6- Modèle Claude : claude-sonnet-4-6
7- Le bot reçoit un message, l'envoie à l'API Claude et renvoie la réponse de Claude à Telegram
8- Conserve l'historique des conversations par utilisateur – chaque utilisateur a son propre contexte dans la session
9- Ajoute une commande /start qui présente le bot
10- Ajoute une commande /clear qui réinitialise l'historique des conversations pour cet utilisateur
11
12Crée tous les fichiers nécessaires : fichier principal du bot, requirements.txt et un modèle de fichier .env pour les clés API.
13Ne code en dur aucune clé API – lis-les à partir des variables d'environnement.

Déployer comme un service en arrière-plan

1Crée un fichier de service systemd pour que ce bot s'exécute automatiquement sur mon VPS Linux et redémarre en cas de crash.
2
3Le service doit :
4- Démarrer automatiquement au démarrage du serveur
5- Redémarrer automatiquement en cas de crash
6- Charger les variables d'environnement depuis le fichier .env dans le dossier du projet
7- Enregistrer les logs dans un fichier que je peux consulter plus tard
8
9Écris-moi aussi les commandes terminal exactes pour installer le service, le démarrer, vérifier s'il tourne et voir les logs.

Ajouter une mémoire persistante entre les sessions

1Le bot perd l'historique des conversations quand il redémarre. Corrige ça.
2
3Sauvegarde l'historique des conversations de chaque utilisateur dans un fichier JSON sur le disque après chaque message. Recharge-le automatiquement au démarrage du bot.
4
5Ajoute une longueur d'historique maximale – ne garde que les 20 derniers messages par utilisateur pour que la fenêtre de contexte ne devienne jamais trop longue.

Ajouter des compétences à votre bot Claude Code

Les compétences sont des capacités que vous ajoutez à votre bot au fil du temps. Chacune est un nouveau prompt que vous donnez à Claude Code, et il écrit le code pour la faire fonctionner. Voici les plus utiles.

Compétence : Recherche web

Votre agent peut consulter des informations en temps réel au lieu de répondre uniquement de mémoire.

1Ajoute une capacité de recherche web au bot en utilisant l'API Tavily.
2
3Quand l'utilisateur demande quelque chose qui nécessite des informations actuelles – actualités, prix, événements récents – le bot cherche automatiquement sur le web et inclut les résultats dans sa réponse.
4
5Le bot doit décider lui-même quand chercher et quand répondre de mémoire. Ajoute TAVILY_API_KEY au modèle de fichier .env.
6
7Utilise la fonctionnalité d'utilisation d'outils de Claude pour implémenter cela proprement.

Compétence : Sauvegarder des notes

Votre agent peut sauvegarder tout ce que vous lui dites dans un fichier – idées, tâches, résultats de recherche – et les récupérer plus tard.

1Ajoute une fonction de sauvegarde de notes au bot.
2
3Quand l'utilisateur dit « sauvegarde ça », « retiens ça » ou « note : », le bot sauvegarde le contenu dans un fichier notes.txt avec un horodatage.
4
5Ajoute une commande /notes qui renvoie les 10 dernières notes sauvegardées.
6Ajoute une commande /clearnotes qui supprime toutes les notes sauvegardées.

Compétence : Restreindre à votre compte uniquement

Par défaut, toute personne qui trouve votre bot peut l'utiliser et consommer vos crédits API. Ceci le verrouille à vous seul.

1Ajoute une restriction d'utilisateur au bot pour que seulement moi puisse l'utiliser.
2
3Ajoute mon ID utilisateur Telegram dans le fichier .env sous ALLOWED_USER_ID.
4Si quelqu'un d'autre envoie un message au bot, il répond « Ce bot est privé. » et ignore tous les messages suivants de cet utilisateur.
5
6Ajoute aussi comment je peux trouver mon propre ID utilisateur Telegram – soit via le bot lui-même, soit par une autre méthode.

Compétence : Suivre les coûts API

L'API Claude facture par token. Ceci ajoute un simple suivi des coûts pour que vous sachiez toujours ce que vous dépensez.

1Ajoute un suivi basique des coûts au bot.
2
3Après chaque réponse de l'API Claude, enregistre le nombre de tokens d'entrée et de sortie utilisés.
4Conserve un total cumulé dans un fichier costs.json.
5
6Ajoute une commande /costs qui affiche : le total de tokens utilisés aujourd'hui, le total de tokens utilisés de tous les temps, et un coût estimé en USD basé sur la tarification de claude-sonnet-4-6.

Compétence : Briefing quotidien programmé

L'agent vous envoie un message chaque matin sans que vous ayez à demander.

1Ajoute un briefing quotidien programmé au bot.
2
3Tous les jours à 8h00, le bot m'envoie un message avec :
41. Une phrase motivante (courte, pas ringarde)
52. Un rappel de vérifier ma priorité du jour
63. Un fait utile aléatoire sur la productivité ou l'IA
7
8Envoie-le à mon ID utilisateur Telegram depuis le fichier .env.
9Utilise la bibliothèque schedule ou APScheduler pour implémenter cela.

Choses utiles à savoir après la configuration

Comment mettre à jour la personnalité de votre agent. Ouvrez le fichier principal du bot, trouvez la variable de prompt système en haut, modifiez-la, sauvegardez le fichier et redémarrez le service avec sudo systemctl restart nom-de-votre-bot. La nouvelle personnalité est active immédiatement.

Comment vérifier si le bot tourne. Exécutez sudo systemctl status nom-de-votre-bot dans votre terminal. S'il indique « active (running) », cela fonctionne. S'il indique « failed », vérifiez les logs.

Comment lire les logs. Exécutez journalctl -u nom-de-votre-bot -n 50 pour voir les 50 dernières lignes. C'est là que vous trouverez les messages d'erreur en cas de problème.

Comment ajouter une nouvelle compétence. Ouvrez Claude Code dans votre dossier de projet et décrivez ce que vous voulez : « Ajoute la fonctionnalité X au bot. » Claude Code lit votre code existant, ajoute la nouvelle fonctionnalité proprement et vous dit si un redémarrage est nécessaire.

Le problème de mémoire que rencontre chaque agent

C'est le problème le plus courant que les gens rencontrent. L'agent perd le contexte entre les sessions, au cours de longues tâches, après trop de messages, et commence à faire des erreurs ou à répéter un travail déjà effectué.

Cela arrive de trois façons :

Les longues tâches finissent par dépasser la limite de contexte de Claude, et l'agent commence à perdre le début de la conversation : l'objectif initial, les décisions déjà prises, les contraintes que vous avez fixées.

Quand vous fermez une session et en ouvrez une nouvelle, l'agent repart de zéro.

Si l'agent est interrompu en cours de tâche, il n'a aucun moyen de savoir où il s'est arrêté.

Quatre choses peuvent résoudre ce problème :

Demandez à l'agent d'écrire une note de progression après chaque étape majeure : ce qui a été fait, ce qui a été décidé, ce qui doit encore arriver. Collez cette note au début de la session suivante pour restaurer le contexte complet.

Toutes les dix à quinze messages, demandez à l'agent de résumer où il en est. Cela le force à compresser le contexte avant qu'il ne déborde.

Avant que la conversation ne devienne trop longue, demandez à l'agent de tout compresser en un court résumé et de continuer à partir de là. Le fil reste intact.

Ajoutez les faits clés dont votre agent a toujours besoin directement dans le prompt système de votre code de bot. Claude lit cela au début de chaque conversation, donc ces informations sont toujours dans le contexte, quelle que soit la durée des échanges.

Prompt de point de contrôle

1Avant de continuer, écris un bref point de contrôle :
21. Qu'as-tu accompli jusqu'à présent ?
32. Quelles sont les décisions ou conclusions clés de cette session ?
43. Que reste-t-il à faire ?
54. De quel contexte aurais-tu besoin pour continuer cette tâche dans une nouvelle session ?
6
7Restes-en à moins de 200 mots.

Prompt de fichier mémoire

1Après avoir terminé chaque étape majeure, écris une note mémoire dans ce format :
2
3ÉTAPE TERMINÉE : [ce qui a été fait]
4DÉCISIONS CLÉS : [choix effectués et pourquoi]
5ÉTAT ACTUEL : [où en est la tâche maintenant]
6PROCHAINE ÉTAPE : [ce qui devrait se passer ensuite]
7
8Cette note sera utilisée pour reprendre la tâche dans une nouvelle session sans perdre le contexte.

Prompt de récupération de contexte

1Nous reprenons une tâche d'une session précédente. Voici le contexte :
2
3[colle ta note mémoire ici]
4
5Sur cette base :
61. Confirme ta compréhension de là où nous en sommes
72. Identifie la prochaine étape
83. Pose les questions nécessaires pour continuer
9
10Ne répète pas le travail déjà effectué.

Prompt de résumé roulant

1La conversation devient longue. Compresse tout ce qui est important dans un résumé :
2
31. Objectif initial
42. Ce qui a été fait et ce qui a été trouvé
53. Décisions clés prises
64. Ce qui doit encore se produire
7
8Après avoir écrit le résumé, continue à partir de là. Considère ce résumé comme le nouveau point de départ.

Vous savez maintenant ce que sont les agents, ce qu'ils peuvent faire et comment en construire un vous-même. J'espère que cela vous a été utile.

Si vous voulez rester informé de tout ce qui se passe dans l'IA, suivez-moi sur X et Telegram.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp