Перейти до основного вмісту
Concept · Intermediate · Agents

AI Agent Memory

Керована пам’ять AI-агента, що зберігає й повертає дозволений контекст між кроками або сесіями без підміни task state та авторитетних бізнес-даних.

Memory робить попередній контекст доступним пізніше. Вона не доводить, що запис правдивий зараз, не підтверджує виконання дії й не надає authority. Production design починається з розділення пам\u2019яті, workflow state та system of record.

Автор: AI Magister Editorial Team · Технічний reviewer: AI Magister Technical Review · Перевірено: 2026-08-27

П\u2019ять різних шарів, які не можна називати одним state

Ця матриця є пояснювальною visual: scope, contents і control boundary видно без декоративного зображення та зберігаються у mobile/print rendering.

LayerScopeContainsControl
Working contextОдин model callInstructions, поточний input, вибрані tool resultsContext budget, source labels, no-secret policy
Conversation memoryThread / sessionПовідомлення, summaries, artifact referencesThread isolation, compaction, deletion
Durable task stateОдин workflowCurrent step, checkpoint, pending approval, completed effectsSchema version, idempotency, resume validation
Long-term memoryМіж сесіямиPreferences, verified facts, lessons, project conventionsOwner, provenance, TTL, write policy
Authoritative stateSystem of recordOrder, balance, permission, policy version, deployment statusRead current value; memory never overrides it

Memory lifecycle

01

Propose

Модель або application пропонує memory candidate з subject, value, source і purpose.

02

Validate

Перевірте permission, sensitivity, tenant, evidence, conflict і чи це взагалі слід пам’ятати.

03

Write

Збережіть typed record із owner, provenance, created/effective time, TTL та schema version.

04

Retrieve

Фільтруйте за identity, task, permission, freshness і relevance до передачі в context.

05

Revalidate

Перед consequential use звірте mutable fact із системою істини; stale memory стає hint, не evidence.

06

Correct / forget

Update, tombstone і deletion мають поширитися на indexes, summaries, caches та derived profiles.

Failure diagnosis

Агент пам’ятає неправильний факт

Причина: Model output записали без provenance або verification.

Контроль: Candidate → validation → typed write; conflict test і user correction path.

Дані одного користувача з’явилися в іншого

Причина: Namespace або retrieval filter не прив’язані до authenticated tenant/subject.

Контроль: Application-enforced isolation, negative tenancy tests, least-privilege store access.

Resume повторив уже виконану дію

Причина: Transcript використали як task state; timeout приховав side effect.

Контроль: Durable checkpoint, idempotency key, authoritative reconciliation before retry.

Видалена пам’ять повернулася

Причина: Primary record видалили, а summary, vector index або cache залишили.

Контроль: Deletion manifest, derived-store propagation і post-deletion retrieval test.

Memory стала прихованою інструкцією

Причина: Retrieved content отримав policy authority або містив prompt injection.

Контроль: Treat memory as data, preserve provenance, gate tool authority outside the model.

Minimum eval suite

  • Recall: потрібна verified memory повертається лише у дозволеному scope.
  • Precision: нерелевантна або superseded memory не засмічує context.
  • Conflict: новіший authoritative fact перемагає stale memory за явним правилом.
  • Isolation: cross-user, cross-tenant і cross-project fixtures повертають нуль витоків.
  • Deletion: record та всі derived representations більше не retrieve-яться.
  • Recovery: checkpoint resume не дублює side effects і revalidates approvals.

Практичний приклад

Support agent пам\u2019ятає preferred language клієнта з consent і TTL. Перед refund він читає current order owner, payment state та policy version із систем істини. Preference може формувати відповідь; memory про «refund уже погоджено» не може авторизувати платіж. Після timeout executor спершу reconciles transaction ID, а не повторює write зі слів transcript.

Primary-source boundaries

OpenAI Agents SDK — Sessions ↗

Документує persistent conversation history, custom session storage, resume та compaction. Це не робить session авторитетним business state.

OpenAI Agents SDK — RunState ↗

Документує serializable run snapshot. Reconciliation, retention і business authorization залишаються application concerns.

Anthropic — Memory tool ↗

Документує client-side cross-session file memory та application-controlled storage. Isolation і trust політику має забезпечити application.

LangGraph — Memory overview ↗

Розділяє thread-scoped short-term state і cross-session long-term memory. Це framework taxonomy, не універсальний storage contract.

Таксономія, lifecycle, authority boundary та eval suite — редакційний engineering synthesis AI-Magister. Сторінка не заявляє vendor superiority, productivity uplift або універсальну retention policy.

Куди далі

Для реалізації перейдіть до memory design; для pause/resume і side effects — до state machines; для poisoning та trust boundaries — до prompt injection.