Skip to main content
n8n-nodes-haki donne à n’importe quel workflow AI Agent n8n une mémoire durable, inter-sessions, sur votre propre Postgres — sans dépendance à un fournisseur, sans taxe mémoire par appel. Deux nœuds, placés autour de votre nœud AI Agent existant : l’un lit la mémoire, l’autre réécrit le tour de conversation.
Fonctionne contre n’importe quelle instance Haki que vous hébergez déjà (docker compose up). Aucun compte Haki requis — auto-hébergé de bout en bout.

​
Installation

Ou en ligne de commande, dans le répertoire de données n8n :

​
Credential — Haki API

Un seul credential, partagé par les deux nœuds :
​
string
requis
L’URL de l’API Haki, sans slash final. D’un conteneur Docker n8n vers une API Haki sur la machine hôte, utilisez http://host.docker.internal:8100 plutôt que localhost.
​
string
Clé bearer Haki. Optionnelle en développement local (l’API tourne en mode ouvert), requise dès que HAKI_ADMIN_KEY ou une clé de projet est configurée côté serveur.

​
Haki Context — à placer avant votre AI Agent

Récupère la mémoire du sujet sous forme de bloc prêt à injecter, avant l’appel au LLM.
​
string
requis
Projet Haki (portée mémoire). Jamais choisi par le modèle.
​
string
requis
Identifiant stable de la personne (sessionId, email, ID de webhook…). Vide ou "default" est rejeté.
​
string
requis
Le message courant — utilisé pour reclasser les faits pertinents.
​
number
défaut:"2000"
Budget de tokens pour le paquet de contexte retourné.
​
string
Optionnel : type de tâche (support, onboarding…), enregistré dans la trace.
Retourne context_text (à injecter directement dans le message système de votre AI Agent), le packet brut, les warnings, token_count et trace_id.

​
Haki Capture — à placer après votre AI Agent

Enregistre le tour utilisateur/assistant une fois la réponse produite.
​
string
requis
Doit correspondre au nœud Haki Context.
​
string
requis
Réutilisez celui du nœud Haki Context.
​
string
requis
​
string
requis
​
string
Optionnel — sert d’ancrage à une clé d’idempotence dérivée du run/ thread plus un hash de contenu, pour qu’une ré-exécution de la même exécution n8n ne duplique jamais le tour capturé.
​
boolean
défaut:"false"
Si activé, appelle aussi /v1/consolidate pour que la mémoire soit immédiatement récupérable — utile en dev/démo, pas nécessaire en production stable (la consolidation tourne selon son propre cycle).
​
options
défaut:"trusted"
trusted (message direct du sujet), semi_trusted (sortie agent/outil), third_party (une autre personne dans la conversation) ou untrusted (contenu ingéré). Dans un groupe où l’émetteur n’est pas le sujet suivi, choisissez third_party — le fait est attribué à ce tiers, jamais fusionné silencieusement dans la mémoire du sujet.

​
Un câblage minimal

Haki Context s’exécute en premier et transmet context_text au message système de l’AI Agent ; Haki Capture s’exécute après la réponse de l’agent, donc le tour suivant — même dans une toute nouvelle exécution — démarre avec tout ce que l’agent a déjà appris.

Workflows prêts à l'emploi

Un modèle d’agent de support persistant et un workflow de test de bout en bout sont fournis dans le répertoire integrations/n8n/ du dépôt — importez-en un directement dans n8n pour voir ce câblage tourner pour de vrai.