Mémoire simple

Catalogue des nœuds Intelligence artificielle

Sur cette page

Conserver le contexte d’une conversation IA.

Utilisation et spécificités

sessionKey sépare les conversations ; maxMessages borne l’historique. Choisissez l’opération de lecture, ajout ou effacement. Les variantes Redis et PostgreSQL ont besoin de leurs connexions ; la mémoire simple et le gestionnaire utilisent la base de nodulz.

Type technique : ai_simple_memory. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`operation`	`enum`	`"append"`	`load`, `save`, `clear`, `append`
`sessionKey`	`string`	`"default"`	-
`sessionScope`	`enum`	`"workflow"`	`workflow`, `shared`
`varKey`	`string`	`"ai_memory"`	-
`role`	`enum`	`"user"`	`user`, `assistant`, `system`
`content`	`string`	`""`	-
`maxMessages`	`number`	`20`	-; ≥ 1, ≤ 10000
`credentialId`	`string`	-	-

Aide de configuration

operation Opération: Charger, enregistrer, ajouter ou effacer l'historique de conversation.
sessionScope Portée de la conversation: La portée workflow isole la conversation par workflow et par nœud mémoire. La portée partagée réutilise la clé entre workflows du même propriétaire. Les nouvelles mémoires sont isolées par défaut.
sessionKey Clé de session: Identifie une session de conversation (plusieurs agents peuvent partager).
varKey Variable workflow: Variable workflow où l'historique est stocké ou lu.
role Rôle du message: Rôle du message ajouté (user, assistant, system).
content Contenu: Contenu du message à ajouter à la mémoire.
maxMessages Messages max: Nombre maximal de messages conservés dans l'historique.
credentialId Identifiant: Identifiant requis pour accéder au service externe.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "operation": "append",
  "sessionKey": "default",
  "sessionScope": "workflow",
  "varKey": "ai_memory",
  "role": "user",
  "content": "",
  "maxMessages": 20
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.