Apprendre un sujet avec votre assistant

Dites à votre assistant IA ce que vous voulez apprendre et à partir de quelles sources. Il en tire une courte leçon, la joue avec vous une question à la fois, puis fait revenir les idées clés les jours suivants. Ni enseignant ni terminal : l'assistant dialogue avec Studium par MCP (Model Context Protocol, le moyen par lequel un assistant appelle des outils extérieurs).

Cela fonctionne dans Codex, Claude Code et tout assistant capable d'utiliser un serveur MCP. Pour brancher Studium, voir harnais.

Le parcours de l'apprenant autonome : une demande, des références choisies, des passages exacts, un brouillon de l'agent, la relecture du plan, puis la séance.

1. Demander

Formulez-le simplement, par exemple :

Je veux apprendre le cycle de l'eau avec Studium. Voici deux pages auxquelles je fais confiance : .

L'assistant commence par get_study_plan, dans votre langue. Si une de vos leçons couvre déjà le sujet, il vous la propose ; sinon il en prépare une. Indiquez ce que vous savez déjà, le temps dont vous disposez par jour ou une date visée : l'assistant est alors invité à ouvrir la leçon par deux courtes questions sur vos acquis. Ces deux questions sont jouées une fois et ne reviennent jamais en révision. Ce que vous savez et ce qui vous intéresse orientent le brouillon mais ne sont pas conservés ; la leçon ne garde que vos minutes par jour et votre date visée, et le plan d'étude se sert des minutes pour dimensionner chaque étape.

Studium fournit aussi les prompts learn et review, qui formulent cette demande à votre place. Dans Claude Code, les prompts MCP apparaissent comme des commandes slash (/mcp__studium__learn avec la configuration d'exemple).

2. Choisir les sources et leurs licences

C'est vous qui choisissez les sources ; l'assistant les récupère avec ses propres outils (web, fichiers) et transmet leur texte à prepare_sources, qui les découpe en passages numérotés. Une source est traitée comme une donnée : une consigne écrite dans une page n'est jamais suivie.

Limite Valeur
Sources par leçon jusqu'à 20
Texte au total jusqu'à 200 000 caractères
Licence un identifiant comme CC-BY-4.0 ou Public-Domain ; unknown si rien n'est indiqué

Précisez la licence de chaque source : elle est recopiée dans la leçon et affichée avec la source. Un texte du domaine public se réutilise librement ; un PDF d'éditeur ou une licence NC, ND ou inconnue restreint ce que vous pouvez faire du résultat. La leçon reste dans votre bibliothèque personnelle et n'est jamais publiée, mais l'usage de la source sous ses conditions vous revient. Une source cohérente donne souvent une meilleure leçon que plusieurs.

3. Relire le plan

L'assistant rédige la leçon et appelle create_lesson. Studium la vérifie avant d'écrire quoi que ce soit : chaque citation doit correspondre à un passage au caractère près (seuls les espaces insécables, les suites d'espaces et les apostrophes typographiques sont tolérés), rien ne doit rester inachevé et l'ordre des notions doit tenir. L'assistant corrige ce que Studium refuse. Studium peut aussi avertir, par exemple quand la leçon dure plus que vos minutes par jour ou qu'aucune question ne vérifie un prérequis.

La leçon est écrite dans votre bibliothèque, ~/.studium/library/<cours>/lesson.json, quel que soit le dossier de leçons que le serveur lit par ailleurs.

Vous voyez ensuite le plan : titres des scènes, types de scènes et notions, jamais une réponse. S'il ne correspond pas à ce que vous vouliez, dites-le ; l'assistant reprend le brouillon et reconstruit la leçon.

4. Jouer, dans le chat ou dans VS Code

Dans le chat, chaque étape arrive prête à lire : son titre, la question, la façon d'y répondre (une lettre, un chiffre de 0 à 4 ou vos propres mots) et, sur sa dernière ligne, où vous en êtes (étape 2/6 · 4 min · à toi de répondre). Répondez vous-même : l'assistant transmet vos mots et ne doit ni répondre, ni choisir, ni noter à votre place.

La carte des notions (demandez « où en suis-je ? ») nomme chaque notion avec son identifiant, par exemple « Nombres quantiques (c-nombres-quantiques) : à venir ». Si vous connaissez déjà une notion que la carte ne montre pas acquise, ou doutez d'une notion qu'elle montre acquise, dites-le : l'assistant la conteste pour vous avec submit_response {kind: "contest", concept_id, claim} (known ou unsure), et jamais de lui-même. Votre déclaration ne change rien à votre maîtrise et ne saute aucune scène. La leçon s'ouvre sur une ligne, « Contrôle sur « Nombres quantiques » : 2 questions. Ta déclaration ne change rien à ta maîtrise ; la leçon reprend ensuite où tu étais. », pose une ou deux questions de contrôle sur cette notion, évaluées comme toute réponse (la dernière ligne dit contrôle 1/2), puis reprend où vous étiez. En formulaires, refusez le formulaire et dites-le dans la conversation.

Si chaque réponse tarde, jouez la leçon dans une session neuve et courte, sur le modèle rapide de votre assistant (dans Claude Code, claude --agent studium-lesson) : voir Garder des réponses rapides.

Pour jouer dans VS Code, faites un clic droit sur le lesson.json de la leçon et choisissez Studium : Ouvrir cette leçon, ou suivez le lien donné par l'assistant (vscode://holobiomicslab.studium-vscode/open?bundle=<chemin absolu>). Voir VS Code. Le panneau garde sa propre progression dans le stockage de VS Code : les réponses données là n'apparaissent pas dans le plan d'étude que lit votre assistant, et inversement.

5. Lire l'avis d'autorat

Le premier écran d'une leçon rédigée par un assistant porte un avis. Sans juge modèle, il dit :

Leçon rédigée par l'IA à partir de tes sources, non vérifiée par un enseignant : chaque question cite son passage ; signale à l'agent une clé qui te semble fausse. Sans juge modèle, les scènes de production ne sont pas évaluées : compare ta réponse à la référence affichée et note ton rappel ; cette note règle tes révisions, jamais ta maîtrise. Les reproductions exécutées portent une évaluation externe.

Concrètement :

  • Qui a écrit la clé. L'assistant a rédigé les bonnes réponses. Elles citent les passages sur lesquels elles reposent, vous pouvez donc les vérifier ; une clé peut néanmoins être fausse. Sur un panneau ou un volet, la ligne au-dessus d'un verdict de quiz le dit aussi : « Évalué par la clé rédigée par l'IA — vérifie-la avec le passage cité » (une leçon que vous avez rédigée vous-même dit « Évalué par la clé que tu as rédigée » ; la leçon d'un enseignant, « Évalué par la clé de l'auteur »).
  • Ce qui est évalué. Les réponses aux quiz sont comparées à cette clé : ✓ si elles sont justes, ✗ si elles sont fausses, et une fois que vous quittez une question à laquelle vous avez mal répondu, la bonne réponse s'affiche. Vos réponses rédigées (explications, comparaisons, audits) ne sont pas notées sans juge modèle configuré (LITELLM_BASE_URL). Vous recevez les points clés et une réponse modèle pour comparer, jamais un décompte de mots-clés qui prétendrait mesurer la couverture.
  • Ce que fait votre note. Après une réponse rédigée, vous notez votre rappel : again, hard, good ou easy. Cette note fixe la date de la prochaine révision. Elle ne monte ni ne baisse jamais votre maîtrise.

Aucune clé, aucun passage cité ni aucune réponse modèle n'apparaît avant votre réponse, sur aucune surface. Ils s'affichent quand vous quittez la question ; une nouvelle tentative sur la même question les retient encore. Pour aller plus loin : honnêteté et provenance.

6. Revenir quelques jours plus tard

Ouvrez une nouvelle conversation et demandez « Qu'est-ce que je révise avec Studium aujourd'hui ? ». L'assistant appelle get_study_plan dans votre langue, qui liste les révisions dues, les leçons en cours et la leçon suivante, et nomme la seule étape à faire maintenant. start_review_session joue ensuite toutes les révisions dues, toutes leçons confondues. Voir réviser dans la durée.

Si vous reprenez simplement une leçon, son premier écran le dit et, quand des révisions sont dues, les propose au début de la séance, ou à la première pause qui suit quand la séance a commencé sur une question, une fois par séance :

Proposition : 1 notion à revoir aujourd'hui (proposition review_due:start) Tu peux accepter, ou dire « plus tard ».

Répondez avec vos mots. Si vous acceptez, l'assistant lance la séance de révision ; si vous dites « plus tard », la leçon continue. Le même genre de proposition vient à une pause, jamais par-dessus une question : jouer en formulaires quand votre client sait les afficher, la carte des notions à la fin de la leçon. Chacune n'est faite qu'une fois.

Votre progression survit par défaut aux redémarrages, dans ~/.studium. Pour la retrouver depuis un autre assistant, gardez le même dossier de données et le même identifiant : demandez à l'assistant de transmettre un learner_id stable (votre prénom, par exemple) à chaque appel.

7. Fermer ou oublier

Vous dites L'assistant appelle Effet
« On s'arrête là pour aujourd'hui. » end_session Ferme la séance et garde votre progression. Relancer la leçon la reprend.
« Efface mes données pour cette leçon. » forget_session {session_id} Efface votre progression dans la leçon, son journal d'expérience, ainsi que votre profil inter-leçons et votre historique d'étude. Irréversible.
« Efface toutes mes données Studium. » forget_session {learner_id} La même chose, plus votre progression dans toutes les autres leçons, sans leçon ouverte. Irréversible.

L'assistant montre ensuite ce qui a été effacé et ce qui reste. L'oubli ne supprime ni les leçons de votre bibliothèque (~/.studium/library/<cours>/) ni les sources préparées (~/.studium/library/_sources/), ni la conversation conservée par l'assistant. Supprimez-les vous-même si vous le souhaitez. Voir confidentialité et limites.

Exemple de conversation

Vous : Je veux apprendre le cycle de l'eau avec Studium, à partir de cette page d'encyclopédie. Elle est sous CC-BY-SA.

Assistant : J'ai préparé 4 passages et rédigé une leçon. Plan : 1. Le cycle de l'eau (introduction) · 2. L'évaporation (quiz) · 3. Condensation et nuages (explication) · 4. De la pluie aux rivières (comparaison). On commence ?

Vous : Oui.

Assistant : Leçon rédigée par l'IA à partir de tes sources, non vérifiée par un enseignant … Étape 2 sur 4. Qu'est-ce qui fait s'évaporer l'eau des océans ? A, B ou C ?

Vous : B.

Assistant : Juste. Étape 3 sur 4 : explique avec tes mots comment se forme un nuage.

Vous : La vapeur monte, se refroidit et se transforme en gouttelettes.

Assistant : Réponse enregistrée ; aucun juge ne l'a évaluée. Compare-la aux points clés et à la réponse modèle. Note ton rappel : again, hard, good ou easy ?

Vous : Good.

Assistant : Note enregistrée. Prochaine révision : . Elle règle tes révisions, jamais ta maîtrise.

Pour aller plus loin

Voir la source de cette page sur GitHub