Documentation BizCortex

Onglet Sources : d’où viennent les mises à jour

Connectez des documents, des versions logicielles, des tickets de support et des questions de lecteurs comme sources de propositions de modification.

Les sources alimentent la mise à jour automatique des Notices. BizCortex lit ce que fournit une source, vérifie si cela concerne les instructions destinées à l’utilisateur et, le cas échéant, rédige une proposition de modification. Rien n’est appliqué sans validation. L’onglet affiche une carte par type de source.

Onglet Sources : d’où viennent les mises à jour
Capture de cet écran

Qui peut l’utiliser

  • Propriétaire et Administrateur pour ajouter, configurer, alimenter et interroger les sources
  • Toute personne disposant de l’autorisation de lecture sur les sources des Notices peut consulter

Étapes

  1. 1. Ajouter une source

    Cliquez sur le bouton plus d’une carte, par exemple "Ajouter Versions GitHub". Remplissez la boîte de dialogue et enregistrez.

  2. 2. Configurer le webhook (GitHub et GitLab)

    Après la création d’une source GitHub ou GitLab, BizCortex affiche l’URL et le secret du webhook. Le secret n’est affiché qu’à ce moment ; copiez le avant de fermer la boîte de dialogue. Saisissez l’URL et le secret dans les paramètres de webhook du dépôt et choisissez l’événement releases. Les nouvelles versions arrivent alors immédiatement.

  3. 3. Enregistrer des identifiants

    Cliquez sur "Identifiants" sur une source GitHub, GitLab ou de tickets et enregistrez un jeton d’API avec accès en lecture. Cliquez sur "Enregistrer le jeton". Un jeton enregistré n’est plus jamais affiché ; un nouveau jeton le remplace.

  4. 4. Téléverser des documents

    Sur une source Documents, déposez des fichiers PDF, DOCX, Markdown ou texte (jusqu’à 50 Mo chacun) dans la zone de téléversement. BizCortex indique combien d’éléments ont été saisis.

  5. 5. Récupérer, mettre en pause et contrôler les éléments

    Cliquez sur "Récupérer maintenant" pour lire une source immédiatement. Cliquez sur "Mettre en pause" pour arrêter une source et sur "Reprendre" pour la relancer. Cliquez sur "Éléments" pour voir ce que la source a fourni et ce qu’il en est advenu.

  6. 6. Supprimer une source

    Cliquez sur le bouton de suppression et confirmez. Les propositions déjà créées sont conservées.

Champs et options

Documents

Téléversez des avis de modification, des bulletins de service ou des modifications de conception. Un même fichier téléversé deux fois n’ajoute rien.

Versions GitHub

Nouvelles versions logicielles d’un contrôleur ou d’une application. Saisissez le dépôt sous la forme propriétaire/nom. Facultatif : "Inclure les préversions". BizCortex vérifie toutes les 30 minutes et accepte aussi le webhook.

Versions GitLab

Versions issues de GitLab, y compris auto hébergé. Saisissez le dépôt et l’"Adresse du serveur" (par défaut gitlab.com).

Tickets de support

Tickets résolus de Zendesk, Freshdesk, Zammad ou Jira. Choisissez le système et un filtre facultatif, par exemple une étiquette ou une vue. Par défaut, seuls les tickets résolus des 30 derniers jours sont lus, avec une vérification toutes les 60 minutes. Un ticket ayant reçu une nouvelle réponse est relu.

Questions de lecteurs sans réponse

Les questions auxquelles la notice n’a pas pu répondre sont regroupées chaque nuit en propositions de comblement. Chaque notice ne peut avoir qu’une seule source de ce type.

Statut

Active, En pause ou Erreur. La dernière erreur est affichée sur la source. Une source en erreur repasse à Active après la prochaine récupération réussie.

Compteurs

Nombre total d’éléments et de nouveaux éléments, ainsi que la date de la dernière récupération de la source ou "jamais récupérée".

Statut des éléments

Nouveau, Non pertinent, Traité, Doublon ou Échec.

Bon à savoir

  • Les données personnelles sont supprimées avant l’enregistrement d’un élément et avant qu’un modèle d’IA ne le voie : adresses email, numéros de téléphone, IBAN, noms suivant une formule de salutation, blocs de signature, mentions et tout nom que le service d’assistance a associé au ticket.
  • Un élément n’est transformé en proposition que s’il est pertinent et concerne les instructions destinées à l’utilisateur. Les brouillons très incertains sont écartés.
  • Le téléversement et la récupération exigent l’autorisation d’écriture sur les sources des Notices ; l’ajout, la mise en pause et la suppression de sources ainsi que l’enregistrement de jetons exigent l’autorisation d’administration des sources des Notices. Par défaut, ces deux autorisations sont attribuées au Propriétaire et à l’Administrateur.

Voir aussi