---
title: "Building Reliable Agents with Memory and Compaction"
source: "https://developers.openai.com/cookbook/examples/agents_sdk/building_reliable_agents_memory_compaction"
type: articles
ingested: 2026-05-08
tags: [memory, compaction, agent-reliability, sandbox, context-management, openai-agents-sdk]
summary: "OpenAI Agents SDK cookbook: hogyan építs megbízható agent workflow-t compaction-nel (hosszú kontextus tömörítése) és Memory-val (újrafelhasználható workflow tanulságok). A hármas felelősség-megosztás: compaction segíti az aktuális run-t, memory segíti a jövőbeli run-okat, a generált artifact (memo) az ember által review-olt igazságforrás."
---

# Building Reliable Agents with Memory and Compaction

**Forrás:** OpenAI Developers Cookbook — Agents SDK

## Két megbízhatósági primitív

### 1. Compaction — aktuális run folytatása
Hosszú kontextusablak kezelése. Nem töröl, hanem tömörít: a következő fázishoz szükséges állapotot megőrzi, a többit eldobja.

Három mód:
- **Automatikus:** `Compaction()` capability — SDK kezeli a kontextusnyomást
- **Küszöb-alapú:** `StaticCompactionPolicy(threshold=N)` — explicit token limit
- **Kényszerített checkpoint:** `run_compaction({"force": True})` — fázishatáron

Best practices:
- Értelmes workflow határoknál tömöríts, ne minden kör után
- Őrizz meg elég állapotot a következő fázishoz
- A tényeket generált artifact-okban tartsd, ne csak compacted state-ben

### 2. Memory — jövőbeli run-ok segítése
Újrafelhasználható munkafolyamat-tanulságok tárolása. Explicit szabály: **ne tároljon eset-specifikus tényeket.**

Jó Memory tartalom:
- "Használd a manifest-et elsőként fájlalapú workspace-nél"
- "Őrizd meg a bizonytalanságot a memo-ban, ne találgass"
- "Tartsd láthatóan a korábbi feltételezéseket amikor új bizonyíték szűkíti őket"

Rossz Memory tartalom:
- "Northwind Logistics megsértette a policy-t"
- "Az ACME Finance Ops folyamata hiányos"
- Bármilyen eset-specifikus következtetés

Best practice: "Use memory for stable process lessons and user preferences. Keep case-specific facts in reviewed artifacts. Inspect generated memory before relying on it."

### Hármas felelősség-megosztás

| Komponens | Cél | Hatókör |
|-----------|-----|---------|
| **Kontextus (compaction)** | Aktuális run folytatása | Eset-specifikus állapot |
| **Memory** | Jövőbeli run-ok segítése | Workflow tanulságok, preferenciák |
| **Generated artifact (memo)** | Ember által review-olt igazság | Eset összes ténye, citációkkal |

> "Do not treat Memory() as an unreviewed fact database. Memory should help the next run remember how to work. It should not become a shadow compliance record."

## Manifest — Sandbox Workspace Contract

A Manifest a sandbox agent friss session workspace szerződése. Leírja a fájlokat, könyvtárakat, mount-okat, környezetet.

Best practices:
- Forrásdokumentumokat, manifest-eket, helper fájlokat Manifest-be tenni, NE promptba másolni
- Hosszú instrukciókat workspace fájlokba tenni (README.md, task.md, AGENTS.md)
- Stabil document ID-k és géppel olvasható manifest → citálható output
- Memory() kezelje a saját artifact-jait (memories/, sessions/)
- Generált artifact-ok outputs/ alatt → alkalmazás inspect-olhatja, validálhatja

## A Teljes Reliability Stack

```
Memory (jövőbeli run-ok)
  └── Workflow lesson-ök, preferenciák
  └── Automatikusan generálódik run végén

Compaction (aktuális run)
  └── Hosszú kontextus tömörítése
  └── Fázishatárokon checkpoint

Generated Memo (artifact)
  └── Citált tények, nyitott kérdések
  └── Ember által review-olt igazságforrás
```

## Források

- OpenAI Agents SDK Cookbook
- OpenAI Agents SDK sandboxing docs