Aller au contenu

⚙️ 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

QuiCe qu’il faitCe qu’il ne fait pas
Une collecte, sans IARelè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 fixesElle 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 anglaisIl ne modifie aucun fichier lui-même et ne publie rien
Un humain, l’auteurLance l’agent, relit chaque proposition, autorise la publicationIl 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

  1. 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.
  2. Elle ouvre une issue GitHub publique qui liste les éléments à examiner, et l’auteur en est averti par e-mail.
  3. 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.
  4. L’agent trie les éléments : à corriger, à ajouter peut-être, ou sans intérêt pour le guide.
  5. Il propose des corrections. Chacune cite le texte actuel mot pour mot, donne le nouveau texte et une source.
  6. 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.
  7. Première pause : la relecture. L’auteur accepte tout, rien, ou une sélection. L’agent peut attendre plusieurs jours sans rien perdre.
  8. Les corrections acceptées sont appliquées sur une branche séparée, et les pages anglaises sont mises à jour.
  9. Les contrôles s’exécutent : métadonnées, schémas, traductions, liens externes des pages modifiées.
  10. Deuxième pause : l’accord pour publier. Rien ne quitte la machine de l’auteur avant ce feu vert.
  11. La pull request passe les contrôles de GitHub, puis l’auteur la fusionne.
  12. 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 :

PassageCoût
Veille avec de simples extraits des pages0,90 $
Veille complète, avec vérification sur tout le guide2,95 à 4,45 $
Correction d’erreurs relevées, 26 corrections6,60 $
Recherche de ce qui manque : les pistes, puis les ajouts pour 2 à 5 pistes2,28 $, puis 8,70 à 12,95 $
Allègement des pages, avec Claude Fable 5.2 : le rapport, puis 30 constats traités6,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.

Donner mon avis

Tout est facultatif : une seule réponse suffit. Ce site n'envoie rien : c'est vous qui envoyez, par le moyen de votre choix.

Votre notePas de note
Votre avis porte sur
Sur quoi ? (plusieurs choix possibles)
Ce qui sera envoyé
Envoyer par e-mail

Privé, sans compte : ouvre votre messagerie avec le message prêt, pour ia-on-prem@damien.becherini.fr.

Ouvrir un ticket GitHub ↗

Public, avec un compte GitHub. Vous relisez le ticket avant de le publier.

Pour le coller où vous voulez.

Donnez au moins une note, un sujet ou un message pour pouvoir envoyer.