Aperçu moduleModule previewVista previa del módulo
Aperçu limité, 3 premières étapesLimited overview, first 3 stepsVisibilidad limitada, 3 primeras etapas

Le contrôle des permissionsPermission checksEl control de permisos

Parcours : Construire un agent de code, le harnais · OpérationnelCourse: Building a Coding Agent: the Harness · PractitionerCurso: Construir un agente de código: el harness · Operativo

Le contrôle des permissions
1/7
ÉtapeStepEtapa 1 / 7

≈ 9 min

Le problème

Le problème : votre agent exécute tout ce que le modèle demande, et la seule protection reste votre vigilance.

Au programme de ce moduleIn this moduleEn el programa de este módulo

  1. 01Le problème≈ 9 min
  2. 02L’intuition≈ 8 min
  3. 03Le mécanisme≈ 9 min
  4. 04Le code, pas à pas≈ 10 min
  5. 05Pièges & pratiques≈ 10 min
  6. 06Exercice≈ 6 min
  7. 07Quiz≈ 5 min
Durée totaleTotal durationDuración total≈ 57 min
voix de synthèse

Objectifs d’apprentissage

À la fin de ce module, vous saurez où et comment placer un contrôle de permissions dans un harnais d’agent, et vous saurez le coder. Voici les acquis visés.

  • Expliquer pourquoi la sécurité d’un agent ne peut reposer ni sur la bonne volonté du modèle ni sur sa consigne système ;
  • Décrire les trois portes d’un contrôle de permissions et leur ordre : refus ferme, règles contextuelles, validation humaine ;
  • Situer ce contrôle dans le harnais : entre l’outil demandé et la fonction exécutée ;
  • Coder une fonction check_permission et l’insérer dans la boucle sans casser la paire tool_use → tool_result ;
  • Reconnaître les limites d’un filtrage par motifs, et ce qui constitue une vraie frontière de sécurité.

Sources

Curriculum open-source shareAI-lab/learn-claude-code, chapitre s03 (Permission), publié sous licence MIT, © shareAI-lab, adaptation Getul. La notice de licence est reproduite sur la page Sources et références. Documentation publique de Claude Code (Anthropic) sur les permissions, citée pour comparer avec un outil en production. Le motif présenté est indépendant du fournisseur : il vaut pour toute API offrant l’appel d’outils.

Un agent qui dit oui à tout

Votre agent du module 2 lit, écrit et lance des commandes. Il le fait bien, et c’est précisément le problème : il exécute TOUT ce que le modèle demande, sans exception. Demandez-lui de « faire de la place dans le projet » : il peut très bien conclure qu’un rm -r sur le mauvais dossier est la manière la plus efficace d’y parvenir. Votre harnais transmettra la commande au shell sans sourciller.

Jusqu’ici, la seule protection était la vôtre : travailler dans un dossier jetable, relire chaque action, garder le doigt sur Ctrl+C. Cela tient pour une démonstration de dix minutes. Cela ne tient plus pour un agent qui enchaîne quarante appels d’outils pendant que vous regardez ailleurs, ni pour un agent qui lit des fichiers écrits par d’autres, où peut se cacher une instruction malveillante (l’injection de prompt).

Pour comprendre : une consigne est une demande, le code est une garantie

Écrire « Ne supprime jamais de fichier » dans la consigne système n’est pas un système de permissions. Le modèle suivra cette consigne la plupart du temps, mais « la plupart du temps » n’est pas une garantie : une demande ambiguë, une erreur de raisonnement ou un texte piégé dans un fichier lu peuvent l’emporter. Une permission digne de ce nom est vérifiée par le CODE du harnais, à chaque appel, quoi que le modèle ait décidé.

Où placer le contrôle ?

Bonne nouvelle : vous connaissez déjà l’endroit exact. Depuis le module 2, chaque demande d’outil passe par une seule ligne, DISPATCH[block.name](block.input). C’est le point de passage obligé entre ce que le modèle VEUT faire et ce que le programme FAIT. Un contrôle placé juste avant cette ligne voit passer toutes les actions, sans exception, et n’a besoin de rien savoir du reste de la boucle.

Vérifiez votre compréhensionCheck your understandingVerifique su comprensión

Pourquoi une phrase comme « Ne supprime jamais de fichier » dans la consigne système ne suffit-elle pas à protéger vos fichiers ?

À retenir

Un agent sans contrôle exécute tout ce que le modèle demande. La sécurité ne se délègue pas au modèle : elle se code dans le harnais, au seul point de passage de toutes les actions, juste avant le dispatch.