User Memory

User Memory enables your AI to remember important facts about users across conversations. Instead of starting fresh every time, your AI can recall preferences, past interactions, and relevant details.

What Is User Memory?

User Memory automatically extracts and stores durable facts from conversations:

Each memory is also stored in one of two layers: Fact (durable, kept indefinitely) or Episodic (decaying, for things that matter for a while).

How It Works

User: "I'm the CTO at Acme Corp and we're evaluating your enterprise plan"
           ↓
    [AI replies]
           ↓
    [Memory extraction runs in the background]
           ↓
    Memories stored:
    - Role: CTO
    - Company: Acme Corp
    - Interest: Enterprise plan
           ↓
    [Next conversation]
           ↓
AI: "Welcome back! Last time we discussed enterprise pricing for Acme Corp..."

Enabling User Memory

Memory is on by default for new apps. To review or change it:

To steer what the AI remembers or ignores, put that guidance in your system prompt (see “Memory in Your System Prompt” below).

Memory Categories

Fact

Personal facts about the user:

• Name, job, and location
• Company information
• Dietary restrictions, family, pets

Preference

Likes, dislikes, and style:

• Communication style (formal/casual)
• Response length preference
• Preferred formats (bullet points, paragraphs)

Instruction

How the user wants to be treated or how they want tasks done:

• “Always answer in Spanish”
• “Show the code before the explanation”

Context

Ongoing projects, goals, or situations:

• Problems they’re trying to solve
• Products they’re evaluating
• Deadlines they mentioned

Viewing Stored Memories

Go to Insights > Memory in the builder and select a consumer to see:

• All memories for that consumer
• When each memory was created

Filter the list by memory type (Preference, Fact, Instruction, Context, Experiential) or by layer (Episodic or Fact).

Managing Memories

Deleting Memories

Remove memories that are:

• Incorrect
• Outdated
• No longer relevant

Click the delete icon on a memory and confirm.

Clearing All Memories for a Consumer

For compliance or cleanup, select the consumer in Insights > Memory and click Clear all.

Best Practices

What to Remember

Do remember:

• Professional context (company, role, industry)
• Stated preferences
• Key topics discussed
• Problems they’re solving

Don’t remember:

• Sensitive personal information
• Temporary states (“having a bad day”)
• Information they asked you to forget
• Confidential business data without consent

Privacy Considerations

Memory in Your System Prompt

Help your AI use memories effectively:

You have access to memories about this user from past conversations.
Use these to:
- Personalize greetings and responses
- Avoid asking questions they've already answered
- Reference their specific context

Don't:
- Mention that you "remember" things in a creepy way
- Assume memories are 100% accurate
- Reference memories if they seem outdated

How Memory Extraction Works

Memory extraction happens automatically, in the background, after each AI reply:

1. Turn completes: The AI finishes a reply (stopped or aborted replies are skipped)
2. AI analysis: A Claude Haiku model reads the exchange for memorable facts
3. Structured extraction: Facts are given a type (fact, preference, instruction, context) and a layer (durable fact or decaying episodic)
4. Storage: Memories are stored against the consumer

Extraction is skipped for apps with Zero Data Retention turned on.

Use Cases

Customer Support

Remember:

• Product version they’re using
• Past issues they’ve reported
• Preferred contact method
• Technical expertise level

Sales Conversations

Remember:

• Company size and industry
• Budget discussions
• Decision timeline
• Stakeholders involved

Personal Assistants

Remember:

• Work schedule preferences
• Project names and contexts
• Communication preferences
• Recurring tasks

Educational Apps

Remember:

• Learning progress
• Topics mastered
• Areas needing work
• Preferred learning style

Troubleshooting

Memories Not Being Extracted

1. Verify Auto-extract memories is on in the Memory card
2. Check that Zero Data Retention is off for the app
3. Allow a few moments after a reply for extraction to finish
4. Verify the user is identified (not anonymous)

Incorrect Memories

1. Delete incorrect memories
2. Add guidance to your system prompt about what to remember and what to ignore

Too Many Memories

1. Add system prompt guidance to prioritize durable facts
2. Periodically clean up outdated memories

Limitations

Current limitations to be aware of:

• Extraction delay: Memories from a reply are written in the background, so they may not be usable in the very next message
• Anonymous users: Memories need an identified consumer
• Token limits: Very long conversations may be truncated for extraction

Using with MCP

You can access user memories programmatically using the Chipp MCP Server.

Available Tools

Example Prompts

"Show me the memories my support bot has for consumer 8f2c..."
"What facts has my app learned about this user?"
"List only the instruction memories for this consumer"

Workflow: Reviewing User Insights

You: Show me the memories my sales bot has for john@acme.com

AI: [Looks up the consumer, then calls get_user_memories]
Found 6 memories:

- fact: CTO at Acme Corp, 500+ employees
- context: Evaluating the enterprise plan, budget approved
- preference: Prefers short, direct answers
...