Memory

Give your agents a memory that outlives a single conversation. Session state holds this conversation; memory is the long-term store an agent reads from at the start of a turn and writes back to as it learns — so the next session already knows the user.

This section takes you through it from scratch: the two kinds of memory ADK-Rust offers, the core types, the backends, the bi-temporal knowledge graph, and how to wire it all into an agent.

New to ADK-Rust? Read the Introduction and Sessions & State first — memory is the persistent counterpart to the ephemeral session.

Two kinds of memory

ADK-Rust ships two complementary memory models behind the same MemoryService trait, so an agent can use either through one interface:

You don't have to choose globally — pick per agent based on whether you need a transcript-style recall or a clean, queryable model of the user.

The mental model

  Agent turn
     │  search_memory(query)         ← recall relevant context at turn start
     ▼
  adk_core::Memory                   ← the interface the agent sees
     │  (MemoryServiceAdapter bridges to…)
     ▼
  MemoryService                      ← add_session / search / delete_user …
     ├─ InMemoryMemoryService        (dev)
     ├─ Sqlite/Postgres/Redis/…      (semantic store)
     └─ GraphMemoryService           (bi-temporal knowledge graph)

• A MemoryService is the storage backend: it stores entries (or graph nodes) and answers search.
• A MemoryServiceAdapter wraps it as an adk_core::Memory, scoped to an (app_name, user_id, project_id?), which is what an agent's search_memory actually calls.
• The Runner holds the Memory and exposes it to the agent; memory tools let the agent search and curate memory deliberately.

Install

# Semantic store — pick the backend you need
adk-memory = { version = "2.0.0", features = ["sqlite-memory"] }

# Bi-temporal knowledge graph
adk-memory = { version = "2.0.0", features = ["graph-memory"] }

60-second quick start

Store a couple of memories and search them back:

use adk_memory::{InMemoryMemoryService, MemoryService, MemoryEntry, SearchRequest};
use adk_core::Content;
use chrono::Utc;

# async fn run() -> anyhow::Result<()> {
let memory = InMemoryMemoryService::new();

memory.add_session("support", "alice", "s1", vec![
    MemoryEntry { content: Content::new("user").with_text("I prefer email over phone"),
                  author: "user".into(), timestamp: Utc::now() },
]).await?;

let hits = memory.search(SearchRequest {
    app_name: "support".into(), user_id: "alice".into(),
    query: "how should we contact this customer?".into(),
    ..Default::default()
}).await?;

for entry in hits.entries { println!("{:?}", entry.content); }
# Ok(()) }

In a real agent you don't call search by hand — you attach the service to the Runner and let the agent recall and curate memory itself.

Where to go next

1. Concepts — MemoryEntry, the MemoryService trait, search, project scoping, GDPR erasure.
2. Backends — the six stores, feature flags, and how to choose.
3. Knowledge graph — GraphMemoryService and why bi-temporal matters.
4. Tools & agents — wiring memory into agents; remember/relate and the memory tools.