⚙️ Comment ça marche
Ce guide est écrit avec l’aide d’agents IA ; son auteur relit et valide chaque modification avant publication. Cette page explique qui fait quoi, et ce que l’IA n’a pas le droit de faire.
Trois rôles bien séparés
| Qui | Ce qu’il fait | Ce qu’il ne fait pas |
|---|---|---|
| Une collecte, sans IA | Relève les nouvelles versions, les failles de sécurité, les nouveaux modèles et l’actualité des fabricants, puis écarte ce qui ne compte pas selon des règles fixes | Elle ne juge pas si une page est fausse |
| Un agent IA (vault-watch-agent) | Repère les passages devenus faux, propose un nouveau texte et sa source, vérifie ses propositions sur l’ensemble du guide, traduit les changements en anglais | Il ne modifie aucun fichier lui-même et ne publie rien |
| Un humain, l’auteur | Lance l’agent, relit chaque proposition, autorise la publication | Il ne recopie pas la veille à la main |
Un programme ordinaire applique ensuite les corrections acceptées. Il refuse toute correction dont le texte cité ne se trouve pas exactement une fois dans la page : l’IA ne peut donc pas réécrire un passage qu’elle aurait mal lu. C’est le principe du human-in-the-loop, l’humain dans la boucle.
Comment les projets s’articulent
Deux projets travaillent ensemble : le guide contient les pages, les règles éditoriales et la liste des sources à surveiller, et l'agent collecte la veille puis fait le travail d’analyse. Un troisième, le moteur de publication, transforme les pages en site web.
flowchart TB
S["Sources publiques<br/>versions, failles, modèles"]
subgraph G["Le guide"]
W["Collecte de la veille<br/>sans IA"]
I["Issue GitHub<br/>la liste à traiter"]
R["Pages actuelles<br/>et règles éditoriales"]
C["Contrôles automatiques<br/>et pull request"]
end
subgraph A["L'agent vault-watch"]
N["Tri et propositions sourcées"]
X["Vérification sur tout le guide"]
T["Application des corrections<br/>et traduction anglaise"]
end
H1{{"Relecture humaine"}}
H2{{"Accord pour publier"}}
E["Moteur de publication"]
Site["Site en ligne"]
S --> W --> I --> N --> X --> H1
R -. "lues à chaque passage" .-> N
R -. "lues à chaque passage" .-> X
H1 -->|"corrections acceptées"| T --> H2
H2 -->|"oui"| C --> E --> Site
classDef human fill:#fff4d6,stroke:#a65f00,color:#3d2a00
class H1,H2 human
Les règles éditoriales restent dans le guide et l’agent les charge à chaque passage : il n’en garde pas de copie qui pourrait diverger.
Chronologie d’une mise à jour
- Le lundi matin, une semaine sur deux, la collecte relève les changements des 15 derniers jours. Elle tourne toute seule sur GitHub. Les autres semaines, elle n’intervient que si une faille grave n’est pas couverte par le guide.
- Elle ouvre une issue GitHub publique qui liste les éléments à examiner, et l’auteur en est averti par e-mail.
- L’auteur lance l’agent à la main. C’est un choix, pour surveiller le budget : l’interface affiche une estimation du coût de la passe avant son lancement. Ce démarrage pourrait être automatisé si besoin, sans supprimer les deux validations humaines qui suivent.
- L’agent trie les éléments : à corriger, à ajouter peut-être, ou sans intérêt pour le guide.
- Il propose des corrections. Chacune cite le texte actuel mot pour mot, donne le nouveau texte et une source.
- Il se relit. Une nouvelle passe compare chaque correction à l’ensemble du guide français et aux sources sur le web, puis la garde, la révise ou la rejette.
- Première pause : la relecture. L’auteur accepte tout, rien, ou une sélection. L’agent peut attendre plusieurs jours sans rien perdre.
- Les corrections acceptées sont appliquées sur une branche séparée, et les pages anglaises sont mises à jour.
- Les contrôles s’exécutent : métadonnées, schémas, traductions, liens externes des pages modifiées.
- Deuxième pause : l’accord pour publier. Rien ne quitte la machine de l’auteur avant ce feu vert.
- La pull request passe les contrôles de GitHub, puis l’auteur la fusionne.
- Le site se met à jour automatiquement après la fusion.
Les erreurs signalées suivent le même chemin : elles sont vérifiées sur des sources primaires, puis passent par la même relecture et la même pull request. Deux autres travaux aussi : alléger les pages quand elles s’alourdissent, et chercher ce qui manque au guide (détail).
Une IA dans le cloud pour un guide sur l’auto-hébergement ?
Oui, et il vaut mieux le dire. L’agent appelle les modèles Claude par l’API d’Anthropic, un service cloud. Il ne traite que le contenu de ce guide, destiné à être public, et aucune donnée confidentielle : la question de la souveraineté ne se pose donc pas comme pour des dossiers médicaux ou juridiques. Ce choix n’est pas un conseil pour vos données sensibles, que ce guide vous aide justement à garder chez vous.
Ce que coûte l’entretien
Coût des appels à l’API Claude au tarif public, mesuré en novembre 2026, avec Claude Opus 5.5 pour le tri (effort moyen), les propositions et la vérification (effort élevé), et Claude Sonnet 5.5 pour la traduction (effort moyen). Un autre modèle ou un autre niveau d’effort donnerait d’autres chiffres :
| Passage | Coût |
|---|---|
| Veille avec de simples extraits des pages | 0,90 $ |
| Veille complète, avec vérification sur tout le guide | 2,95 à 4,45 $ |
| Correction d’erreurs relevées, 26 corrections | 6,60 $ |
| Recherche de ce qui manque : les pistes, puis les ajouts pour 2 à 5 pistes | 2,28 $, puis 8,70 à 12,95 $ |
| Allègement des pages, avec Claude Fable 5.2 : le rapport, puis 30 constats traités | 6,28 $, puis 18,87 $ |
Le journal public détaille chaque appel, avec son modèle et son coût.
Ces montants sont indicatifs : c’est ce que valent les appels au tarif public de l’API. Ceux de l’auteur sont passés par l’accès API de son abonnement Claude : il a payé son abonnement, rien de plus.
Les limites
- Des erreurs restent possibles. Vérifiez les sources citées avant de vous appuyer sur un chiffre, et signalez une erreur si vous en trouvez une.
- Les dates sont difficiles. Une version logicielle a une date de création, de marquage et de publication. Quand ses sources ne tranchent pas, l’agent s’abstient.
- L’agent n’écrit pas de nouvelles pages. Il peut ajouter aux pages existantes ce qui leur manque, après vérification sur le web et relecture. Quand un sujet demande une page à lui, il le signale ; l’écrire reste un choix éditorial.