Mémoire Agent
Une Mémoire Agent conserve un contexte de travail entre plusieurs Agent Runs. Elle appartient à un Agent, pas à une révision ni à un processus, et peut donc être réutilisée par plusieurs révisions de ce même Agent lorsqu’une continuité est explicitement demandée.
À quoi sert la Mémoire Agent ?
Un Agent peut être sollicité plusieurs fois autour du même travail : analyser une situation, recevoir une information nouvelle, puis réexaminer sa conclusion. La Mémoire Agent évite de reconstruire artificiellement tout le contexte à chaque Run en conservant des contributions structurées et leur provenance.
La mémoire appartient à l’Agent, pas à sa révision
Une Mémoire Agent est rattachée à une Agent Definition. Une contribution conserve la révision exacte et l’activité du Run qui l’a produite pour la traçabilité, mais cette provenance ne limite pas sa réutilisation par une révision ultérieure du même Agent.
La même Mémoire Agent peut servir de continuité à plusieurs Runs et plusieurs révisions du même Agent. Les faits durables restent explicitement publiés hors de la mémoire.
Dans un processus, chaque Agent Task choisit sa source
La mémoire n’est jamais un input métier implicite. Elle est associée à l’invocation de l’Agent Task et reste optionnelle sauf lorsqu’une activité exige un historique préalable.
| Source | Quand l’utiliser | Garantie |
|---|---|---|
| None | La tâche ne nécessite aucune continuité. | Aucune Mémoire Agent cachée n’est créée. |
| Memory object | Le processus possède déjà une valeur platform.agent_memory, par exemple produite par Create Agent Memory. | La mémoire mappée doit appartenir à l’Agent sélectionné sur le node. |
| Agent role | Plusieurs Agent Tasks du même processus doivent retrouver automatiquement la même continuité pour un Agent donné. | La continuité est résolue par instance de processus + rôle + Agent. |
Un rôle Agent est donc seulement un namespace de continuité. Il ne référence aucune révision et ne choisit jamais l’Agent. Deux Agents différents utilisant le même rôle dans la même instance obtiennent des Mémoires Agent distinctes.
Le node Create Agent Memory permet aussi de créer explicitement une mémoire autonome dans un processus, puis de mapper son output vers un Agent Task ultérieur. Cette approche est utile lorsque la mémoire elle-même doit circuler comme un objet typé ou être reliée à un objet métier.
L’activité définit comment elle utilise la mémoire
La mémoire n’appartient pas à l’activité. En revanche, chaque activité porte une politique de mémoire qui contrôle l’admission et le niveau d’accès au contexte associé au Run.
| Réglage | Effet |
|---|---|
restricted_data_access | Détermine si les données restreintes admises dans la mémoire restent projetées ou peuvent être exposées en mode raw lorsque le consentement requis existe. |
required_activities | Exige que certaines activités aient déjà contribué avec succès à cette même Mémoire Agent avant que l’activité courante puisse s’exécuter. |
Une liste required_activities vide signifie simplement qu’aucun prérequis n’est exigé. Elle ne désactive pas la lecture de la mémoire associée. Lorsqu’une clé est requise, elle doit correspondre exactement à une activité ayant déjà contribué avec succès ; renommer une activité dans une nouvelle révision ne transforme pas rétroactivement les anciennes contributions.
Mémoire et données protégées
La Mémoire Agent conserve les protections applicables aux données qu’elle contient. Une activité qui demande un accès raw à des données restreintes ne contourne pas le modèle de protection : cette exposition reste soumise au consentement correspondant et aux droits du Run courant.
Les surfaces d’observabilité restent masquées par défaut. Conserver une valeur dans la mémoire ne la rend pas affichable en clair ; une investigation précise utilise les mécanismes de reveal prévus lorsqu’ils sont autorisés.
Voir Protection des données pour les règles de divulgation et de reveal.
Bien concevoir une continuité de travail
- Utilisez None lorsqu’une activité peut être comprise uniquement avec ses inputs courants.
- Utilisez une Memory object lorsqu’une mémoire doit être créée, transmise ou reliée explicitement à d’autres objets.
- Utilisez un Agent role lorsque plusieurs Agent Tasks du même processus doivent retrouver automatiquement la continuité du même Agent.
- Utilisez
required_activitiesuniquement pour un vrai prérequis de travail, pas pour imposer artificiellement une séquence de prompts. - Préférez les objets plateforme et outputs typés pour les faits métier durables et vérifiables.
Les Mémoires Agent sont des objets plateforme adressables et peuvent être associées à des objets métier avec les relations d’objets prévues par Ormuz, sans inventer un champ métier spécialisé sur la mémoire elle-même.