Durable Objects Are Your Agent's Memory — If You Design Them Like a Database

说明与用途

在 Cloudflare Workers 上构建有状态 AI 代理需要正确管理 Durable Objects 的内存：选择隔离模型，使用 SQL 事务显式持久化数据，处理休眠，并与长期存储同步。

问题

Designing stateful AI agents on Cloudflare Workers requires correct Durable Object (DO) memory management to avoid privacy violations or loss of context.

结果

Agents achieve correct session isolation, reliable persistence, and cost‑effective operation by following the outlined workflow.

工作流

• 1. Decide isolation model (per‑session, per‑user, per‑tenant).
• 2. Derive DO ID from user/tenant ID and enforce access control.
• 3. Initialize SQL schema in DO constructor or initialize().
• 4. Wrap all state‑changing operations in explicit transactions and await commit/rollback.
• 5. Persist data to durable storage before returning from async functions.
• 6. Rebuild any in‑memory caches in initialize() after hibernation.
• 7. Use TTL policies to expire outdated session data.
• 8. Optionally sync important insights from DO to long‑term storage (e.g., Qdrant).

证据

Explicitly committed transactions (await sql.execute('COMMIT'))

来源

In-memory JavaScript variables: Anything stored in this or local variables disappears when the DO hibernates

来源

When a DO hasn't received a request for a few seconds, it suspends execution

来源