Avancé Étape 6 sur 9

Ce qui change avec un agent

Jusqu'ici, tu discutais avec l'IA : elle te donnait un texte, tu le copiais quelque part. Un agent, c'est différent : il peut lire tes fichiers, les modifier et lancer des commandes directement. Tu arrêtes de copier-coller. L'agent travaille dans ton projet.

  CHATBOT (ChatGPT web)             AGENT (OpenCode, Codex)
  ┌──────────────────────┐          ┌──────────────────────┐
  │ Tu écris une demande  │          │ Tu écris une demande  │
  │ L'IA répond en texte  │          │ L'agent lit les fichiers│
  │ Tu copies le résultat │          │ Modifie les fichiers   │
  │ Tu colles dans ton    │          │ Lance des tests        │
  │ fichier               │          │ Te montre le résultat  │
  │ Tu testes             │          │ Tu valides             │
  └──────────────────────┘          └──────────────────────┘

Les différents outils

Outil Ce qu'il fait Pour qui
ChatGPT (web) Discute, génère du texte et du code. Tu copies-colles. Tout le monde
Ollama (local) Le moteur : fait tourner des modèles d'IA sur ta machine. Gratuit, sans compte. Dev ou motivé
OpenWebUI (local) Interface web type ChatGPT, mais chez toi. Se branche sur Ollama. Dev ou motivé
OpenCode / Codex Agent de code : lit, modifie et teste tes fichiers directement. Dev
n8n (local) Automatisation visuelle : connecte tes outils sans coder. Voir page suivante. Tout le monde

Ollama et OpenWebUI vulgarisés

Ollama, c'est le moteur : il fait tourner l'IA sur ta machine. Au lieu d'aller sur le site de ChatGPT, tu installes Ollama et l'IA tourne chez toi. Gratuit, sans compte, sans envoi de données.

OpenWebUI, c'est l'interface : une page web qui ressemble à ChatGPT, mais qui tourne sur ton ordinateur. Elle se branche sur Ollama. Tu as un ChatGPT personnel, chez toi, pour tes documents confidentiels.

API, c'est la porte d'accès : elle permet à un autre programme de parler à l'IA. Par exemple, un script qui envoie un document à l'IA et récupère le résumé automatiquement.

Et pour Jean-Paul : si tu veux juste un ChatGPT chez toi pour tes documents juridiques confidentiels, installe OpenWebUI. Tu n'as pas besoin de coder. Pour l'installation, suis le tuto Installer OpenWebUI.

Préparer le terrain avant de donner accès

Avant de laisser un agent (OpenCode, Codex) toucher tes fichiers, tu dois préparer le terrain. Sinon, il peut casser des choses.

Avant de donner accès à un agent :
  • État stable : ton projet fonctionne avant que l'agent ne touche quoi que ce soit
  • Retour arrière : Git commit ou copie du dossier. Sans ça, pas d'agent
  • Fichiers sensibles identifiés : .env, mots de passe, données personnelles. L'agent ne doit pas les lire ni les modifier
  • Convention de travail : dis à l'agent ce qu'il peut faire et ce qu'il ne doit pas faire

Les niveaux d'autonomie

On ne donne pas la pleine autonomie d'un coup. On monte progressivement :

Niveau Ce que l'agent fait Ton rôle
1. Conseil Explique, propose, suggère Tu fais tout toi-même
2. Modification ciblée Modifie un fichier précis Tu vérifies le changement
3. Étape complète Réalise une étape entière (modifie + teste) Tu valides le résultat
4. Plusieurs étapes Enchaîne plusieurs étapes avec validation entre chaque Tu valides à chaque porte

Le détail des niveaux 3 et 4 (autonomie contrôlée, portes de validation) est dans la page 7.

Le contrat de travail avec l'agent

Avant de commencer une étape avec un agent, tu lui donnes un contrat : ce qu'il peut faire, ce qu'il ne doit pas faire, et quand il doit te poser une question.

Contrat de travail pour cette étape :

Tu peux modifier : [liste des fichiers ou dossiers]
Tu ne dois pas toucher : [fichiers sensibles, config, etc.]
Commandes autorisées : [ce que l'agent peut exécuter]
Tests à réaliser : [comment vérifier que ça marche]
Critères de validation : [ce qui doit être vrai pour valider]
Quand poser une question : [si tu n'es pas sûr, demande avant d'agir]
Si ça échoue 3 fois : arrête et dis-le, ne boucle pas

Éviter les erreurs d'agent

Les erreurs classiques d'un agent :
  • Réécrire trop large : tu demandes de corriger un bug, il réécrit le fichier entier
  • Supprimer du code utile : il juge une fonction inutile et la supprime
  • Modifier une config partagée : il change un fichier qui impacte d'autres projets
  • Exposer un secret : il affiche un mot de passe dans un log
  • Continuer malgré des tests en échec : il déclare "terminé" alors que les tests plantent

La parade : un contrat clair, un retour arrière avant chaque étape, et une vérification de tes yeux après chaque modification.

Mon expérience sandbox

La sandbox — OpenCode : Je suis passé de ChatGPT (copier-coller) à OpenCode (l'agent modifie les fichiers directement). C'est un changement de dimension : tu arrêtes de copier-coller, l'agent travaille dans ton projet. Mais la première fois que j'ai laissé OpenCode modifier un projet sans préparer le terrain, il a cassé des choses que je n'avais pas vues. J'ai appris : on donne l'accès quand le terrain est préparé, pas avant. Pour installer OpenCode, voir le tuto Installer OpenCode.