Skip to content

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

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

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

Conversation

@mattzcarey

Copy link
Copy Markdown
Member

Replaces "Conversation state and memory" with two concept pages, Sessions and Context and memory. Both explain the ideas, not the API.

The old page documented agents/experimental/memory/*, which agents no longer exports, and it mixed two different things:

  • a session is the record of a conversation: the transcript as a tree, what is stored versus 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/ redirects to the memory page, and the old /agents/concepts/memory/ redirect is removed so it does not loop.

The context page describes the behavior in agents 0.33: a frozen system prompt, and changes after it as a note at the end of the conversation until a refresh. When cloudflare/agents#2773 ships, the page can say that a note is recorded where it was delivered.

Internal links resolve, the pages compile as MDX, and bin/validate-redirects.ts passes. Replaces the concept half of #34718 and #34739.

@mattzcarey
mattzcarey requested review from a team, irvinebroque and rita3ko as code owners November 9, 2026 19:22
@github-actions github-actions Bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Nov 9, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed c09a24f · 1 finding · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #35059 (https://github.com/cloudflare/cloudflare-docs/pull/35059).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit because the next review reads PR comments.

## Style Guide
- S-16f6be93 | src/content/docs/agents/concepts/memory.mdx:37 | Semicolon joins two independent clauses
  Per the style guide, prose using a semicolon to join two independent clauses should be broken into two sentences. Both `if you would put it in a SKILL.md file, it is a skill` and `if the agent would jot it down, it is context` are independent clauses joined by a semicolon.

Style Guide

  • src/content/docs/agents/concepts/memory.mdx:37 · Semicolon joins two independent clauses

    Per the style guide, prose using a semicolon to join two independent clauses should be broken into two sentences. Both if you would put it in a SKILL.md file, it is a skill and if the agent would jot it down, it is context are independent clauses joined by a semicolon.

Not reviewed (1)
  • src/content/docs/agents/concepts/conversation-state-and-memory.mdx — deleted file
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@github-actions

github-actions Bot commented Nov 9, 2026

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-docs-bot

cloudflare-docs-bot Bot commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Review coverage

✅ All 2 ownership areas are covered.

✅ 2 areas already covered
Area Approved by
Other
1 file changed
/public/__redirects
irvinebroque
agents
4 files changed
aron-cf, irvinebroque
CODEOWNERS mappings for displayed areas (2)
Pattern Owners
/public/__redirects @cloudflare/product-owners, @cloudflare/content-engineering
/src/content/docs/agents/ @irvinebroque, @rita3ko, @cloudflare/ai-agents, @cloudflare/dev-plat-leads, @cloudflare/product-owners

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-sessions-context-concepts.previews.developers.cloudflare.com (commit c09a24f)

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://f7098905.previews.developers.cloudflare.com c09a24f 2026-11-09T19:55:52.789Z Visit the dashboard ↗

@neelakolkar-cf

Copy link
Copy Markdown
Collaborator

@mattzcarey All approved and ready, please merge whenever all changes are done, thanks! 🙌

@mattzcarey
mattzcarey added this pull request to the merge queue Nov 10, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Nov 10, 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.

4 participants