Guide · Agents IA

Créer un agent IA commence par une question : en avez-vous besoin ?

Définition courte : un agent est un système où le modèle décide lui-même de ses étapes et de ses outils. Un workflow, c’est vous qui décidez du chemin et le modèle qui remplit les cases. Si vous pouvez dessiner le chemin sur une feuille, c’est un workflow : moins cher, plus prévisible, plus facile à déboguer. Vous ne passez à l’agent que quand le chemin dépend de ce que le modèle découvre en route.

C’est la définition qu’Anthropic utilise depuis son guide « Building effective agents » de décembre 2024, et celle que toute la documentation de Claude reprend. Elle évite le premier piège : payer un agent pour ce qu’un enchaînement de trois appels aurait fait.

Six façons de construire avec Claude

Deux questions les séparent : qui fournit le harnais, qui fournit la machine.

Le harnais, c’est la boucle qui appelle le modèle, exécute les outils et gère le contexte. La machine, c’est là où ça tourne. Chaque option répond différemment, et chaque option a son piège.

01

Un agent personnel sur votre machine

OpenClaw, Hermes Agent (open source, licence MIT)

Un assistant qui vous répond sur Telegram, WhatsApp ou Slack, lit vos fichiers et lance des tâches. Il tourne chez vous, sur une clé API Claude.

Le piège : Il réunit données privées, messages de tiers et canal de sortie : sans appairage, règles de refus et bac à sable, c'est une porte ouverte.

02

Claude Code en tâche planifiée

Tâches planifiées Desktop, routines cloud, sessions cloud

Automatiser ce que vous faites déjà dans Claude Code : relecture nocturne, veille de dépôt, réaction à une pull request ou à un appel d'API.

Le piège : Une routine tourne sans sélecteur de permission. Son prompt et le périmètre de son environnement sont les seuls garde-fous.

03

Claude dans n8n

Nœuds Anthropic Chat Model et AI Agent, Structured Output Parser, MCP Client Tool

Relier des logiciels SaaS avec une étape de modèle entre deux, et garder un humain dans la boucle sur certaines sorties.

Le piège : La plupart des « agents n8n » sont des workflows, et c'est très bien. Mettre un nœud agent partout coûte plus cher et se débogue mal.

04

Le Claude Agent SDK

@anthropic-ai/claude-agent-sdk (TypeScript), claude-agent-sdk (Python)

Un agent sur mesure dans votre application : la boucle de Claude Code en bibliothèque, avec outils, permissions, hooks, sous-agents, sortie structurée.

Le piège : Sans nombre de tours ni budget, la boucle ne s'arrête pas d'elle-même sur une consigne ouverte. Poser un budget est le défaut recommandé.

05

Les agents gérés (Managed Agents)

API de la plateforme Claude, CLI ant, en bêta

Un agent de production sans serveur à tenir : sessions dans un bac à sable, budget en dollars, déploiement planifié, identifiants en coffre.

Le piège : Un environnement créé par l'API sans champ réseau est ouvert. Écrivez toujours la liste des hôtes autorisés.

06

L'API Messages et vos propres outils

SDK Anthropic de votre langage

Le contrôle total, quand vous avez une raison précise de réécrire le harnais.

Le piège : Vous réécrivez ce que le SDK fournit : gestion du contexte, cache, exécution des outils, permissions, budget.

Avant le code

La fiche d’une page. Un agent sans fiche est un agent dont on ne sait pas s’il a réussi.

  1. 01

    L'objectif en une phrase, avec un critère de réussite observable : quoi, où, quand.

  2. 02

    Le périmètre : ce que l'agent lit, ce qu'il écrit, à qui il parle. Tout ce qui n'est pas listé est interdit.

  3. 03

    Les limites dures : ce qu'il ne doit jamais faire, même si un message ou un fichier le lui demande.

  4. 04

    Les cas où il s'arrête et demande au lieu de deviner, avec un seuil précis pour chacun.

  5. 05

    Le budget par exécution et la cadence, et ce qui se passe quand le budget est atteint.

  6. 06

    La preuve : ce que vous relirez, et ce qui doit être journalisé.

Ce que ça coûte, au 4 octobre 2026
  • Sonnet 5.5 : 2 $ le million de tokens en entrée, 10 $ en sortie. Haiku 5.5 : 0,10 $ et 0,50 $ jusqu'à 100 000 tokens par requête. Opus 5.5 : 4 $ et 20 $.
  • Agent géré : 0,08 $ par heure de session en cours, l’attente ne compte pas.
  • Recherche web côté serveur : 10 $ pour 1 000 recherches.
  • Les tokens dominent l’infrastructure d’un ordre de grandeur : négociez votre contexte, pas votre hébergeur.
Ce qui protège vraiment
  • Les secrets hors de l’agent : proxy d’injection, ou coffre des agents gérés.
  • Le réseau limité à une liste d’hôtes, relue à chaque nouvel outil.
  • Un outil retiré plutôt qu’un outil interdit par le prompt.
  • Une approbation humaine sur chaque geste irréversible, et un budget qui arrête la session.

Le parcours « Construire ton agent IA avec Claude » : sept leçons, la première en accès libre.

De l’agent personnel sur votre machine (OpenClaw, Hermes) à l’agent de production planifié et budgété (Agent SDK, agents gérés), en passant par Claude Code en tâche planifiée et n8n. Sourcé sur la documentation officielle relevée le 4 octobre 2026, avec un défi cochable par leçon et le modèle de menace en dernière leçon.

Questions fréquentes

Créer un agent IA : ce qu’on nous demande.

Qu'est-ce qu'un agent IA, exactement ?
Selon la définition qu'Anthropic utilise depuis son guide « Building effective agents » (décembre 2024), un agent est un système où le modèle dirige lui-même son processus et son usage des outils. Dans un workflow, au contraire, les modèles et les outils suivent des chemins de code que vous avez écrits. La différence, c'est qui décide de l'étape suivante : votre code, ou le modèle.
Faut-il savoir coder pour créer un agent IA ?
Pas pour les deux premières options. Un agent personnel comme OpenClaw ou Hermes s'installe en une commande et se configure en langage courant. Une tâche planifiée Claude Code ou une routine se crée dans l'interface. n8n demande de l'aisance avec un outil visuel. Le SDK et les agents gérés demandent de programmer, en TypeScript ou en Python, mais la boucle, les outils et les permissions sont fournis.
Combien coûte un agent IA ?
Trois lignes : les tokens, le temps de machine, les outils facturés à l'usage. Au 9 octobre 2026, Sonnet 5.5 coûte 2 $ par million de tokens en entrée et 10 $ en sortie, Haiku 5.5 0,10 $ et 0,50 $ (jusqu'à 100 000 tokens par requête), Opus 5.5 4 $ et 20 $. Un agent géré ajoute 0,08 $ par heure de session en cours. La documentation d'Anthropic précise que les tokens dominent le coût de l'infrastructure d'un ordre de grandeur. La cadence est un paramètre de coût : un agent à 0,30 $ par exécution toutes les heures coûte 216 $ par mois, une fois par nuit 9 $.
Quelle est la différence entre OpenClaw et Hermes Agent ?
Les deux sont des agents personnels open source sous licence MIT, qui tournent sur votre machine, se branchent sur Claude par clé API et parlent à vos messageries. Hermes Agent, publié par Nous Research, ajoute une boucle d'apprentissage (il crée et améliore ses propres skills), un planificateur cron intégré et sept backends d'exécution dont Docker. OpenClaw met en avant sa Gateway locale, ses applications natives et un annuaire de plugins. Dans les deux cas, trois réglages comptent avant tout : l'appairage des contacts, les règles de refus et le bac à sable.
Un agent peut-il être piraté ?
Oui, par ce qu'il lit. Un fichier, une page web ou un message peut contenir des instructions qu'un agent incorpore à ses actions : c'est l'injection de prompt. La documentation d'Anthropic recommande la défense en profondeur : secrets hors de l'agent (proxy ou coffre), réseau limité à des hôtes listés, système de fichiers en lecture seule là où c'est possible, approbation humaine sur les gestes irréversibles. Le comportement du modèle, aussi bon soit-il, n'est pas un contrôle de sécurité.
Que dit la loi si je déploie un agent dans mon entreprise ?
Vous êtes déployeur au sens de l'AI Act. L'article 4 (littératie IA) s'applique depuis le 2 février 2025 et vous demande de prendre des mesures pour former les personnes qui utilisent et supervisent l'agent. L'article 50 (transparence) s'applique depuis le 2 août 2026 si l'agent interagit avec des humains. Le RGPD s'applique comme à tout traitement : minimisation, base légale, information des personnes.

À lire ensuite : les skills, plugins et mods de Claude Code · le prompt engineering · l’obligation de formation de l’AI Act.