Neuronz.ai

Français

English

Français

English

Profils ​

Un profil est un espace de mémoire nommé, rattaché à un ou plusieurs dossiers. Presque tout ce que Neuronz.ai enregistre (mémoire, règles, connaissances, sujets, ressources) appartient à un profil, et une session ne lit et n'écrit que dans le profil auquel appartient son dossier de travail.

Fonctionnement ​

Les dossiers sont associés aux profils automatiquement. Au démarrage d'une session, le plugin cherche le profil du dossier dans lequel la session s'exécute : vous n'avez pas à en choisir un. Un dossier qu'aucune route ne couvre reçoit un nouveau profil portant son nom. Un dossier situé dans une route récursive utilise le profil de cette route ; pour lui donner son propre profil, créez-en un (voir Créer un profil).

Une route rattache un dossier à un profil. Une route indique « ce dossier appartient à ce profil ». Elle peut ne couvrir que ce dossier, ou être récursive et couvrir aussi tous les dossiers qu'il contient. Quand plusieurs routes correspondent, c'est celle du dossier le plus profond qui l'emporte. Les routes sont propres à votre compte : un collègue de la même organisation peut associer le même dossier à un autre profil, et aucun de vous ne voit les routes de l'autre.

Les routes vous suivent d'une machine à l'autre. Écrivez un dossier de votre répertoire personnel sous la forme ~/dev/myrepo (ou $HOME/dev/myrepo) : la route correspond à ce dossier sur toutes vos machines, quel que soit le nom de votre répertoire personnel, /home/you sous Linux ou /Users/you sur Mac. Les dossiers de votre répertoire personnel qui reçoivent une route automatiquement sont enregistrés de la même façon. Un / final ne change rien : ~/dev/myrepo/ et ~/dev/myrepo désignent le même dossier.

Plusieurs dossiers, un seul profil. Associez plusieurs dépôts au même profil et ils partagent la même mémoire. Avec une route récursive sur un dossier parent, chaque dépôt que vous clonerez plus tard dans ce dossier utilisera ce profil, sans autre configuration.

Mauvais profil ? Déplacez l'enregistrement. Si un fait, une action, un document ou un sujet atterrit dans le mauvais profil, ouvrez-le dans le tableau de bord, modifiez-le et choisissez un autre profil. Son historique le suit ; les liens vers des enregistrements de l'ancien profil sont supprimés.

Associer un dossier à un profil ​

Imaginons que vous rangiez tout votre travail pour le client Acme sous ~/work/acme/ et que vous vouliez qu'il partage une seule mémoire. Demandez à votre agent :

Associe ~/work/acme et tout ce qu'il contient au profil acme.

L'agent appelle set_dir_profile avec dir: "/home/you/work/acme", profile: "acme" et recursive: true. Dès la session suivante, chaque dépôt situé sous ~/work/acme/ lit et écrit dans le profil acme. unset_dir_profile supprime une route, et list_profiles liste tous les profils avec leurs routes.

Vous pouvez faire la même chose sur la page Profiles du tableau de bord : chaque profil affiche ses routes, + Route en ajoute une, et une route peut être rendue récursive ou ne plus l'être. Edit route (le crayon sur une route) change son dossier, la déplace vers un autre profil, ou active ou désactive Include subdirectories. Un dossier qui a déjà une route est refusé. Activer Include subdirectories sans rien changer d'autre vous mène à Cover subtree, qui liste les routes déjà présentes sous ce dossier et ne les fusionne qu'après votre confirmation. Combiné à une autre modification, ce changement est refusé tant que certains de ces sous-dossiers sont associés à d'autres profils : enregistrez d'abord l'autre modification, puis utilisez Cover subtree.

Créer un profil ​

Imaginons que ~/work/acme/ soit associé récursivement à acme, et que vous vouliez que le dépôt ~/work/acme/website garde sa propre mémoire. Une session démarrée dans ce dépôt utilise acme, puisque la route du parent le couvre. Dans cette session, lancez :

/neuronzai:new-profile acme-website

La commande crée le profil vide acme-website, y associe ~/work/acme/website et bascule la session en cours sur ce profil. La nouvelle route porte sur le dossier le plus profond, elle l'emporte donc : toutes les sessions suivantes dans ~/work/acme/website utilisent acme-website, tandis que le reste de ~/work/acme/ garde acme. Demandez aussi ses sous-dossiers, et la route les couvrira également.

La commande refuse un nom qui existe déjà (associez plutôt le dossier à ce profil) et un dossier qui a déjà sa propre route.

Sans le plugin, demandez à votre agent de créer le profil : il appelle create_profile avec le nom et, si vous le souhaitez, le dossier à y associer. Dans le tableau de bord, le bouton New profile de la page Profiles fait la même chose.

Un nouveau profil est vide au départ. Pour le remplir à partir de vos dépôts, de GitHub, de Notion et de vos documents, lancez /neuronzai:init-profile dans une session qui l'utilise.

Changer de profil le temps d'une session ​

Si vous avez démarré une session dans le mauvais dossier, lancez /neuronzai:switch-profile <nom>. Pour le reste de la session, la lecture et l'écriture se font dans le profil choisi. Ce changement ne vaut que pour cette session : il ne modifie pas le profil que le dossier utilisera la prochaine fois. Une session reprise conserve le changement. Lancez /neuronzai:switch-profile sans argument (ou avec reset) pour revenir au profil propre au dossier. Si le changement ne peut pas être enregistré, la commande échoue et la session garde son profil précédent. Le travail effectué avant le changement reste dans le profil où il a été fait.

Pour changer définitivement le profil d'un dossier, associez-le plutôt à un profil (voir plus haut).

Le changement synchronise aussi immédiatement les ressources du nouveau profil. Sur Claude Code, lancez ensuite /neuronzai:reload-assets pour charger les nouveaux skills sans redémarrer ; sur Oh-My-Pi, lancez /reload-plugins. Le message de changement indique ce qui s'applique. /neuronzai:reload-assets resynchronise aussi les ressources à lui seul quand le profil n'a pas changé.

Profil par défaut des conversations ​

Une conversation ou une tâche Cowork dans l'application Claude, ou une conversation sur claude.ai, n'a pas de dossier de travail : aucune route ne peut donc choisir son profil. Elle utilise à la place votre profil par défaut des conversations. Sur la page Profiles du tableau de bord, cliquez sur l'étoile de la carte d'un profil (Set as default) ; ce profil affiche alors un badge default. Un seul profil peut être celui par défaut : en choisir un autre déplace le badge. Cliquez sur l'étoile barrée du profil par défaut (Clear default) pour ne plus en avoir ; une nouvelle conversation vous demande alors quel profil utiliser.

Ce choix vous est propre : chaque collègue de la même organisation définit le sien. Le modifier ne concerne que les nouvelles conversations. Voir Choisir un profil par défaut.

Langue des enregistrements ​

Chaque profil a une langue d'enregistrement : la langue dans laquelle sa mémoire est rédigée. Quelle que soit la langue d'une session, les faits, actions et notes qui en sont tirés sont rédigés dans la langue d'enregistrement du profil, si bien que sa mémoire reste dans une seule langue. Le code, les identifiants, les messages d'erreur et les citations sont toujours conservés tels quels.

Les nouveaux profils sont en anglais par défaut. Pour changer de langue, envoyez cette requête avec une clé d'API obtenue dans Security → API keys du tableau de bord :

bash
curl -X POST "https://app.neuronz.ai/api/profiles/acme/language" \
  -H "Authorization: Bearer nzk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"language": "fr"}'

Remplacez acme par le nom du profil. language accepte un code ISO (en, fr), une locale (fr-FR) ou un nom (French) ; une valeur non reconnue revient à l'anglais.

Les enregistrements restent trouvables d'une langue à l'autre : une question en français retrouve le fait en anglais qui y répond, et inversement, sans faire remonter de résultats sans rapport. La recherche par mots-clés ignore aussi les accents : deploye correspond à déployé.