Bienvenue dans votre brain

Ce guide vous accompagne pas à pas pour exploiter au mieux votre brain, comprendre ce qu’il fait, comment l’alimenter, comment garantir la fiabilité des réponses, et comment le connecter à vos outils.

Aucune connaissance technique n’est nécessaire pour lire ce guide.

Premiers pas

Cinq étapes pour démarrer, même si c’est votre première visite :

1Connectez-vous
Cliquez sur Se connecter, identifiez-vous avec Logto.
2Choisissez un brain
Le sélecteur en haut à gauche liste les brains auxquels vous avez accès.
3Posez une question
Tapez votre question dans Chat, lisez la réponse + cliquez sur les citations [N] pour voir les sources.
4Notez la réponse
👍 ou 👎 sous chaque réponse pour aider à curer le brain.
5Explorez
Brain View 3D pour la vue d’ensemble, Crystals pour les synthèses, Parcours pour des cheminements thématiques.

Vous pouvez revenir sur ce guide à tout moment via le bouton ? en haut à droite du cockpit.

Qu’est-ce qu’un brain ?

Un brain est une mémoire d’expertise structurée partagée par une équipe ou une organisation. C’est l’équivalent d’un classeur intelligent qui regroupe tout ce qu’on sait sur un sujet : documents, recommandations, règlements, savoir-faire interne, retours d’expérience, articles de synthèse, chiffres clés.

La différence avec un drive ou un wiki : chaque fait est rattaché à sa source, étiqueté par sujet, et noté en confiance. Quand vous interrogez le brain en langage naturel, il vous répond en citant précisément d’où vient l’information, ce qui rend les réponses vérifiables.

┌─────────────┐   ┌─────────────┐   ┌─────────────┐
│   Sources   │──▶│   Claims    │──▶│  Crystals   │
└─────────────┘   └─────────────┘   └─────────────┘
       │                 │                 │
       └─────────► Brain (mémoire) ◀───────┘

Concrètement, un brain est l’endroit où votre équipe peut poser une question comme « quel est le tarif CCAM pour un détartrage ? » et obtenir une réponse sourcée, à jour, et auditée — au lieu de fouiller cinq documents PDF.

Les concepts clés

Quelques notions à comprendre pour vous repérer dans l’interface :

Brain (ou espace)

Le périmètre fonctionnel — par exemple « Santé » ou « Agence ». Chaque brain a son propre contenu, ses propres droits d’accès, et ses propres règles de qualité.

Source

Un document d’origine : page web, PDF, note interne, transcription. Toutes les informations du brain remontent à au moins une source.

Claim (fait)

Une affirmation extraite d’une source : « le code HBJD001 vaut 28,92 € ». Chaque claim porte un score de confiance et un cycle de vie (brut → consolidé → cristallisé).

Crystal (synthèse)

Un article rédigé qui agrège plusieurs claims sur un même sujet, avec citations vers les sources. C’est la forme « article wiki » des connaissances stables.

Lesson (leçon)

Une erreur observée structurée en trois temps : l’erreur elle-même, son impact, et le bon comportement à adopter. Distillée à partir d’une réunion ou d’une note, elle remonte dans le chat et la recherche au même titre qu’un claim — pour ne pas refaire deux fois la même erreur. Toutes les leçons d’un brain sont regroupées dans la page Leçons (« Erreurs & bons réflexes ») du menu.

Topic

Une étiquette thématique (ex : « nomenclature », « RGPD », « prévention »). Aide à classer, filtrer et naviguer.

Parcours de lecture

Une séquence guidée de crystals pour aborder un sujet complexe étape par étape.

Trust (confiance)

Un niveau (authentique / standard / contestée / rejetée) attaché à chaque source par un administrateur. Pondère les réponses du chat.

MCP

Le protocole qui permet à un brain de répondre à Claude Desktop, Cowork, ou tout assistant compatible — sans copier-coller.

┌────────────┐     ┌────────────┐
│  Source A  │ ◀── │   Claim 1  │ ──┐
└────────────┘     └────────────┘   │
                                    ▼
┌────────────┐     ┌────────────┐  ┌──────────┐
│  Source B  │ ◀── │   Claim 2  │─▶│ Crystal  │
└────────────┘     └────────────┘  └──────────┘
                                    ▲
┌────────────┐     ┌────────────┐   │
│  Source C  │ ◀── │   Claim 3  │ ──┘
└────────────┘     └────────────┘

Le cockpit pas à pas

Une fois connecté, vous arrivez sur le cockpit (/app). La barre latérale gauche montre, pour le brain actif, les 6 espaces principaux :

Chat — poser une question en langage naturel, obtenir une réponse sourcée.
Explore — naviguer par topic (sujets thématiques).
Sources — la liste de tous les documents ingérés.
Crystals — les articles de synthèse publiés.
Leçons — le registre des « erreurs & bons réflexes » du brain (cf. concept Lesson).
Parcours de lecture — les cheminements curés.
Brain View — la carte mentale du brain en 3D.

Pour passer d’un brain à un autre, utilisez le sélecteur « Brain actif » en haut de la barre latérale.

Poser une question (Chat)

Tapez votre question dans le champ en bas et appuyez sur Demander. Le brain :

Recherche les claims et sources les plus pertinents (recherche hybride).
Demande à un modèle de langage de rédiger une synthèse uniquement à partir des extraits trouvés.
Annote chaque affirmation avec un numéro [1], [2], etc., reliée à la source correspondante.

La section « Sources » sous la réponse liste chaque citation. Cliquez sur le titre d’une source pour ouvrir sa fiche complète dans le brain.

Question utilisateur
       │
       ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  Retrieval   │──▶ │  Rédaction   │──▶ │  Réponse +   │
│  (hybride)   │    │   par LLM    │    │  citations   │
└──────────────┘    └──────────────┘    └──────────────┘

Donner son avis sur une réponse

J’approuverenforce la confiance des sources citées.

Signaler un problèmeouvre un formulaire avec 4 options : une source est fausse, un claim est faux, il manque une source, ou autre commentaire.

Les votes sont pondérés par votre rôle : l’avis d’un admin pèse plus que celui d’un lecteur. Mais tout le monde peut voter — c’est ce qui rend la curation utile.

Sources : ajout & gestion

Une source est l’unité de base : un document de référence à partir duquel des faits peuvent être extraits. Pour ajouter une source, ouvrez la page Sources et cliquez sur + source (visible uniquement si vous avez le droit d’écrire dans ce brain).

Quatre types de sources sont supportés :

URL — page web, document en ligne. Une URL peut être configurée pour être recrawlée automatiquement (quotidiennement / hebdomadaire / mensuel).
PDF — upload local. OCR appliqué si nécessaire.
Markdown — coller du contenu directement (notes, mémo).
Transcription — texte d’un enregistrement (réunion, interview).

Une fois ajoutée, la source passe par queued → processing → ingested. Vous verrez ensuite les claims extraits dans l’admin (/admin/claims), et la source apparaîtra comme citable dans le chat.

+ source ───▶ queued ───▶ processing ───▶ ingested
                                              │
                                              ▼
                                       claims extraits

File de validation

Quand le brain extrait des faits d’une nouvelle source (un compte-rendu de réunion, par exemple), ces faits arrivent « à valider ». La File de validation est l’endroit où vous les passez en revue un par un et décidez de leur sort. C’est ce qui permet au brain de grandir au-delà de son contenu initial, en restant fiable.

Vous n’avez jamais à manipuler de jargon technique ici. Chaque carte se résume à un choix : Confirmer, Supprimer ou Modifier.

Les 3 verbes

Confirmer

Le fait est juste : vous le validez tel quel. Il devient exploitable par le chat et la recherche.

Supprimer

Le fait est faux ou inutile : il est écarté et n’apparaîtra plus dans les réponses.

Modifier

Le fait est presque bon : vous décrivez la correction souhaitée. Une reformulation est alors préparée en arrière-plan (voir « Modification en cours » ci-dessous).

« Modification en cours »

Quand vous demandez une Modification, l’assistant prépare une reformulation en arrière-plan. Pendant ce temps, la carte affiche un badge « Modification en cours » et passe en lecture seule : vous ne pouvez pas empiler deux demandes sur le même fait. Une fois la reformulation prête, le fait redevient disponible dans votre file : vous pouvez alors le confirmer, le supprimer ou redemander une modification. (Un écran dédié pour relire et accepter ou refuser la suggestion arrivera dans une prochaine version ; pour l’instant elle sert de point de départ et le fait reste à valider normalement.)

Valider plus vite

Mode batch — cochez plusieurs cartes fiables et confirmez-les toutes en une fois, plutôt qu’une à une.
Priorité aux faits imprécis — la file remonte d’abord les faits qui gagneraient à être précisés (un code, un montant, une valeur manquante), pour que vous traitiez les plus utiles en premier (cf. les concepts).
Vos choix sont sauvegardés — vous pouvez quitter et revenir plus tard (même sur un autre appareil) sans perdre vos décisions en attente. Rien n’est appliqué tant que vous n’avez pas validé.

Rappel par emailun digest périodique vous prévient quand des éléments attendent votre validation — vous pouvez en régler la fréquence ou le désactiver.

Aujourd’hui la file passe en revue les claims (les faits). La validation des leçons et des propositions de confiance des sources arrive dans une étape ultérieure.

Promotion de claims

Un fait utile au-delà de son brain peut être promu vers le brain parent, pour qu’il profite à tous les brains qui en héritent (voir Héritage des brains). C’est le mécanisme qui fait remonter une bonne pratique d’un brain spécialisé (N3) vers un brain de secteur (N2), puis d’un secteur vers le socle commun (N1).

La promotion se fait toujours vers le parent direct uniquement. On ne saute pas de niveau : un fait N3 passe d’abord par son N2 avant de pouvoir atteindre le N1. Réserver à un rôle curate (curateur), admin ou superadmin.

À l’approbation, le fait est recopié dans le brain parent (l’original reste en place), avec ses preuves (extraits, page PDF…), et sa traçabilité est conservée (qui a promu, depuis où, quand).

Le cycle d’une demande de promotion

pending / detected — en attente de décision (une demande proposée par un curateur, ou un candidat repéré automatiquement).
deferred — mise de côté pour plus tard.
abstraction_requested — on demande à généraliser la formulation avant de promouvoir (ex. « chez nous » → « dans un centre pluri-professionnel »).
approved — approuvée : le fait est créé dans le brain parent.
edit_approved — approuvée après reformulation.
rejected — refusée (avec une raison).
non_promotable — jugée non promouvable (trop locale, par exemple).

Les quatre derniers états (approved, edit_approved, rejected, non_promotable) sont définitifs : une demande qui les atteint est close.

  N3 (spécialisé)        N2 (secteur)         N1 (socle commun)
┌────────────────┐     ┌────────────┐        ┌────────────┐
│  claim validé  │ ──▶ │  promotion │  ──▶   │  promotion │
└────────────────┘     │  N3 → N2   │        │  N2 → N1   │
                       └────────────┘        └────────────┘
        (copie + preuves, parent DIRECT uniquement)

Curation & contrôle qualité (Trust)

La qualité d’un brain dépend de la qualité de ses sources. Le système Trust Control (accessible aux admin / curate via la barre latérale) vous permet de noter, contester ou rejeter chaque source.

Les 4 niveaux de confiance

Authentique — boostée à la recherche (+0,3). À réserver aux sources officielles, peer-reviewed, datées.

Standard — niveau par défaut, neutre pour la recherche.

Contestée — pénalisée à la recherche (-0,3) + badge orange dans les citations. À utiliser quand on n’est plus sûr.

Rejetée — exclue totalement du chat. Reste visible dans l’interface Trust Control pour révision.

Comment changer le niveau d’une source

Ouvrez la fiche de la source (admin ou utilisateur).
Section « Niveau de confiance », choisissez un niveau dans le menu déroulant.
Pour contestée ou rejetée, une raison est obligatoire.
Cliquez Enregistrer. Le changement est instantané et logué.

Le Hub Trust Control

La page Trust Control (sidebar) montre :

Catalogue — toutes les sources / claims / crystals triés par confiance ascendante (les plus douteux en premier), avec filtres par type et recherche.
File d’attente — tous les signalements faits depuis le chat ou les articles. Vous pouvez résoudre ou ignorer chaque entrée.

Confiance héritée & override par brain

Le niveau de confiance se propage le long de la chaîne d’héritage : si une source est marquée authentique dans un brain de secteur (N2), les brains qui en héritent (N3) en profitent automatiquement, sans avoir à la re-noter.

Mais chaque brain peut surcharger (override) ce niveau localement, et c’est le plus spécifique qui gagne. Concrètement : si un brain descendant marque une source rejetée, ce choix l’emporte sur le niveau hérité du parent — utile pour écarter chez soi une source que le secteur juge encore acceptable. Vous ne taguez donc qu’une seule fois, à l’endroit qui vous concerne.

Anonymisation & RGPD

Pour les brains sensibles — typiquement un brain santé comme Avident — le brain ne doit jamais stocker de nom de patient identifiable. À chaque ingestion d’une source (transcription, note, réunion, PDF), une étape de pseudonymisation automatique remplace les noms de personnes par des pseudonymes stables (PATIENT_001, PATIENT_002, …) avant toute extraction de faits.

Pseudonymisation NER

Une détection des noms de personnes (NER) repère les patients et les tiers, puis les remplace par un pseudonyme. Les faits stockés ne contiennent jamais le nom réel.

Whitelist des pros

Les professionnels du centre (coordinatrices, praticiens…) sont préservés grâce à une liste blanche : leurs noms restent lisibles, car ce sont des références métier, pas des données patient.

Vault chiffré

La correspondance pseudonyme ↔ nom réel est conservée dans un coffre chiffré, accessible au seul superadmin pour audit. Rien n’est stocké en clair.

En clair : posez une question au chat et il répondra toujours en parlant de PATIENT_001 — jamais d’un vrai nom. C’est une garantie de conformité RGPD intégrée au brain, pas une option à activer après coup.

Corrections de terminologie

Les transcriptions automatiques se trompent souvent sur le vocabulaire métier (« lécor » pour inlay-core, « panneau » pour pano…). Le brain peut normaliser ce vocabulaire à l’ingestion : vous déclarez une fois un terme erroné → terme correct, et la correction s’applique automatiquement à toutes les sources ingérées ensuite.

Sans cela, ces erreurs se propageraient partout (faits mal libellés, recherche qui ne retrouve rien parce qu’on cherche « inlay-core » alors que le brain a « lécor »). Les corrections couvrent le vocabulaire mais aussi les noms propres mal transcrits, et sont héritées le long de la chaîne (une correction posée au niveau secteur profite aux brains descendants).

Depuis une carte de la file de validation, un bouton « Corriger la terminologie dans tout le brain » permet d’ajouter une correction en un clic. Réservé aux rôles curate / admin.

Héritage des brains (N1 / N2 / N3)

Les brains s’organisent en niveaux : un socle commun (N1), des brains de secteur (N2), et des brains spécialisés / clients (N3). Un brain peut hériter de son brain parent, de façon ascendante uniquement : un N3 voit ce que son N2 expose, et un N2 voit ce que son N1 expose.

Local vs Universal (le scope)

local

Visible uniquement dans le brain où le contenu a été créé (et dans ses enfants directs). C’est le niveau par défaut.

universal

Destiné à être hérité par tous les descendants, même lointains. C’est ainsi qu’une règle transverse remonte sans polluer les brains enfants avec du contenu trop spécifique.

Ce qu’un brain descendant voit d’un ancêtre

De son propre brain : tout son contenu.
De son parent direct : tout son contenu (un brain de secteur est fait pour nourrir ses brains enfants).
De ses ancêtres plus lointains (grand-parent et au-delà) : uniquement le contenu marqué universal — le contenu local d’un ancêtre lointain reste privé.
Jamais le contenu d’un brain « frère » : deux brains qui partagent le même parent ne se voient pas l’un l’autre.

Dans le chat, une citation issue d’un brain parent est signalée comme héritée (par exemple « via N2 Santé »), pour que vous sachiez d’où vient l’information.

        N1 socle commun ── universal ─┐
              │  (local: privé)        │ hérité
        N2 secteur ── local + universal ┤  par
              │  (parent direct)         │  le N3
        N3 spécialisé ── tout son contenu┘

   frères de N3  ✗  jamais visibles entre eux

Crystals : articles de synthèse

Un crystal est un article wiki rédigé à partir de plusieurs claims convergents. Il représente la connaissance stable sur un sujet : une fois « cristallisé », un savoir est facile à diffuser sans repasser par toutes les sources brutes.

Sur la page d’un crystal, vous trouvez :

Le résumé et le contenu détaillé.
Les topics liés dans la colonne de droite.
Les citations [N] renvoyant aux sources d’origine.
Un bouton Signaler une erreur en bas pour remonter une incohérence aux administrateurs.

Si un sujet n’a pas encore son crystal, c’est qu’aucune synthèse n’a été générée. Les administrateurs peuvent en créer manuellement, ou le moteur de cristallisation le générera quand assez de claims convergents seront extraits.

Brain View : la carte mentale

La Brain View visualise l’ensemble du brain comme un graphe 3D animé. Chaque nœud est une source, un claim, un crystal ou un topic. Les arêtes relient les éléments qui partagent un même sujet.

Quatre modes disponibles :

3D (par défaut) — graphe spatial avec orbit/zoom.
Graph 2D — version sigma.js plus performante.
Atlas — cards crystals positionnées par cluster.
Hiérarchie — arborescence Topic → Crystal → Claim → Source.

Cliquez sur un nœud pour ouvrir un panneau de détails (incoming / outgoing edges, statut, lifecycle).

Parcours de lecture

Un parcours de lecture est une séquence ordonnée de crystals — pensez à une playlist d’articles pour appréhender un sujet. Chaque brain en propose plusieurs par défaut.

Ouvrez un parcours pour le démarrer. Vous progressez d’étape en étape sans perdre le fil narratif. Les administrateurs peuvent créer ou modifier des parcours depuis /admin/paths.

Connecter votre brain (MCP)

Le protocole MCP (Model Context Protocol) permet à des assistants externes — par exemple Claude Desktop ou Cowork — d’interroger votre brain comme s’ils étaient connectés à votre base de connaissances interne.

Pour Claude Desktop

Ouvrez les paramètres de Claude Desktop > Connectors / MCP servers.
Ajoutez un nouveau serveur HTTP avec cette URL :
https://mcp.brain.w3art.io/mcp
Authentification : Bearer token (token OIDC Logto délivré par votre admin).
Validez. Claude Desktop charge la liste des outils exposés (survolez chaque nom pour une description) :list_brainssearch_brainget_sourceget_claimlist_recent_claimspropose_claim
Vous pouvez désormais poser des questions à Claude qui pourra interroger votre brain automatiquement.

Pour Cowork ou un autre assistant

Tout assistant compatible MCP HTTP peut se brancher. Demandez à votre administrateur un token Bearer si vous ne l’avez pas. La même URL /mcp est exposée à tous les clients.

Les permissions s’appliquent : un assistant ne pourra interroger que les brains auxquels vous avez accès. Les sources rejetées sont automatiquement exclues.

Rôles & permissions

Quatre niveaux d’accès par brain :

Lecture — voir le contenu, poser des questions, voter 👍/👎.
Contribution — ajouter des sources et des notes.
Curation — modifier des claims, valider, signaler des incohérences, résoudre des feedbacks.
Admin — contrôle total sur ce brain : changer le niveau de confiance des sources, archiver, gérer les accès.

Au niveau de la société, vous pouvez aussi être :

Admin de société — peut inviter des utilisateurs à votre organisation et leur attribuer des accès brain. Page : /org/<votre-slug>/team.
Curator — accès en lecture / contribution étendu.
Member — accès standard.

Glossaire

Tous les termes importants utilisés dans ce guide, classés par ordre alphabétique :

Brain: Espace de mémoire structurée scoped à une organisation ou un sujet.
Citation [N]: Lien numéroté qui pointe une affirmation vers sa source.
Claim: Affirmation factuelle extraite d’une source.
Confidence (confiance): Score 0–1 attaché à un claim et aux sources.
Crystal: Article wiki de synthèse agrégeant plusieurs claims.
Curation: Processus humain d’évaluer la qualité et la fiabilité du contenu.
Delegation: Autorisation d’un user à lire/écrire sur un brain (read / contribute / curate / admin).
Embedding: Représentation vectorielle d’un texte pour la recherche sémantique.
Héritage: Un brain enfant (N3) hérite, de façon ascendante, du contenu de son brain parent (N2) puis du socle commun (N1).
Hybrid search: Combinaison de recherche par vecteur + plein-texte + boost code-literal.
Lesson (leçon): Erreur observée structurée en trois temps — erreur, impact, bon comportement — remontée dans le chat et la recherche comme un claim.
Impersonation: Capacité réservée superadmin à « se connecter en tant que » un autre user.
Logto: Provider OIDC pour l’authentification.
MCP: Model Context Protocol — interface standard pour qu’un assistant interroge un brain.
Pin: Position fixée par l’utilisateur d’un nœud dans la Brain View.
Promotion: Recopie d’un fait validé vers le brain parent DIRECT (N3→N2, N2→N1) pour le faire bénéficier aux brains qui en héritent.
Pseudonymisation: Remplacement automatique des noms de personnes par des pseudonymes (PATIENT_001…) à l’ingestion, pour la conformité RGPD.
RLS: Row-Level Security — politique Postgres qui filtre les rows par identité.
Scope (local / universal): Portée d’un contenu : « local » reste dans son brain (et ses enfants directs), « universal » est hérité par tous les descendants.
Source: Document d’origine (URL, PDF, markdown, note).
Superadmin: Rôle global avec accès à toutes les orgs et tous les brains.
Topic: Étiquette thématique partagée par plusieurs claims/crystals.
Trust (niveau de confiance): Badge appliqué à une source (authentique / standard / contestée / rejetée), héritable et surchargeable par brain.
Validation (file de): File où un utilisateur passe en revue les faits à valider via 3 verbes : Confirmer / Supprimer / Modifier.
Vault (coffre): Stockage chiffré de la correspondance pseudonyme ↔ nom réel, accessible au seul superadmin.
Vector: Embedding multi-dimensionnel pour la similarité sémantique.
Whitelist: Liste des noms (professionnels du centre) à préserver de l’anonymisation à l’ingestion.

Questions fréquentes

Le chat me dit « aucune source trouvée », pourquoi ?

Le brain ne répond qu’à partir de ce qu’il connaît. Si aucun claim ne couvre votre question, c’est qu’il faut ajouter la source manquante (cf. Sources).

Une citation est cassée / pointe vers un onglet vide

La citation pointe vers la fiche source dans le brain (pas vers l’URL externe). Si l’URL externe est cassée, l’icône ↗ à côté du titre peut le faire apparaître. Signalez-le avec 👎 pour qu’un admin actualise la source.

Pourquoi mon vote ne change pas la réponse immédiatement ?

Les votes alimentent le score de trust de la source, qui pondère le retrieval. Le chat re-classera dès la prochaine question. Pour un effet immédiat, un admin doit marquer la source contestée ou rejetée.

Comment exporter mon contenu ?

Demandez à votre superadmin : un export RGPD complet est disponible sur demande.

Une notion vous échappe ? Une fonctionnalité mériterait plus de détails ? Contactez votre administrateur ou ouvrez un retour « Autre commentaire » depuis n’importe quelle réponse de chat — l’équipe consulte la file d’attente régulièrement.