Notes

Notes de connaissance : le pourquoi qui reste

Les notes de connaissance gardent ce que votre activité a appris : décisions avec leurs raisons, hypothèses et faits de terrain, datés, signés et consultables.

En mars, un magasin de musique a cessé de vendre les cordes de guitare d'un fournisseur. Il y avait une bonne raison : trois lots défectueux en un mois, un distributeur qui refusait de les remplacer, une meilleure gamme ailleurs. En octobre, un habitué redemande cette marque, et personne au comptoir ne sait dire pourquoi elle a quitté le rayon. La décision était bonne. Le raisonnement vivait dans un fil de discussion défilé depuis longtemps.

Ce trou a une forme. La commande, le retour, l'appel au distributeur sont tous sur la chronologie, chacun daté et rattaché au bon contact. Ce qui manque, c'est ce qui les reliait : la conclusion du gérant, et pourquoi. Une activité apprend des choses en permanence, et tant que cela n'a pas de place à soi, cette couche vit dans les têtes et les fils morts, où elle s'évapore sans bruit. Il s'agit ici de donner à ce que vous apprenez un endroit où rester.

Qu'est-ce qu'une note de connaissance ?

Une note de connaissance est un morceau du raisonnement de votre activité, écrit là où vous pourrez le retrouver. C'est du markdown, donc cela peut tenir en une phrase ou une page : un titre, un corps, et le contexte qui le rend utile plus tard. À cela vous ajoutez jusqu'à vingt étiquettes, jusqu'à vingt sources externes (un lien, avec un libellé si vous voulez : l'e-mail du distributeur, une fiche technique, les conditions d'un fournisseur), et des liens vers les contacts et événements qu'elle concerne, et vers d'autres notes. Une note reste petite à dessein : un titre jusqu'à deux cents caractères, un corps jusqu'à vingt mille.

Voici la décision sur les cordes, écrite comme une note :

# Arrêt de la gamme de cordes Aurora

Trois lots défectueux en mars, tous cassés sur le mi aigu à l'ouverture.
Le distributeur a refusé de les remplacer, donc passage à la gamme Lumen,
qui tient depuis. À revoir si Aurora change de fournisseur.

Celle-là est étiquetée decision, liée au distributeur et aux trois événements de retour qui la fondent, avec l'e-mail de refus du distributeur gardé en source. Trois étiquettes portent une convention à connaître, car elles nomment les trois genres de choses qu'une activité apprend. Une decision est un choix que vous avez posé, gardé avec son contexte et sa justification. Une reflection est une hypothèse ou une analyse vivante, quelque chose que vous testez encore, comme savoir si ce quartier achète plus au printemps. Une observation est un fait de terrain : ce distributeur met trois semaines à répondre. Ce sont des étiquettes, un usage partagé plutôt que trois boutons dans l'application, et une note peut en porter d'autres à côté.

La plupart des notes ne sont pas tapées à la main. Votre assistant les capture au fil du travail, et une note qu'il écrit porte le losange ambré ◆, la marque des entrées ajoutées par un assistant : datée, signée et corrigeable, pour que vous sachiez toujours ce qui vient de vous et ce qui vient de lui. Le raisonnement est écrit, mais jamais dans votre dos.

Les trois mémoires : ce qui s'est passé, comment vous travaillez, ce que vous avez appris ?

Historis gardait déjà deux sortes de mémoire, et les notes de connaissance sont la troisième. Il vaut la peine de les voir côte à côte, car l'erreur est de demander à l'une le travail d'une autre.

La mémoireCe qu'elle contientOù cela vit
Ce qui s'est passéCommandes, appels, relances, datés et liés à un contactLa chronologie des événements
Comment vous travaillezComportements à répéter, récupérés avant que votre assistant agisseLes règles
Ce que vous avez apprisDécisions, hypothèses, faits de terrain, avec leurs raisonsLes notes de connaissance

La chronologie retient que le retour a eu lieu le quatre. Une règle retient de vérifier la note de stock avant de promettre une date. Ni l'une ni l'autre n'est faite pour tenir la phrase « on a lâché cette gamme parce que le lot était défectueux et que le distributeur refusait de le remplacer ». Ce n'est pas un événement, et ce n'est pas un comportement. C'est quelque chose d'appris, et sa place est dans une note.

La ligne de partage est encore une affaire de grammaire, le même test qui trie un fait d'une règle. « Ceci est arrivé » est un événement. « Quand X, faire Y » est une règle. « On a décidé X parce que Y », ou « X semble vrai », est une note de connaissance. Réussissez le tri et chaque mémoire reste lisible, au lieu de devenir un tiroir où tout tombe et où rien ne se retrouve.

Où vivent les notes dans l'application ?

Les notes de connaissance ont leur propre écran, atteint depuis Connaissances dans la barre latérale. Il s'ouvre sur une liste que vous pouvez chercher en plein texte et filtrer par statut (active ou archivée) et par étiquette. Ouvrez-en une et vous obtenez la note rendue depuis son markdown, ses sources en liens cliquables, ses contacts et événements liés en pastilles à suivre, sa visibilité, et, si elle a été remplacée, une bannière pointant vers ce qui l'a remplacée.

La plupart des notes arrivent par votre assistant via MCP, la même connexion faite une fois que le reste de Historis utilise, au moment où le raisonnement est frais ; l'application a aussi un bouton Nouvelle note pour les fois où vous préférez en écrire une à la main. Dans les deux cas, l'application est là où vous lisez, affinez et archivez : une fenêtre d'édition retravaille le titre, le markdown (avec un onglet écriture et un onglet aperçu), les étiquettes et les sources, et l'archivage vous demande de confirmer. Le principe est la règle de la maison, valable pour tout le produit : les écritures d'un assistant s'appliquent directement, mais elles restent visibles, attribuées, et à vous de les corriger. Il écrit le premier jet de ce que l'activité a appris ; vous le gardez honnête.

La fiche de chaque contact gagne aussi un onglet Connaissances, listant les notes liées à cette personne. Ainsi la décision sur les cordes ne vit pas seulement sur l'écran Connaissances ; elle remonte sur la fiche du fournisseur lui-même, à côté des commandes et des appels dont elle est née.

Pourquoi la suppression est-elle l'exception, pas la règle ?

Votre assistant ne peut jamais supprimer une note : la surface d'outils n'a aucune action de suppression. Vous le pouvez, depuis l'application, mais seulement une fois la note déjà archivée, un deux-temps délibéré pour qu'un raisonnement vivant ne disparaisse jamais en un clic. Pour tout le reste, le cycle de vie est archiver et remplacer, et les deux gardent l'histoire au lieu de la brûler : le raisonnement d'une activité vaut plus comme trace que comme ardoise nette.

Archiver est un changement de statut. La note reste lisible, mais elle quitte la connaissance active et la vue de recherche par défaut. C'est ainsi qu'une note prend sa retraite : toujours là quand vous la cherchez, à l'écart quand vous ne la cherchez pas.

Remplacer sert quand une décision change. Cela pointe la note dépassée vers sa remplaçante en une seule transaction : une remplaçante créée dans le même geste hérite de la visibilité de l'ancienne, de ses étiquettes et de ses liens, l'ancienne est archivée, et l'application montre une bannière de remplacement reliant les deux. Une décision qui a changé reste une décision que vous avez prise. L'ancien raisonnement n'était pas une erreur à garder ; c'est le chemin par lequel vous êtes arrivé ici. Le supprimer effacerait le pourquoi, et le pourquoi est la part qui compte ; remplacer garde toute la chaîne, datée.

Comment votre assistant trouve-t-il la bonne note au bon moment ?

Une mémoire n'aide que si elle remonte quand vous en avez besoin. Votre assistant cherche les notes avec search_knowledge, et la recherche a deux moitiés. Le plein texte tourne toujours : il racinise le français et ignore les accents, si bien qu'une recherche de « reparation » trouve l'orthographe accentuée et l'inverse. Quand votre assistant fournit aussi la requête sous forme de vecteur, calculé de votre côté avec le même fournisseur que votre worker, une branche sémantique tourne à côté de celle du plein texte et les deux classements sont fusionnés, de sorte qu'une note indexée qui veut dire la même chose sans partager un mot peut quand même revenir. Vous pouvez restreindre toute recherche par étiquette, par statut, ou à un seul contact ou événement.

L'autre moitié, c'est que la bonne note arrive souvent sans qu'on la demande. Quand votre assistant ouvre un contact avec get_person_context, jusqu'à dix notes actives liées à cette personne sont incluses, avec un total exact pour qu'il sache quand il en reste à chercher. Au niveau de l'organisation, le contexte indique à votre assistant combien de notes actives existent et l'invite à les chercher avant de vous demander quelque chose que l'activité a déjà écrit. Le raisonnement derrière la décision sur les cordes est remis à l'assistant au moment où il ouvre le fournisseur, pas laissé à trouver par hasard.

La recherche sémantique demande-t-elle une installation ?

Cette branche sémantique mérite un compte rendu clair, car elle est optionnelle et elle dépend de vous. Historis ne calcule jamais d'embedding. Il n'en fait rien tourner sur le serveur. La moitié sémantique est exactement aussi bonne que les vecteurs que produit votre propre worker d'indexation, et pas meilleure.

Ces vecteurs viennent de historis embed, une petite commande qui tourne sur votre propre infrastructure avec votre propre fournisseur d'embeddings. La clé de votre fournisseur reste chez vous ; Historis ne la voit jamais. historis embed run fait une passe et s'accommode d'un cron ; historis embed run --watch reste résident et refait une passe à l'intervalle de votre choix ; historis embed status vous dit si le contrat stocké correspond et combien de notes sont en attente. Vous déclarez le contrat, votre fournisseur et ses dimensions, une fois pour l'organisation. Modifier le contenu d'une note efface son embedding pour que le worker le recalcule à la passe suivante, et changer le contrat efface tous les vecteurs stockés pour que le worker les refasse, après vous avoir demandé de confirmer.

Voici la part honnête : si vous ne lancez jamais le worker, rien ne casse. Le plein texte trouve quand même chaque note, parce que le plein texte tourne sur chaque note. La recherche sémantique est la branche que vous activez quand vous voulez aussi la correspondance par le sens, et sa couverture grandit exactement aussi loin que votre worker a indexé. Elle se dégrade en douceur ; elle ne laisse jamais de trou. Le même principe court sous tout cela : vous apportez votre propre IA, et l'intelligence reste de votre côté de la ligne.

L'activité garde ses raisons

En octobre, l'habitué redemande les cordes, et cette fois il y a une réponse. La note est sur la fiche du fournisseur : abandonnées, et pourquoi, avec les retours liés et l'e-mail du distributeur en pièce. Le gérant la relit en une phrase et passe à autre chose. C'est le basculement. La mémoire de votre activité cesse de ne garder que ce qui s'est passé et se met à garder ce qu'elle a appris, chaque entrée datée et signée. Laissez un assistant écrire le raisonnement au fil de l'eau, et il cesse de partir avec le fil.

Questions fréquentes

Qu'est-ce qu'une note de connaissance dans Historis ?
Une note de connaissance est du markdown durable qui consigne quelque chose que votre activité a appris : une décision avec son raisonnement, une hypothèse que vous testez encore, ou un simple fait de terrain. Chaque note porte des étiquettes, des liens vers les contacts et événements qu'elle concerne, et jusqu'à vingt sources externes, et elle reste consultable. Votre assistant les écrit le plus souvent ; vous les lisez, les affinez et les archivez sur l'écran Connaissances, ou vous en écrivez une vous-même.
Quelle est la différence entre une décision, une réflexion et une observation ?
Ce sont trois étiquettes conventionnelles, un usage partagé plutôt que des boutons dans l'application. Une décision est un choix que vous avez posé, gardé avec son contexte et sa justification. Une réflexion est une hypothèse ou une analyse vivante, encore à l'épreuve. Une observation est un fait de terrain que vous avez constaté. L'étiquette dit quel genre de chose la note contient, pour la filtrer ensuite.
Puis-je supprimer une note de connaissance ?
Votre assistant, jamais : la surface d'outils n'a aucune action de suppression. Vous, oui, mais en deux temps : archivez la note d'abord, puis supprimez-la depuis l'application. Pour une décision qui a simplement changé, remplacer vaut mieux que supprimer : l'ancienne note pointe vers sa remplaçante en une seule transaction et la chaîne demeure. La règle reste de garder l'histoire ; la suppression est l'exception délibérée.
La recherche sémantique demande-t-elle une installation, et la recherche fonctionne-t-elle sans elle ?
La recherche plein texte fonctionne toujours, sur chaque note, avec la racinisation du français et l'insensibilité aux accents : rien ne dépend d'une installation. La recherche sémantique est un extra optionnel : elle a besoin de vecteurs produits par le worker historis embed, que vous faites tourner sur votre propre infrastructure avec votre propre fournisseur d'embeddings. Activez-la et la correspondance par le sens se fusionne au plein texte ; laissez-la de côté et le plein texte trouve quand même chaque note.
Qui peut voir une note de connaissance ?
Chaque note utilise la même visibilité à trois niveaux que le reste de Historis : organisation, pour que toute l'organisation puisse la lire (le choix par défaut) ; équipes, pour que seules les équipes choisies le puissent ; ou privée, pour que vous seul le puissiez. La visibilité est affichée sur la note, et quand une note est remplacée, une remplaçante créée dans le même geste hérite du même réglage.

Articles liés