L’IA agentive est un modèle qui choisit un outil, voit le résultat et fait une autre étape jusqu’à ce que la tâche soit terminée ou qu’quelque chose l’arrête. Un chatbot n’arrive jamais jusque-là. Un copilote vous demande d’accepter l’étape.

La boucle

Les documents du SDK Agent de Claude Code et du guide function-calling d’OpenAI décrivent le même cycle avec des noms d’outils différents.

flowchart LR
  prompt[Prompt plus tool list] --> decide[Model responds]
  decide --> tools[Host runs tool calls]
  tools --> decide
  decide --> done[Text, no tool call]
  1. Recevoir. Le modèle reçoit l’invite, les instructions, les définitions d’outils et l’historique.
  2. Agir. Il retourne du texte, des appels d’outils ou les deux. Un appel est un nom plus des arguments. L’hôte l’exécute. Le modèle ne le fait pas.
  3. Observer. L’hôte renvoie la sortie de l’outil : demande, appel, exécution, envoi de la sortie, réponse suivante.
  4. Répéter. Le tour suivant peut changer d’approche parce que la sortie est maintenant en contexte. Claude Code s’arrête quand une réponse n’a pas d’appels d’outils, puis retourne le texte plus l’utilisation.
  5. Arrêter de l’extérieur. Un refus de permission, un mode lecture seule, une invite humaine, ou un outil que vous n’avez jamais connecté.

La planification est parfois un mode séparé. Le mode Plan de Cursor et le mode plan de Claude Code recherchent sans éditer. L’app de bureau ChatGPT documente /plan avant /goal quand cette fonctionnalité de goal est disponible.

Outils et appels de fonction

Sur l’API OpenAI, un outil fonction est un schéma JSON (nom, description, paramètres). Le modèle peut retourner un appel. Votre code l’exécute et renvoie la sortie, liée à cet appel. Les noms inconnus ne s’exécutent pas. L’exemple strict du guide définit additionalProperties: false.

La boucle de Claude Code inclut Read, Edit, Write, Glob, Grep, Bash, WebSearch, WebFetch et Agent. MCP ajoute des outils. Voir le Claude Code cheat sheet. Cursor Agent recherche, édite, exécute le shell, utilise le web et un navigateur, et peut poser des questions. Son aperçu indique qu’il n’y a pas de limite d’appels d’outils par tâche. Il demande avant un outil MCP sauf si un Run Mode l’autorise.

L’AI Agent de n8n a besoin d’un modèle de chat et d’au moins un outil (un autre workflow, du code personnalisé, HTTP ou un service comme Wikipedia). À partir de n8n 1.82.0 le vieux sélecteur de type d’agent est dépourvu ; les nœuds se comportent comme un Tools Agent. Le sélecteur v1 reste dans n8n 3.0. Une GPT Action est un document OpenAPI, et l’utilisateur devra peut-être approuver l’appel.

Mémoire et planification

  • Transcription. Les tours précédents et les résultats d’outils reviennent à la demande suivante. C’est pourquoi une longue tâche remplit la fenêtre. L’app de bureau ChatGPT documente /compact quand cette commande est disponible. La mémoire sauvegardée de ChatGPT est un magasin différent : le chatgpt-prompting-cheat-sheet.
  • Fichiers que l’agent lit en premier. Codex lit AGENTS.md avant le travail : fichier global sous la maison Codex (par défaut ~/.codex), puis un fichier par répertoire de la racine du repo au répertoire de travail. Les fichiers ultérieurs remplacent les précédents. La taille combinée s’arrête à project_doc_max_bytes, 32 KiB par défaut. /init génère un fichier de démarrage.
  • Mémoire de n8n. Les sous-nœuds de mémoire ne s’attachent qu’à l’AI Agent, pas aux nœuds de chaîne. Simple Memory garde une tranche de la session. Redis, Postgres, Motorhead, Xata et Zep sont les magasins persistants documentés. Chat Memory Manager insère, charge ou supprime des messages quand vous avez besoin d’une étape que ces nœuds ne proposent pas.
  • Contexte du sous-agent. Les sous-agents de Cursor commencent vierges. Le parent doit mettre les faits dans la transition. Vous pouvez en reprendre un par identifiant d’agent.

Le mode Plan de Cursor (Shift+Tab, ou /plan dans le CLI) écrit un plan que vous éditez avant une construction. Le mode Ask (/ask ou --mode=ask) n’édite pas. Claude Code plan et Codex --sandbox read-only restent en lecture seule jusqu’à ce qu’une politique d’approbation permette plus.

Modèles multi-agents

Un agent, plusieurs outils. La valeur par défaut dans Claude Code, Cursor Agent, Codex et le Tools Agent de n8n. Le modèle choisit l’outil suivant. Vous décidez quels outils existent.

Planifier, puis agir. Une passe en lecture seule écrit les étapes. Une deuxième passe peut éditer. Cursor stocke le plan et vous permet de le construire après révision. L’app de bureau documente /plan avant /goal quand le mode goal est disponible. La porte se situe entre l’intention et les édits.

Sous-agents. Une tâche connexe s’exécute dans son propre contexte et retourne un résumé. Claude Code donne à chaque sous-agent son propre prompt, sa liste d’outils et son mode de permission. Omettez tools et il reçoit chaque outil que les sous-agents peuvent utiliser. tools: ["Read", "Grep", "Glob"] ne peut pas éditer. Ses demandes comptent vers les mêmes limites d’utilisation que le parent. La configuration se fait dans le subagents guide. En mode plan le sous-agent reste en mode plan, avec une exception que les docs énoncent pour les coéquipiers de l’équipe d’agents.

Les sous-agents de Cursor sont au premier plan ou en arrière-plan (is_background: true). readonly: true bloque les édits et le shell changeant l’état. Ils héritent des outils MCP, sauf les sous-agents cloud qui utilisent les serveurs de l’équipe sur le site d’agent de Cursor.

n8n place l’agent dans un workflow. Un outil peut être un autre workflow, donc le graphe reste en dehors du modèle. Les docs d’outils listent un exemple de « human fallback » qui utilise Call n8n Workflow Tool. Construisez d’abord un workflow normal : first n8n workflow. Les hooks de Claude Code peuvent bloquer un appel d’outil avant qu’il ne s’exécute. C’est séparé d’un sous-agent : hooks guide.

Où ça échoue

Appels d’outils mal appariés. Le modèle émet un nom et des arguments. Une description vague produit un mauvais nom ou un mauvais type. Le SDK Python MCP rejette un mauvais type avant que votre fonction ne s’exécute. Sur une API function-calling brute, cette vérification est la vôtre. Le JSON est une demande, pas une action terminée.

Boucles débridées. L’arrêt est « aucun appel d’outil supplémentaire ». L’aperçu de Cursor indique qu’il n’y a pas de limite par tâche. Les sous-agents de Claude Code ajoutent des demandes au même pool d’utilisation.

Croissance du contexte. Chaque tour renvoie l’historique. Un fichier complet ou un long journal rend le tour suivant plus grand. Remettez l’étape bruyante à un sous-agent, ou retournez seulement les lignes qui importent.

Confiance partagée. Les serveurs MCP dans une session partagent le contexte du modèle, donc un serveur défectueux peut diriger les autres outils. La stdio n’est pas une boîte à sable. Voir MCP servers explained.

Débordement discret. Codex workspace-write peut éditer et exécuter des commandes locales dans l’espace de travail sans une invite. L’approbation commence quand elle doit quitter cette limite ou utiliser le réseau.

Garde-fous

Contrôle Où c’est documenté Ce qu’il arrête
Invite de permission Claude Code default ; Cursor MCP approval Un appel ne s’exécute qu’après une personne ou une règle de permission
Lecture seule / plan Claude Code plan ; Codex --sandbox read-only ; Cursor Ask Édits
Boîte à sable plus approbation Codex workspace-write avec on-request, untrusted ou never Quitter l’espace de travail, le réseau, ou les commandes non fiables, selon la paire
Liste d’outils étroite Sous-agent tools ; nœuds d’outils n8n que vous attachez Appels que vous n’avez jamais connectés
Hook ou critiques Hooks Claude Code ; Codex approvals_reviewer = auto_review ; Cursor Auto-review Un appel examiné avant qu’il ne s’exécute
Étape humaine Claude Code AskUserQuestion ; questions Cursor ; un outil de workflow n8n La boucle attend

L’accès complet à Codex est danger-full-access plus approval_policy = never, aussi --dangerously-bypass-approvals-and-sandbox. Ne l’utilisez pas comme valeur par défaut. codex exec commence en lecture seule sauf si vous passez --sandbox workspace-write. Un sous-agent reçoit bypassPermissions seulement quand la session parent est déjà dans ce mode.

Quand choisir chacun

Utilisez un chatbot quand vous allez exécuter chaque commande vous-même. Le chatgpt-prompting-cheat-sheet suffit. Utilisez un copilote (Cursor Ask, Codex read-only) quand vous voulez une suggestion et une acceptation humaine. Utilisez un agent quand la tâche est trouver, corriger, tester et lire l’échec : Claude Code, Cursor Agent, ou Codex dans un repo, ou n8n quand les étapes sont HTTP et d’autres services. Utilisez un sous-agent quand une étape est une recherche bruyante et le parent ne devrait voir que le résumé.

Chemin de migration

  1. Si le livrable est du texte, arrêtez. Aucun outil.
  2. Ajoutez un outil en lecture seule. Rejetez les noms inconnus. Enregistrez chaque appel.
  3. Autorisez les édits dans un seul répertoire. Codex : --sandbox workspace-write --ask-for-approval on-request. Claude Code : restez sur default. Cursor : gardez l’invite d’approbation MCP.
  4. Déplacez l’étape bruyante vers un sous-agent en lecture seule. Mettez les règles permanentes dans AGENTS.md. Ajoutez un hook avant tout outil qui supprime ou poste.

FAQ

Quelle est la différence entre un chatbot et un agent IA ?

Un chatbot retourne du texte. Un agent appelle aussi des outils, lit le résultat et choisit l’étape suivante. Un copilote suggère une modification que vous acceptez. Ce qui importe, c’est si le produit peut agir sans une nouvelle invite.

Qu’est-ce qu’une boucle d’agent ?

Le modèle demande un appel d’outil, l’hôte l’exécute, et le résultat revient au tour suivant. Elle s’arrête quand le modèle n’envoie aucun appel supplémentaire, ou quand une règle de permission ou une limite de coût l’arrête. Le SDK de Claude Code décrit recevoir, évaluer, exécuter les outils, répéter, puis un résultat.

En quoi les sous-agents diffèrent-ils d’un agent avec plusieurs outils ?

Un sous-agent a son propre contexte, ses instructions et souvent une liste d’outils plus courte. Claude Code et Cursor utilisent cette séparation pour que les recherches ne restent pas dans le fil parent. Le parent voit le résumé.

Pourquoi les agents inventent-ils des appels d’outils ou boucles infinies ?

Le modèle choisit un outil à partir de sa description, donc une description vague ou une vérification d’argument manquante produit un appel que vous devriez rejeter. La boucle continue tant que des appels arrivent. Cursor ne documente pas de limite d’appels d’outils par tâche.

Le nœud AI Agent de n8n est-il le même que Claude Code ?

Non. L’AI Agent de n8n est un nœud de workflow avec un modèle de chat et au moins un outil. Claude Code est un agent de codage avec des outils de fichier, de recherche et de shell dans un projet. Les deux sont des agents, avec des modèles de permission différents.

Comment ce guide a été vérifié

Rédigé à la main à partir de la documentation officielle, chaque commande revérifiée, puis relu une seconde fois avant publication. Dernière relecture le .

Sources officielles consultées pour cet article

Share.

Les commentaires sont fermés.