Comment construire une base de données avec Claude et Obsidian
Dans la vidéo « Études scientifiques », je montre la base que j’ai construite à partir de mes lectures : une fiche par document, des notions reliées entre elles, et un assistant qui rédige en citant les pages. Ce guide explique comment en construire une du même type, étape par étape, avec ce qu’il faut demander à Claude.
C’est une version simplifiée de ce que j’ai fait. Les demandes de ce guide ont été essayées sur une petite base de trois articles. Quatre ont dû être reformulées avant de donner le résultat annoncé : vous lisez les versions corrigées. Pour l’une d’elles, le réglage d’Obsidian, l’affichage n’a pas été vu.
Ce qu’il faut
- L’application Claude pour ordinateur (Windows 10 ou plus récent, macOS 13 ou plus récent), avec un abonnement payant. J’utilise son onglet Code, où Claude lit et écrit les fichiers d’un dossier de votre ordinateur.
- Obsidian, un logiciel de prise de notes. Chaque note y est un fichier, et il dessine les liens entre les notes sous forme de carte.
- Quelques documents que vous avez déjà lus, en PDF.
Vous n’avez pas besoin de savoir programmer. En revanche, Claude écrit et lance lui-même de petits programmes sur votre ordinateur, par exemple pour sortir le texte d’un PDF ou contrôler une citation. Au départ, choisissez le mode « Manual » : Claude demande alors votre accord avant de modifier un fichier ou de lancer une commande. Si vous ne comprenez pas ce qu’il propose, demandez-lui de l’expliquer avant d’accepter.
J’ai tout fait avec Claude. Un autre assistant capable de lire et d’écrire les fichiers d’un dossier conviendrait peut-être ; je ne l’ai pas essayé.
1. Préparer le dossier
Créez un dossier pour un thème, et mettez-y vos PDF. Choisissez des études, des synthèses écrites par des spécialistes pour un large public (celles du Conseil scientifique de l’Éducation nationale, par exemple) ou des livres. Un support de formation peut servir de point de départ, jamais de preuve.
Dans l’onglet Code de Claude, avant votre premier message, choisissez ce dossier avec le sélecteur de dossier, sur la ligne sous la zone de saisie. Puis demandez :
Dans ce dossier, crée un sous-dossier « documents » pour mes PDF, et range-y ceux qui sont ici. Ces documents ne doivent jamais être modifiés. Fais aussi une copie de sauvegarde du dossier « documents » dans « sauvegarde ».
Vous obtenez un sous-dossier « documents », qui ne doit plus être modifié, et sa copie. Vérifiez que les deux contiennent tous vos PDF. Je garde ma propre copie en dehors du dossier de travail.
2. Faire extraire le texte
Les fiches s’écrivent à partir du texte des documents, page par page. Il faut d’abord sortir ce texte des PDF.
Vérifie ce qu’il faut sur mon ordinateur pour lire le texte de ces PDF, et dis-moi ce qui manque avant d’installer quoi que ce soit. Puis recopie le texte de chaque PDF dans un dossier « texte », un fichier par document, en marquant le début de chaque page. Certains PDF sont en deux colonnes : vérifie sur une page de chacun que le texte se lit dans l’ordre, sans mélanger les colonnes.
Claude doit vous dire ce qui manque avant d’installer quoi que ce soit ; pendant l’essai, rien n’était à installer. Vous obtenez un dossier « texte », un fichier par document, avec un repère au début de chaque page. Ce numéro est le rang de la page dans le fichier, qui n’est pas toujours celui imprimé dans la revue.
Vérifiez sur une page que vous connaissez que le texte se lit dans l’ordre. Pendant l’essai, un article en deux colonnes est d’abord sorti mélangé.
Un document scanné, c’est-à-dire une photo de pages, ne contient pas de texte. Il demande un logiciel de reconnaissance de caractères, que Claude vous proposera d’installer. Ma base en contient, mais cette étape n’a pas été essayée sur la petite base. Dans un texte reconnu ainsi, les chiffres et les noms propres peuvent être déformés.
3. Une fiche par document
On commence par un survol : le résumé, l’introduction et la conclusion.
Pour chaque document, écris une fiche dans un dossier « fiches », à partir du texte extrait seulement : de quel type de document il s’agit (étude, synthèse, article de position), sur qui ou sur quels travaux il porte, ce qu’il trouve, ce qu’il ne permet pas de conclure. Lis le résumé, l’introduction et la conclusion. N’écris aucun chiffre. Si une information n’est pas dans ce que tu as lu, écris « non lu » ; si le document dit qu’elle manque, écris « non rapporté ». En tête de fiche, écris « niveau : survol ».
Vous obtenez une fiche par document, sans aucun chiffre. « Non lu » veut dire que l’information se trouve peut-être dans le document, mais pas dans ce que Claude a lu. « Non rapporté » veut dire que le document lui-même ne la donne pas. Une fiche de survol compte beaucoup de « non lu » : elle dit ce qu’elle n’a pas lu.
Vérifiez au moins une fiche contre un document que vous connaissez bien. Une fiche de survol ne se cite pas. Pour publier, il faut lire le document en entier : la fiche devient alors une lecture complète, et chaque chiffre y porte sa page.
4. Ouvrir la base dans Obsidian
Sans réglage, la carte d’Obsidian montre tout : les PDF, les textes et les fiches. Avant d’ouvrir le dossier dans Obsidian, demandez à Claude :
Je vais ouvrir ce dossier dans Obsidian. Règle-le pour que la vue en carte ne montre que les fiches, celles des documents comme celles des notions, pas les documents ni le texte extrait. Dis-moi ce que je dois voir à l’écran pour vérifier que le réglage a pris.
Claude écrit le réglage dans les fichiers d’Obsidian du dossier, puis vous dit ce que la carte doit montrer : seulement les fiches. Ouvrez ensuite le dossier dans Obsidian comme « coffre », le nom qu’Obsidian donne à un dossier de notes (option « Open folder as vault » de sa gestion des coffres), et vérifiez la carte à l’écran. Pendant l’essai, seul le fichier du réglage a été contrôlé, pas l’affichage.
5. Relier les notions
Crée une fiche par notion qui revient dans les fiches, dans le dossier « fiches ». Relie chaque fiche de document aux notions qu’elle traite, et les notions entre elles, avec un lien qui porte un nom (« repose sur », « favorise », « limite »). N’écris un lien que si une fiche le dit déjà, et note laquelle. Ne modifie pas les fiches de documents pour créer un lien : s’il manque une phrase, dis-le-moi.
Vous obtenez des fiches de notions. Chaque lien y porte un nom et la fiche qui l’appuie. Quand une phrase manque pour écrire un lien, à vous de voir si le document la contient. Pendant l’essai, Claude l’a signalé au lieu de l’inventer.
La dernière phrase de la demande vient de l’essai. Sans elle, Claude avait ajouté des phrases à une fiche de document pour pouvoir y accrocher des liens.
Sur la carte d’Obsidian, un lien apparaît comme un trait, sans son nom. Le nom se lit dans la fiche.
Pendant la construction de ma base, un contrôle a montré que beaucoup de liens disaient plus que leurs fiches. C’est de là que vient l’étape suivante.
6. Faire vérifier par une autre conversation
Une fiche ou un lien écrit par une IA peut dire plus que le texte. Ouvrez une nouvelle conversation, qui n’a pas écrit les fiches (bouton « + New » de la barre latérale, ou Ctrl+N sous Windows), choisissez le même dossier, et demandez :
Tu n’as pas écrit ces fiches. Compare chaque fiche et chaque lien au texte extrait du document. Signale toute phrase ou tout lien qui dit plus que le texte, avec la page. Ne corrige rien.
Vous obtenez une liste de remarques, avec la page du texte. Elle n’est pas complète (voir la partie 9). Pendant l’essai, sur trois fiches de survol, leurs notions et leurs liens, cette vérification a relevé cinq passages qui disaient plus que le texte, dont deux liens. Une fiche affirmait par exemple que les enseignant·es observé·es passaient aux activités pratiques une fois les bases apprises. L’article de Rosenshine (2012) parle seulement de beaucoup de ces enseignants.
Vérifiez chaque remarque dans le texte, puis décidez de la correction.
7. Passer au RAG
Un RAG (de l’anglais retrieval-augmented generation) est un assistant qui cherche d’abord dans vos documents, puis rédige à partir de ce qu’il y a trouvé. Ici, il suffit de donner une fois à Claude des règles de réponse :
Quand je te pose une question sur ce thème : cherche d’abord dans les fiches et le texte extrait ; recopie mot pour mot l’extrait qui appuie chaque phrase, avec sa page ; écris un petit programme qui vérifie que chaque extrait existe à la page dite ; indique pour chaque phrase s’il s’agit d’un résultat, d’un lien affirmé par un auteur ou de ta synthèse ; si les documents ne disent rien, réponds « les documents ne le disent pas ». Écris ces règles dans un fichier « regles.md » pour que je puisse te les redonner.
Vous obtenez un fichier « regles.md », à redonner à Claude au début de chaque conversation, et un petit programme qui contrôle les extraits. Testez ensuite deux sortes de questions : une dont vous connaissez la réponse, et une que vos documents ne traitent pas.
En suivant regles.md : (1) que disent ces documents sur les exemples résolus ? (2) que disent-ils sur l’effet de la musique en classe sur l’attention ?
Pendant l’essai, la première question a reçu neuf phrases, chacune avec son extrait et sa page, et le programme a retrouvé les neuf extraits. Il a aussi repéré une majuscule ajoutée dans un extrait. La seconde question a reçu « Les documents ne le disent pas ».
Le programme prouve qu’un extrait existe à la page dite. Il ne prouve pas que la phrase de Claude lui est fidèle : c’est le rôle de la vérification de l’étape 6, et de votre relecture.
8. Préparer une formation
C’est l’usage pour lequel j’ai construit ma base. La vidéo montre mon premier dossier : j’avais donné un thème à Claude, il avait affiché les notions reliées sur la carte, et j’avais choisi, parmi ses propositions, celles qu’on gardait. Partir de la carte a laissé de côté des documents utiles, que rien n’y reliait. J’ai donc changé l’ordre : le plan d’abord, avant toute recherche.
- Fixez le public, la durée, ce que les participant·es doivent savoir faire en sortant, et les parties.
- Demandez à Claude si la base couvre chaque partie bien, un peu ou pas du tout.
- Comblez une partie mal couverte avant d’écrire : avec des documents déjà présents, ou de nouvelles sources que vous choisissez. Si rien ne se trouve, gardez la partie en disant ses limites, présentez-la comme votre expérience, ou retirez-la.
- Ensuite seulement, Claude rédige le dossier avec les règles de l’étape 7, et une autre conversation le vérifie. Après trois passages, je retire une phrase que sa source contredit.
Cette étape n’a pas de demande type : elle n’a pas été essayée sur la petite base.
9. Ce que la méthode ne fait pas
- Elle ne remplace pas la lecture. Les fiches et les réponses sont écrites par une IA, et c’est le document d’origine qui fait foi.
- La vérification par une autre conversation laisse passer des erreurs. Sur des dossiers de ma base, la plupart des remarques d’une dernière lecture n’avaient été signalées par aucun des passages précédents.
- Une fiche qui n’a pas été vérifiée contre son texte ne sert pas à publier.
- Je n’ai pas mesuré ce que coûte une base en usage de l’abonnement.
- L’essai des demandes a été fait par Claude lui-même, sur un ordinateur déjà équipé, sans document scanné. Personne qui découvre l’application ne l’a encore suivi.
10. Commencer petit
Un thème, trois à cinq documents que vous avez déjà lus. C’est assez pour passer par chaque étape, et pour juger les fiches, puisque vous connaissez les documents.