Skip to main content
Agent memory maintains conversation context across multiple messages. Configure memory at agent creation or add it to existing agents.

Quick Start


Adding Memory at Creation

Use the memory parameter when creating an agent:

Memory Parameter


Adding Memory to Existing Agent

Use agent.add_memory() to enable memory on an existing agent.

Parameters

Example


Checking Memory Status

has_memory()

Check if memory is enabled.

get_memory_config()

Get the current memory configuration.

Removing Memory

Disable memory for an agent.

Session Management

Memory is scoped to sessions. Each session maintains its own conversation history.

Using session_id

Auto-Generated Sessions

If no session_id is provided, one is auto-generated:

Persistent Session IDs

For continuous conversations, use consistent session IDs:

Examples

Chatbot with Memory

Support Agent

Teaching Assistant


Memory Size Considerations

Small Memory (1-20 messages)

Best for:
  • Quick Q&A
  • Single-turn tasks
  • Stateless interactions

Medium Memory (20-50 messages)

Best for:
  • Typical conversations
  • Support interactions
  • General-purpose chatbots

Large Memory (30-50 messages)

Best for:
  • Complex multi-turn tasks
  • Research sessions
  • Long-form content creation
Larger memory increases context size, which may affect response latency and token usage. Choose based on your use case.

Best Practices

Consistent Session IDs

Appropriate Memory Size

Clear Session Boundaries