Kihagyá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
Vissza a tetejére