Paquets HNS
Un paquet HNS apporte à vos agents des outils de calcul sur mesure, écrits en Python par un développeur, autour de données importées d'un fichier — typiquement un classeur Excel complexe (catalogue, simulateur, barème).
Là où une base de connaissances aide l'agent à retrouver du texte, et une compétence lui apporte une méthode, un paquet HNS lui donne des réponses calculées : « prix d'une commande de 200 pièces livrée à telle date par tel fournisseur » est obtenu par un outil qui interroge la base, jamais deviné par le modèle.
D'où viennent les paquets
Un paquet est développé hors de HocNota, dans un projet séparé, avec le framework Framework HNS — son guide décrit tout le parcours, de la création du projet à la mise en production. Le développeur y écrit :
- les étapes d'import : comment transformer le fichier source (ex. le classeur Excel) en données (ex. une base SQLite) ;
- les outils offerts à l'agent, avec leurs paramètres ;
- les consignes données à l'agent ;
- éventuellement des données initiales, utilisées tant qu'aucun import n'a eu lieu ;
- un jeu de questions de référence pour vérifier les résultats avant livraison.
Il en produit une archive .hnpkg, que vous importez ici.
Importer un paquet
Manager → Outils → Paquets HNS → Importer une archive : choisissez l'archive et l'espace de stockage. L'archive est entièrement vérifiée avant d'être enregistrée (structure, absence de code compilé, cohérence du manifeste).
Réimporter un paquet du même nom ajoute une nouvelle version — il faut alors incrémenter le numéro de version dans le projet.
Approbation
Un nouveau paquet ne s'exécute qu'après approbation par un administrateur (Admin → Compétences → Paquets HNS en attente d'approbation), qui peut d'abord demander une revue de sécurité par l'IA.
Cette approbation se donne une seule fois : les versions suivantes d'un paquet approuvé sont en service dès leur import, sans nouvelle validation. Testez donc une mise à jour avant de l'importer. En cas de problème, supprimez la version fautive dans la fiche du paquet : la précédente reprend la main.
Utiliser un paquet
Dans l'éditeur de pipeline, ajoutez un nœud HNS, choisissez le paquet, reliez-le à un agent et — pour permettre la mise à jour des données depuis le chat — au nœud Document support, ou choisissez un fichier d'un dossier externe, relu à chaque lancement et réimporté s'il a changé. Les données, leurs versions et les droits d'écriture se gèrent dans ce nœud. Si le script d'import échoue, le job s'arrête avec le message du script (voir Quand le script échoue).
Fiche d'un paquet
Elle présente les versions (en service, remplacée, examinée par un administrateur), les fichiers attendus, les étapes d'import, les outils et les consignes, les pipelines qui l'utilisent, et permet d'essayer un outil sur les données initiales du paquet. Un paquet utilisé par un pipeline ne peut pas être supprimé ; il peut être désactivé.
Sécurité
Le code d'un paquet s'exécute dans le bac à sable de HocNota : sans accès réseau, sans secret, système de fichiers en lecture seule, ressources limitées, et tout ce qu'il écrit est détruit après chaque exécution. Les outils ne peuvent pas modifier les données : seule une étape d'import, déclenchée par un fichier d'un rédacteur autorisé ou par un responsable depuis l'éditeur, produit une nouvelle version.