Persistent Memory

Stockez et rappelez des faits, des préférences et des informations sur toutes les exécutions de flux de travail. La primitive qui alimente Business Memory et User Context - et disponible directement pour n'importe quelle étape du flux de travail ou client MCP.

Qu'est-ce que Persistent Memory?

Par défaut, les données d'un flux de travail n'existent que pour cette exécution. Persistent Memory brise cette contrainte. N'importe quelle étape peut écrire une valeur nommée dans la mémoire, et toute étape future (dans le même flux de travail ou dans un processus complètement différent) peut la relire par clé.

C'est ainsi qu'un flux de travail de notation accumule des données d'étalonnage sur des dizaines d'exécutions, comment un agent de sensibilisation se souvient du ton préféré d'un utilisateur et comment un agent proactif vérifie si un seuil a été franchi hier.

Portées

Chaque entrée de mémoire appartient exactement à une seule portée. La portée détermine qui peut le lire et combien de temps il dure par rapport à un flux de travail.

espace de travail

Partagé entre tous les flux de travail et tous les utilisateurs de l’espace de travail. C'est ce que Business Memory est construit sur. Utilisez-le pour les définitions ICP, les rubriques de notation, la voix de la marque et tout ce qui devrait être cohérent avec workspace-wide. Capacité: 1 000 entrées.

flux de travail

Porté sur un seul flux de travail. Les entrées survivent lors des exécutions du même workflow mais ne sont pas visibles par les autres workflows. Utilisez-le pour les compteurs per-workflow, les données d'étalonnage et l'apprentissage run-over-run. Capacité: 500 entrées.

utilisateur

S'étendant à l'utilisateur appelant dans l'espace de travail. C'est ce que User Context est construit sur. Utilisez-le pour les préférences, les comptes détenus et l'historique des interactions personnelles. Les entrées d'un utilisateur sont invisibles pour les autres utilisateurs.

MCP Tools

Cinq outils MCP couvrent le cycle de vie complet de la mémoire. Toute la portée de workspace par défaut; passer scope pour passer outre.

store_memory

store_memory({
  key: "icp_definition",
  value: { industry: ["SaaS"], headcount: "11-200" },
  category: "fact",         // fact | insight | preference | outcome
  scope: "workspace",
  confidence: 90,           // 0–100; ≥70 auto-syncs to Knowledge Graph
  merge: "overwrite"        // overwrite | append | max | min | increment
})

recall_memory

recall_memory({
  key: "icp_definition",
  scope: "workspace"
})

search_memories

search_memories({
  query: "scoring rules for enterprise deals",
  scope: "workspace",
  category: "fact",
  limit: 20          // default 20
})

list_memories

list_memories({
  scope: "workflow",
  workflowId: "wf_investor_scoring",
  category: "outcome",
  limit: 50          // default 50
})

delete_memory

delete_memory({
  key: "icp_definition",
  scope: "workspace"
})

Fusionner les stratégies

Lorsqu'une clé existe déjà, la merge la stratégie contrôle ce qui se passe au lieu d’un écrasement aveugle.

Stratégie	Comportement
écraser	Remplacez entièrement la valeur existante. Défaut.
ajouter	Insérez de nouveaux éléments dans un tableau, augmentant ainsi la collection au fil du temps.
incrément	Ajoutez des valeurs numériques — utile pour les compteurs et les totaux cumulés.
maximum	Conservez la valeur numérique la plus grande. Utile pour les marques high-water.
min	Conservez la valeur numérique la plus petite.

TTL et expiration

Passer ttl (secondes) pour faire expirer automatiquement une mémoire. Omettez-le ou passez null pour une entrée permanente.

store_memory({
  key: "weekly_market_signal",
  value: "fintech M&A activity elevated",
  category: "insight",
  scope: "workspace",
  ttl: 604800   // 7 days in seconds
})

Persistent Memory vs transmission de données entre les étapes

Utiliser les étapeslorsque les données n’ont besoin de circuler qu’au cours d’une seule exécution. Références de sortie d'étape ({{steps.stepId.output}}) sont le bon outil - pas de surcharge d'écriture/lecture de mémoire.

Utiliser la mémoirelorsque les données doivent survivre au fil des exécutions, être partagées avec d'autres flux de travail ou s'accumuler au fil du temps (compteurs, données d'étalonnage, préférences apprises).

Knowledge Graph Synchronisation

Entrées avec confiance ≥ 70 sont promus de manière asynchrone vers des nœuds d’informations dans Knowledge Graph. Cela les rend consultables via kg_search aux côtés des entités et des relations. La synchronisation est fire-and-forget — DynamoDB est la source de vérité et rien ne bloque la disponibilité de KG.

Capacité et expulsion

•espace de travail périmètre: 1 000 entrées maximum
•flux de travail portée: 500 entrées par workflow
•Lorsque le plafond est atteint, les entrées lowest-confidence sont d'abord expulsées pour laisser la place à de nouvelles écritures.

Prochaines étapes

Business Memory — Mémoire à l'échelle de l'espace de travail pour le partage des connaissances de l'entreprise
User Context — Mémoire à l'échelle de l'utilisateur pour les préférences personnelles et l'historique
Proactive Agents — Agents qui surveille les conditions de mémoire et agit en conséquence
KG API — Interroger les entrées de mémoire promues vers les nœuds d'analyse Knowledge Graph