Skip to content

docs: add memory manager documentation#2757

Closed
opieter-aws wants to merge 8 commits into
strands-agents:mainfrom
opieter-aws:opieter-aws/memory-store-docs
Closed

docs: add memory manager documentation#2757
opieter-aws wants to merge 8 commits into
strands-agents:mainfrom
opieter-aws:opieter-aws/memory-store-docs

Conversation

@opieter-aws

@opieter-aws opieter-aws commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Description

Documents the long-term memory feature (MemoryManager) for the TypeScript SDK. The implementation shipped across #2544 (memory manager), the Bedrock KB store + extraction work, and #2631 (injection), but had no user-facing documentation. Agents that should remember a user across sessions had a supported API and no page explaining it.

Adds two pages under site/, both TypeScript-only (the feature is TS-only today):

  • Memory (concepts/agents/memory.mdx) covers the MemoryManager: the MemoryStore interface and multi-store routing, the search_memory / add_memory tools, programmatic search/add, automatic extraction (triggers and ModelExtractor), and context injection. It opens by distinguishing memory from the adjacent session-management and conversation-management features, since the three are easy to conflate.
  • Bedrock Knowledge Base Store (concepts/agents/bedrock-knowledge-base.mdx) documents the vended BedrockKnowledgeBaseStore: the split connection/store config, CUSTOM vs S3 vs OTHER writability, search/ingestion, scope-based namespacing, and the IAM permissions a writable store needs.

Code examples live in runnable, type-checked snippet files (*.ts plus sibling *_imports.ts) and are pulled into the pages via --8<-- includes, so every rendered block carries its imports and is copy-paste runnable.

This PR also adds a memory tag to site/src/config/tags.yml and reconciles the terminology lock (.agents/references/terminology.md): "memory" was previously listed only as a banned synonym for session management, which collides with the shipped MemoryManager feature name. The lock now carves out "long-term memory" as the canonical term for the feature, distinct from session persistence.

Related Issues

#2544, #2631

Documentation PR

This PR is the documentation. New pages registered in site/src/config/navigation.yml under Concepts.

Type of Change

Documentation update

Testing

Built the docs site against the SDK source (astro build): both pages render, all --8<-- snippet regions resolve, and the broken-links checker passes across all pages. The snippet sources type-check against the SDK via the site/test-snippets harness (tsc --noEmit). Reviewed both drafts with the docs-writer and docs-reviewer voice/terminology passes.

  • I ran hatch run prepare

Checklist

  • I have read the CONTRIBUTING document
  • I have added any necessary tests that prove my fix is effective or my feature works
  • I have updated the documentation accordingly
  • I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

opieter-aws and others added 8 commits June 10, 2026 16:30
Merge the latest KB store + extraction work (nested BedrockKnowledgeBaseConfig,
boolean|ExtractionConfig shorthand, IntervalTrigger default, addMessages sink)
onto the injection base so all three memory feature sets are present and compile
together for documentation snippets.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions github-actions Bot added bug Something isn't working documentation Documentation changes, improvements, additions, content updates, site improvements, examples, guides labels Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Documentation changes, improvements, additions, content updates, site improvements, examples, guides size/xl

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant