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 « une IA qui fait des choses de manière autonome ».

La réalité est bien plus utile que cela. Les agents ne sont pas une catégorie. Ils sont un spectre.

Ce guide explique où se situent les différents outils d'IA sur ce spectre, ce qui distingue une interaction de base 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 de commencer, suivez-moi sur X.

X -

https://x.com/ai_rohitt

Ce qui fait d'un outil un Agent

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

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 discussion ordinaire n'a pas. Des outils qu'il peut utiliser 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 seule session. Et une boucle qui s'exécute jusqu'à ce que la tâche soit terminée, pas jusqu'à ce qu'elle 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 Discussion à l'Agent

À une extrémité, vous avez une discussion de base. 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 les outils activés. Lorsque 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é 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 d'elles, vérifie le résultat et fournit une sortie finale. Vous n'intervenez pas entre les étapes.

Au sommet : les agents entièrement autonomes. L'agent s'exécute selon un planning, surveille les entrées, appelle des services externes et effectue 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 de s'exécuter 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 réellement ressembler aujourd'hui, j'ai rassemblé quelques exemples ci-dessous. Ce ne sont pas des limites ; vous pouvez construire tout ce qui correspond à votre situation spécifique.

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

Agent de rédaction : é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 éditions 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 gère l'implémentation et la boucle de débogage.

Agent métier : gère les tâches professionnelles répétitives : rédiger des e-mails, traiter les demandes des clients, qualifier des prospects, générer des 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 s'exécute 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 simple. 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. Ajustez les détails pour correspondre à votre situation.

Agent de Recherche

1Vous êtes un agent de recherche. Votre travail consiste à rassembler, analyser et synthétiser des informations sur n'importe quel sujet que je vous donne.
2
3Lorsque vous recevez une tâche de recherche :
41. Identifiez les 3 à 5 sous-questions les plus importantes auxquelles répondre
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. Fournissez un résumé structuré avec : les principales conclusions, les preuves à l'appui et les lacunes que vous n'avez pas pu combler
9
10Format : Utilisez des en-têtes, 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 contenir une information.

Agent de Rédaction

1Vous êtes un agent de rédaction. Vous écrivez 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 et exemples spécifiques plutôt que des affirmations vagues
7- Terminez toujours par quelque chose que le lecteur devrait faire ou auquel il devrait réfléchir
8
9Lorsque vous recevez une tâche de rédaction :
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 par rapport à mes règles de style
134. Livrez la version finale prête à être publiée
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 les cas limites ou les défaillances potentielles
74. En cas d'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 ce que fait chaque section principale en langage clair
13- Si vous n'êtes pas sûr des exigences, posez une question de clarification avant de procéder

Agent d'E-mail Professionnel

1Vous êtes un agent d'e-mail professionnel. 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- Va droit au but dès la première phrase
7- Se termine 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, faire un suivi, confirmer)
112. Rédigez un objet qui reflète le but de l'e-mail
123. Rédigez l'e-mail en 3 à 5 paragraphes courts maximum
134. Terminez par un élément d'action ou une prochaine étape claire
14
15Rédigez 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 requis 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 suivantes
11- Identifiez la chose la plus importante à faire en premier
12- Créez une liste de contrôle simple que je peux suivre
13
14Gardez tout 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. Il s'agit d'une clé développeur ; vous payez à l'utilisation, pas un abonnement mensuel fixe. Pour un bot personnel envoyant 50 messages par jour, le coût est de 1 à 5 $ par mois selon le modèle que vous choisissez.

2 - un jeton 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 plan de base de DigitalOcean, Hetzner ou Vultr fonctionnera et coûte environ 4 à 6 $ par mois. Une fois que vous avez le serveur, 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 qu'il coûte réellement :

Pour la plupart des bots personnels, Sonnet 4.6 est le bon choix, suffisamment puissant pour n'importe quelle tâche et abordable pour une utilisation quotidienne. Utilisez Haiku 4.5 si vous souhaitez minimiser les coûts. Opus 4.8 n'a de sens que pour un agent analytique complexe où la qualité des réponses est critique.

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- Maintiens 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éployez en tant que service d'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 s'il plante.
2
3Le service doit :
4- Démarrer automatiquement au démarrage du serveur
5- Redémarrer automatiquement s'il plante
6- Charger les variables d'environnement à partir du 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.

Ajoutez une mémoire persistante entre les sessions

1Le bot perd l'historique des conversations lorsqu'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 conserve 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 rechercher 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
3Lorsque 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 seul 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 : Enregistrer des notes

**Votre agent peut enregistrer 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 fonctionnalité de sauvegarde de notes au bot.
2
3Lorsque l'utilisateur dit "sauvegarde ça", "souviens-toi de ç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. Cela le verrouille pour vous seul.

1Ajoute une restriction d'utilisateur au bot pour que moi seul puisse l'utiliser.
2
3Ajoute mon ID utilisateur Telegram au fichier .env en tant que 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. Cela 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.
4Garde 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 à le demander.

1Ajoute un briefing quotidien programmé au bot.
2
3Chaque jour à 8h00, le bot m'envoie un message avec :
41. Une phrase motivante (courte, pas ringarde)
52. Un rappel de vérifier ma priorité numéro un 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)", il 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 trouvez les messages d'erreur si quelque chose se casse.

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 Chaque Agent A

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

Il y a trois façons dont cela se produit :

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 définies.

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

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

Quatre choses peuvent résoudre cela :Dites à 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 se produire. 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 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 choses.

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
7Garde-le sous 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 faits 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 refais pas le travail qui a déjà été accompli.

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 au courant de tout ce qui se passe dans l'IA, suivez-moi sur X.

X - https://x.com/ai_rohitt