Exporter et importer un portfolio
Un portfolio se transporte d'un environnement HocNota à un autre — de la recette vers la production, d'une organisation vers une autre — dans un fichier .hnp (HocNota portfolio).
Ce que contient le fichier
Le fichier contient tout ce qu'il faut pour recréer le portfolio, sans aucune donnée :
| Contenu | Repris |
|---|---|
| Le portfolio | Graphe complet (nœuds, liaisons, notes), description, limite de durée, sortie JSON des annotations |
| Les agents | Définition complète : rôle, objectif, contraintes, prompt, passes d'extraction |
| Les bases de connaissances | Paramètres seuls : type, découpage, modèle d'embedding, options RAG, profil RAG. Ni documents ni index |
| Modèles IA, d'embedding, OCR, de décision, profils RAG | Leur nom, pour retrouver leur équivalent à l'import |
| Compétences, connecteurs MCP, paquets HNS | Leur nom seulement (un connecteur ne transporte jamais ses secrets) |
Ne sont pas repris : les documents et index des bases, les jobs et leur historique, la mémoire des agents, les données produites par les nœuds HNS, les équipes et les clés API qui ont accès au portfolio.
Le fichier est un document JSON lisible.
Exporter
Deux accès :
- dans le Designer, le menu ⋯ d'un portfolio → Exporter (.hnp) ;
- dans l'éditeur, le bouton ⤓ de la barre du haut. L'export reprend la version enregistrée : enregistrez d'abord vos modifications en cours.
Il faut pouvoir lire les agents et les bases de connaissances du portfolio : le fichier en contient la définition.
Portfolio qui en exécute d'autres
Un portfolio qui contient un nœud Pipeline n'embarque pas le portfolio qu'il exécute : chaque sous-portfolio a son propre fichier .hnp. L'export ouvre alors une fenêtre qui liste tous les fichiers — le portfolio exporté, puis chaque sous-portfolio, même indirect. Téléchargez-les un par un ou avec Tout télécharger.
Importer
Dans le Designer, ouvrez le dossier de destination puis cliquez Importer un portfolio et choisissez le fichier .hnp. HocNota analyse le fichier et vous montre, avant de rien créer, ce qu'il va faire.
Portfolios utilisés
Pour chaque sous-portfolio :
- Fournir son fichier .hnp… — le sous-portfolio est importé avec le portfolio (et ses propres sous-portfolios vous sont demandés à leur tour) ;
- ou associez-le à un portfolio existant de cet environnement ;
- ou laissez-le vide : le nœud Pipeline sera à reconfigurer.
Agents
Pour chaque agent du fichier, choisissez :
- Créer depuis le fichier — un nouvel agent est créé avec la définition exportée ;
- ou un agent existant, utilisé à sa place dans le portfolio.
Un agent existant du même nom est proposé par défaut. La création demande le droit d'écrire les agents.
Bases de connaissances
Même choix : créer la base (paramètres seuls, sans documents) ou utiliser une base existante. Une base créée est vide : ajoutez-y ses documents puis lancez l'indexation.
Sans l'option Indexation avancée, une base créée ne reprend pas ses paramètres avancés (récupération contextuelle, reranking, parent/enfant, moteur de parsing OCR) : la note du portfolio importé le signale.
Modèles et réglages
Pour chaque modèle IA, modèle d'embedding, modèle OCR, modèle de décision, profil RAG ou espace de stockage cité, HocNota propose son équivalent d'après le nom (puis le nom du modèle chez le fournisseur). Vous pouvez en choisir un autre, ou Aucun : le réglage par défaut s'applique alors.
Introuvables dans cet environnement
Les compétences, connecteurs MCP et paquets HNS ne s'importent pas depuis un portfolio. S'ils existent ici sous le même nom, ils sont repris ; sinon le nœud concerné est laissé vide.
Après l'import
Le portfolio importé :
- est créé inactif, dans le dossier affiché, avec les agents et les bases créés ;
- n'est exposé ni à l'API ni en serveur MCP — à réactiver dans ⚙ si besoin ;
- s'ouvre directement dans l'éditeur.
Quand quelque chose n'a pas pu être repris, une note orange est posée en haut du graphe et liste ce qui reste à faire : compétence, connecteur MCP ou paquet HNS à installer, sous-portfolio non importé, modèle sans équivalent, base à alimenter, rédacteurs et fichier externe d'un nœud HNS à redéfinir. Une fois le portfolio complété, supprimez la note.
Si un nom est déjà pris, l'élément importé reçoit le suffixe « (import) ».