Skip to content

[Agents] Split conversation state and memory into Sessions and Context concepts - #34739

Closed
mattzcarey wants to merge 1 commit into
productionfrom
docs/agents-sessions-memory-concepts
Closed

mattzcarey wants to merge 1 commit into
productionfrom
docs/agents-sessions-memory-concepts

Conversation

@mattzcarey

Copy link
Copy Markdown
Member

Splits "Conversation state and memory" into two concept pages, Sessions and Context and memory. Both explain the ideas rather than the API shape.

The old page mixed two different things and documented an API (agents/experimental/memory/session) that no longer exists:

  • a session is the record of a conversation: the transcript as a tree, the difference between what is stored and what each request sends, compaction, and why prompt caching makes rewrites rare
  • context is a scratchpad the agent reads and writes: read-only, writable, and searchable blocks, how they relate to skills, and how changes reach the model without breaking the prompt cache

/agents/concepts/conversation-state-and-memory/ now redirects to the memory page, and the old /agents/concepts/memory/ redirect is removed so it does not loop.

Draft until cloudflare/agents#2773 is released: the memory page describes context changes being sent once and kept where they were delivered, which that PR adds.

@github-actions github-actions Bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /agents/concepts/conversation-state-and-memory/

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-sessions-memory-concepts.previews.developers.cloudflare.com (commit 20a34f2)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://913d14ad.previews.developers.cloudflare.com 20a34f2 2026-10-29T17:16:52.988Z Visit the dashboard ↗

@mattzcarey

Copy link
Copy Markdown
Member Author

Moved into #34718.

@mattzcarey mattzcarey closed this Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant