intelligencesupport

Web

Ajoutez le dépôt GitHub d’un site, alimentez sa file de briefs : le Rédacteur web enquête, rédige, traduit puis publie chaque page par pull request.

Pour
Administrateurs et rédacteurs
Dans l’application
/web/web/[id]
Mise à jour

Voir la vidéo

Laisser le module Web écrire et publier les articles de votre site

Le module Web publie les pages de vos sites. Chaque site correspond au dépôt GitHub à partir duquel il est construit. Vous lui confiez une file de briefs, et un agent IA, le Rédacteur web, mène chacun d’eux de la recherche documentaire jusqu’à la page en ligne. Toute page rejoint le site par une pull request, fusionnée seulement une fois les vérifications propres au site passées avec succès.

Cet article s’adresse aux administrateurs et aux rédacteurs qui font vivre un site. Le module Web est réservé aux organisations : ouvrez Web dans le pilier Studio du menu de gauche.

Ce qu’il faut au préalable

Deux conditions. Votre rôle doit comporter le droit Web (voir qui peut faire quoi). Et vous devez disposer de votre propre connexion GitHub.

Cette connexion se trouve dans Mes connexions, sous Vos dépôts de sites web, ou directement sur la page Web. Elle passe par l’application GitHub de BearingBridge en deux étapes :

  1. Installer l’application GitHub sur votre dépôt : sur GitHub, choisissez votre compte personnel ou votre organisation et accordez l’accès au dépôt du site que vous souhaitez publier.
  2. Autoriser et connecter votre compte GitHub : cliquez sur Connecter GitHub, validez l’autorisation, et vous revenez sur la page Web avec vos dépôts prêts à être sélectionnés.

Votre compte GitHub doit disposer d’un accès en écriture au dépôt : publier, c’est écrire.

Ajouter un site

  1. Cliquez sur Ajouter un site dans le bandeau de la page.
  2. Sous Dépôt, choisissez l’un des dépôts que votre connexion GitHub atteint. Il en manque un ? Cliquez sur Donner à l’application l’accès à un autre dépôt sur GitHub, ajoutez-le, puis revenez.
  3. Donnez un Nom au site. L’Adresse du site est facultative, tout comme la Marque : laissez Toute l’organisation pour que le site ne dépende d’aucune marque.
  4. Cliquez sur Ajouter le site.

Le studio du site s’ouvre sur ses quatre onglets : File et test, Plan éditorial IA, Fichiers du dépôt et studio IA, et Paramètres du site. Lorsque le dépôt comporte déjà un fichier de calendrier ou un dossier de briefs, sa file d’attente est importée aussitôt.

Les paramètres viennent du dépôt

L’application lit le dépôt et propose des paramètres. Elle y cherche les noms qu’emploient d’ordinaire les dépôts éditoriaux : un CLAUDE.md ou un AGENTS.md, une charte de ton, une spécification, un mode opératoire, un registre des affirmations, un calendrier au format CSV, un dossier de briefs, un dossier et un brief de traduction par langue. Vérifiez chaque champ dans l’onglet Paramètres du site, corrigez ce qui doit l’être, puis cliquez sur Enregistrer les paramètres. Après une modification du dépôt, Les relire depuis le dépôt relit les chemins sans toucher à vos instructions ni à vos interrupteurs.

PartieChampsRôle
En têteNom, Adresse du site, Publie en tant que, Branche, Modèle d’IA par défaut, Briefs par exécution planifiée, Contexte global du siteQui crée les commits, la branche qui reçoit les pull requests, le modèle par défaut pour la rédaction et les outils IA, et le contexte permanent transmis à chaque étape.
InterrupteursActif, Relecture en 18 passes, Publie en autonomie, Fusion dès que les vérifications sont au vertSi les exécutions planifiées prennent en charge le site, si les brouillons subissent la relecture en 18 passes, si un brouillon attend une personne en relecture et si la pull request se fusionne d’elle-même.
Les règles du siteFichiers qui contiennent les règles, Registre des affirmations, Fichier de calendrier, Dossier des briefs, Dossier des pages, Dossier des brouillons, Dossier des images principalesL’emplacement de chaque élément. Cliquez sur n’importe quel fichier pour l’ouvrir ou le créer dans l’onglet Fichiers du dépôt et studio IA. Sans Dossier des images principales, l’étape de l’image principale disparaît.
LanguesLangue de rédaction des pages, Code de la langue, Autres languesLa langue source, puis une ligne par langue supplémentaire : code, nom, dossier et brief de traduction.
Instructions et publicationExécutions de rédaction, Exécutions de publication, Ligne graphique des images principales, Préfixe de branche, Message de commit, Prévenir aussiCe qu’une rédaction ou une publication modifie en plus de la page, le style des images principales (chacun doté d’un bouton Rédiger avec l’IA depuis le dépôt), ainsi que le nommage des branches, des commits et des courriels.

Les règles du site restent dans son dépôt, pas dans l’application. Vous pouvez consulter, modifier, créer ou mettre à jour chacun de ces fichiers avec l’IA dans l’onglet Fichiers du dépôt et studio IA, et pousser vos changements directement sur la branche du site.

Publie en tant que désigne le membre dont la connexion GitHub crée les commits et ouvre les pull requests. Seuls les membres ayant connecté GitHub figurent dans la liste. Les commits portent son nom : GitHub montre ainsi qui a publié quoi.

Remplir la file d’attente

La file d’attente compte un brief par page. Trois moyens permettent de l’alimenter sur la page du site.

Importer la file d’attente lit le Fichier de calendrier, un CSV doté d’une colonne brief_id. Un site sans fichier de calendrier est lu depuis son Dossier des briefs, à raison d’un brief Markdown par fichier. L’application indique combien de briefs elle a ajoutés et combien elle a mis à jour.

Rédiger un brief ouvre un formulaire dans l’onglet File et test : un Titre de travail, la Requête principale à laquelle la page répond, l’Adresse de la page, une Date prévue et le Brief proprement dit. Cliquez sur Générer ou améliorer le brief avec l’IA pour que l’IA rédige ou affine le brief selon le ton et les règles du site avant de l’ajouter.

Plan éditorial IA ouvre un onglet dédié où vous choisissez un modèle d’IA, le nombre d’articles à planifier et un axe thématique ou un contexte particulier. Cliquez sur Générer le plan éditorial complet avec l’IA pour produire un calendrier multi-articles complet avec titres de travail, requêtes cibles, adresses et briefs Markdown complets. Vous pouvez retoucher chaque carte dans l’aperçu, puis cliquer sur Enregistrer le plan dans le dépôt et l’ajouter à la file pour écrire les fichiers de briefs et les lignes du calendrier sur GitHub et les charger d’un coup dans la file.

La file propose trois filtres (À publier, Publiés et Tous) ainsi qu’un champ de recherche. Les briefs sont traités dans l’ordre de leur date prévue, puis de leur place dans la file.

Les étapes d’un brief

Sélectionnez un brief dans la file pour ouvrir son panneau de contrôle à droite. Avant de le lancer, vous pouvez choisir le Modèle d’IA pour ce brief et ajouter un Contexte ou des instructions supplémentaires pour ce brief. Cliquez ensuite sur Tester sur ce brief (s’arrête à Relecture) pour lancer un essai qui s’arrête à l’étape Relecture afin d’inspecter le brouillon avant toute pull request, ou cliquez sur Lancer maintenant (ou Lancer le brief suivant dans le bandeau supérieur). Les étapes s’enchaînent ensuite toutes les cinq minutes, ou sur-le-champ via Exécuter l’étape suivante.

ÉtapeCe qui se passe
RechercheL’agent lit les règles du site et remonte aux sources primaires.
BrouillonIl rédige la page dans le dossier des brouillons.
Relecture en 18 passesLe brouillon traverse 18 passes de relecture, puis une dernière qui intègre le titre SEO, la description et l’extrait. La file affiche le décompte, par exemple 7/19.
Revérification des sourcesChaque source est contrôlée une seconde fois. Un fait que l’agent ne peut confirmer à sa source est supprimé.
RelectureLe brouillon attend une approbation, ou poursuit seul (voir plus bas).
Image principaleL’image est générée avec son texte alternatif, si le site dispose d’un dossier d’images principales.
Préparation de la publicationLa page rejoint le dossier des pages ; l’agent y raccorde ses liens, son image et les pages liées que désignent les instructions du site.
TraductionChaque langue supplémentaire fait l’objet de trois passes de réécriture native.
VérificationsLes contrôles de l’application : aucun point laissé en suspens comme TODO ou TBD, aucun tiret cadratin ni demi-cadratin dans le texte, un en-tête de métadonnées sur chaque page, chaque traduction présente avec la même adresse et les mêmes champs, aucun fichier vide. En cas d’échec, l’agent corrige la cause et réessaie, deux fois au plus.
Pull requestUn seul commit réunissant tous les fichiers, sur sa propre branche, et une pull request vers la branche du site.
Vérifications du siteLes contrôles du dépôt s’exécutent sur la pull request.
PubliéLa pull request est fusionnée, et le site se déploie depuis sa branche.

Un site ne rédige qu’un brief à la fois et n’en publie qu’un à la fois : deux publications ne touchent jamais les mêmes fichiers en même temps. Si un brief est déjà en cours de rédaction, Lancer le brief suivant répond qu’il n’y a rien à lancer.

Relecture

Ce qui se joue à l’étape Relecture dépend de l’interrupteur Publie en autonomie. Activé, il laisse un brouillon aux sources revérifiées partir seul vers la publication. Désactivé, le brouillon attend une personne titulaire du droit de modification : Approuver et publier le fait avancer.

Un brouillon retenu par les règles du site affiche En suspens, avec la raison. La prochaine exécution planifiée de l’agent le reprend.

Versions audio et discussions

Deux interrupteurs des Réglages du site donnent du son à chaque nouvelle page :

  • Version audio : la page publiée est lue avec la voix de la marque du site (son identité sonore). Une page dans une autre langue que la sienne est lue par un locuteur natif de cette langue, du même genre.
  • Discussion à deux voix : deux animateurs commentent la page en deux à trois minutes, à partir de ce qu’elle dit et de rien d’autre.

Si l’un des deux est activé, le brief franchit une étape de plus, Version audio, après les traductions. Les fichiers MP3 sont enregistrés dans le Dossier audio des réglages, nommés d’après la page (<page>.mp3 et <page>-discussion.mp3), exactement comme l’image d’en-tête. Laissé vide, ce dossier est public/audio, celui que les sites Astro, Next.js et Vite servent tel quel. La page et chacune de ses traductions reçoivent un champ audio et un champ discussion dans leur frontmatter, pour un gabarit qui dessine son propre lecteur, et un lecteur HTML simple sous leur titre, qu’affiche tel quel n’importe quel site Markdown, avec ses mots dans la langue de la page. Le tout part dans la même pull request que la page.

Une page déjà publiée reçoit sa version audio depuis son brief : ouvrez-le dans la file et cliquez sur Créer la version audio. Elle produit ce que le site a activé (la seule version audio si aucun interrupteur ne l’est), envoie les MP3 et les lecteurs dans une pull request dédiée, et la page reste publiée, avec sa date, du début à la fin. L’enregistrement est facturé comme le reste du travail du Rédacteur web et ajouté au coût du brief.

Publier par pull request

Rien ne change dans le dépôt avant l’étape Pull request. Jusque-là, chaque fichier écrit par l’exécution est conservé dans l’application, et l’onglet Fichiers du brief permet de les ouvrir un à un.

À cette étape, l’application regroupe tous les fichiers du brief dans un seul commit, sur une nouvelle branche nommée d’après le Préfixe de branche et l’adresse de la page (bb/ suivi de l’adresse, sauf réglage contraire). Elle ouvre une pull request vers la branche du site, qui en énumère tous les fichiers. Si le site possède un fichier de calendrier, la ligne du brief y est mise à jour dans le même commit.

Viennent ensuite les vérifications du dépôt. Quand elles réussissent et que Fusion dès que les vérifications sont au vert est activé, la pull request se fusionne d’elle-même et la branche est supprimée. Interrupteur désactivé, la pull request attend sur GitHub que quelqu’un la fusionne, et le brief passe à Publié à ce moment-là.

Quand les vérifications échouent, l’agent en lit la raison, corrige la cause et pousse à nouveau. Il s’y reprend deux fois ; au-delà, le brief s’arrête. Un dépôt dépourvu de toute vérification est fusionné sur la foi des seuls contrôles de l’application, au bout de dix minutes. Des vérifications encore en cours au bout de 90 minutes arrêtent elles aussi le brief.

Une fois la page en ligne, un courriel part vers la personne qui publie le site, vers celle qui a lancé le brief et vers les adresses inscrites sous Prévenir aussi. Il nomme le site, la page, le brief, la pull request, les langues et le coût du brief. Chacun le reçoit dans sa langue.

Quand un brief s’arrête

Le Rédacteur web ne laisse jamais rien en suspens. Un fait qu’il ne parvient pas à confirmer est vérifié à la source ou supprimé, jamais signalé pour plus tard. Lorsqu’une étape ne peut pas aboutir, le brief s’arrête sur Arrêté, la raison s’affiche en tête de son détail, et rien n’en est publié.

Causes fréquentes : des vérifications qui échouent encore après deux corrections, une pull request fermée sans avoir été fusionnée, un site sans personne pour le publier, une connexion GitHub disparue chez la personne qui publie. Un incident passager, comme un appel au modèle resté sans réponse, est retenté à l’exécution suivante, trois fois avant que le brief ne s’arrête.

Réglez la cause, puis cliquez sur Reprendre. Le brief repart de l’étape où il s’était arrêté.

Remarque : Lorsque le plafond de dépenses de l’organisation est atteint, le brief ne s’arrête pas. Il se met en pause et reprend dès que la marge le permet.

Suivre un brief

Cliquez sur un brief de la file pour en afficher le détail à côté : les étapes, l’étape en cours mise en évidence, puis les informations et les actions.

  • Journal : chaque étape, avec l’heure et ce que l’agent a fait ou constaté.
  • Versions : le texte après chaque passe, du premier brouillon à chaque passe de traduction. Cliquez sur l’une d’elles pour la lire.
  • Fichiers : chaque fichier écrit par l’exécution, y compris ceux qu’elle a supprimés. Cliquez sur l’un d’eux pour le lire, ou pour voir l’image.
  • Brief et IA : le fichier Markdown du brief lui-même, que vous pouvez lire, modifier ou améliorer avec l’IA et enregistrer dans le dépôt.

Le détail renvoie aussi vers la pull request, par exemple Pull request #42, et affiche le Coût du brief à ce stade.

Les autres actions dépendent de l’avancement du brief. Ignorer met un brief de côté, Retour à la file d’attente l’y remet. Retirer le sort de la file. Un brief en cours de publication ne peut être ni ignoré ni retiré avant que sa pull request soit terminée.

L’agent Rédacteur web

Lancer les briefs à la main suffit. Pour qu’un site publie à intervalles réguliers, ajoutez le Rédacteur web depuis le catalogue des agents. Comme tout agent standard, il ne fait rien tant que personne ne l’a ajouté. Son code de catalogue est MK13, et il s’exécute par défaut toutes les 24 heures.

Chaque exécution planifiée lance le brief suivant de chaque site actif. Sur un site qui publie en autonomie, elle fait aussi avancer les brouillons en attente de relecture. Sur les autres, ses constats énumèrent les brouillons qui attendent encore une approbation. Décochez Actif dans les paramètres d’un site : les exécutions de l’agent le laissent de côté.

Pour chaque brief, le Rédacteur web emploie le Modèle d’IA pour ce brief si vous en avez choisi un, sinon le Modèle d’IA par défaut du site, puis le modèle choisi sur l’agent, et enfin le modèle retenu par votre organisation pour Web sur la page Modèles d’IA (ou Claude Opus à défaut). Les images principales sont générées par un modèle d’image distinct.

Les compétences appliquées

Les passes de relecture et de traduction suivent quatre compétences standard, réunies dans le groupe Publication web du catalogue des compétences. Elles s’appliquent là où figure Web :

CompétenceCe qu’elle fixe
Norme de rédaction journalistique (anglais américain)Les règles de chaque relecture : une prose de rédaction américaine, l’orthographe américaine, aucun tiret cadratin, aucun fait inventé.
Norme de traduction nativeChaque page traduite se lit comme l’œuvre d’un journaliste de langue maternelle, avec la ponctuation propre à la langue et des champs SEO réécrits.
Marqueurs d’IA à supprimerLes tournures qui trahissent un texte écrit par une machine, traquées par les passes de relecture et de traduction.
Norme des images principalesL’allure d’une image principale, et son texte alternatif dans chaque langue.

Elles s’appliquent telles quelles jusqu’à ce que votre organisation en ajoute une à ses compétences et la réécrive. La version personnelle de la personne qui publie l’emporte sur celle de l’organisation. Les fichiers de règles du site priment toujours là où ils sont plus stricts. Voir les compétences.

Ce que cela coûte

Chaque appel au modèle, chaque recherche web et chaque image d’une exécution sont imputés au brief concerné. La file affiche le total cumulé sur chaque ligne, et le détail le reprend sous Coût : le prix qui vous est facturé, tout compris. Le courriel de publication le rappelle.

Les exécutions sont facturées à votre organisation, quelle que soit la personne qui a lancé le brief, et figurent dans le journal d’utilisation sous Web · page documentée, rédigée et publiée. Tant qu’un brief tourne, sa progression apparaît aussi dans Activité. Ajouter un site, importer une file d’attente ou rédiger un brief ne coûte rien.

Retirer un site ou un brief

Retirer ce site, au bas des paramètres, sort le site et sa file de l’application. Retirer, sur un brief, le sort de la file. Ni l’un ni l’autre ne touche au dépôt : ses pages, ses briefs et son calendrier restent en place. Un site ne peut pas être retiré pendant qu’une de ses pages est en cours de publication.

Déconnecter GitHub dans Mes connexions interrompt tous les sites publiés au moyen de votre connexion, jusqu’à ce que quelqu’un se connecte à nouveau et soit désigné sous Publie en tant que.

Qui peut faire quoi

Le module Web dispose de sa propre ligne dans la grille des droits. Voir rôles et droits.

DroitCe qu’il permet
VoirOuvrir la page Web, les sites et leurs files d’attente.
CréerAjouter un site, rédiger un brief ou en lancer un.
ModifierImporter la file d’attente, changer les paramètres d’un site, exécuter l’étape suivante, approuver, reprendre ou ignorer un brief.
SupprimerRetirer un site ou un brief, jamais quoi que ce soit dans le dépôt.

Le module Web est réservé aux membres d’une organisation.