Aller au contenu
Sommaire

Fiche mémo Agents

Fiche mémo · environ 3 min de lecture

Validé

Validé. Ce site n’exécute aucune commande. Sources

Définitions

TermeDéfinition (source)
Workflowmodèles et outils orchestrés par des chemins de code prédéfinis (Anthropic)
Agentle modèle dirige dynamiquement son processus et ses outils (Anthropic) ; planifie, utilise des outils, garde du contexte (OpenAI)
Outilfonction que le modèle demande d'appeler
Sous-agentassistant à contexte isolé, outils restreignables, renvoie un résumé (Claude Code)
MCPprotocole ouvert reliant applications d'IA et systèmes externes (outils, ressources, invites)

La boucle

Rassembler le contexte, agir (outil), vérifier, recommencer jusqu'à l'arrêt ou l'interruption. Contrôler avant (permissions), dans (isolation, droits réduits), après (vérification exécutable). Poser des bornes : tours, budget, durée.

Chat, workflow ou agent ?

Si…Prendre
une réponse suffitchat
étapes connues et fixesworkflow (enchaînement, routage, parallélisation)
étapes imprévisibles + critère de réussite vérifiableagent, borné
sous-tâches imprévisibles à répartirorchestrateur et travailleurs
critères de qualité netsévaluateur-optimiseur

Commencer simple ; l'agent coûte plus et ses erreurs se cumulent.

Sous-agents (Claude Code)

  • Fichier Markdown : .claude/agents/ (projet) ou ~/.claude/agents/ (utilisateur).
  • Contexte propre, pas l'historique ; outils via tools / disallowedTools.
  • Imbrication limitée (3 niveaux par défaut) ; arrière-plan : outils restreints.
  • Compte dans les mêmes limites d'usage ; n'est pas gratuit.
  • Relecteur : contexte neuf, critère précis, ne signaler que les écarts utiles.

Risques et garde-fous

RisqueGarde-fou
Erreurs cumuléesvérifier à chaque étape, points de contrôle
Coûtbornes de tours/budget/durée
Injection de consignescontenu externe = donnée ; permissions ; confirmation
Droits excessifsmoindre privilège, lecture seule
Irréversibleconfirmation, sauvegarde, bac à sable, dry-run
Fuite de donnéesfiltrer les entrées, réseau restreint
Dérive / trichecritères externes, relecture du diff
Opacitéjournaux, transcriptions

Principe du corpus : éviter de cumuler données privées + contenu non fiable + canal de sortie.

Liste de contrôle avant lancement

  1. Objectif et critère vérifiable. 2. Outils minimaux. 3. Permissions prudentes

et refus explicites. 4. Isolation (dossier dédié, branche, VM). 5. Bornes. 6. Données synthétiques. 7. Journal. 8. Retour arrière testé. 9. Mini-évaluation. 10. Revue humaine avant effet extérieur.

Exemple de commande (non exécutée) : claude -p "…" --max-turns 5. Contexte : dépôt de démonstration, branche dédiée. Droits : ceux de l'utilisateur, à restreindre par --allowedTools. Effet : réponse imprimée, fichiers modifiables. Contrôle : git diff, tests. Retour arrière : git restore, suppression de la branche.

MCP : sûreté (spécification 2026-07-28)

Consentement avant tout appel d'outil ; outils = exécution de code arbitraire ; descriptions d'outils non fiables sauf serveur de confiance ; le protocole n'impose pas ces règles lui-même.

Ne jamais confier à un agent connecté à un service hébergé

Secrets, clés, jetons, .env, identifiants, hôtes et infrastructure réels, tickets privés, données de santé ou de tiers, documents confidentiels, contenus sous droits. Valeurs fictives (exemple.invalid). Protéger par refus de lecture et isolation, pas par une simple consigne.

Sources (consultées le 2026-10-17)

Building Effective Agents (s’ouvre dans un nouvel onglet) · Evals d'agents (résumé) (s’ouvre dans un nouvel onglet) · Agent SDK (s’ouvre dans un nouvel onglet) · Comment fonctionne Claude Code (s’ouvre dans un nouvel onglet) · Sous-agents (s’ouvre dans un nouvel onglet) · Sécurité (s’ouvre dans un nouvel onglet) · Guide OpenAI (s’ouvre dans un nouvel onglet) · MCP (s’ouvre dans un nouvel onglet)