Memory Systems: How Your Agents Remember
Understand how Anakin agents maintain context across sessions using visitor profiles, conversation history, and knowledge base.
Memory Systems
Anakin agents have multiple memory layers that work together to provide contextually aware responses.
1. Short-Term Memory (Conversation Context)
What it is: The current conversation's recent message history.
How it works: The agent uses recent conversation details to stay coherent. This includes:
- User messages
- Agent responses
- Owner guidance
- Tool results
Limitations: Only lasts within a single conversation. New conversations start fresh.
2. Visitor Profiles (Cross-Session Memory)
What it is: Persistent data about each visitor across all sessions.
What's stored:
- Name, email, phone
- Preferences (e.g., "prefers email over phone")
- Facts (e.g., "works at Acme Corp", "interested in enterprise plan")
- Last seen timestamp
How it works: When a visitor returns, the agent loads their profile and uses it to personalize responses. Example:
- Visitor: "Hi, it's me again"
- Agent: "Welcome back, Jane! Still interested in the enterprise plan?"
3. Knowledge Base (Business Memory)
What it is: Your uploaded documents, FAQs, and structured data.
How it works:
1. You upload knowledge items such as PDFs, text, and Q&A pairs.
2. Anakin organizes the content for fast lookup.
3. When visitors ask questions, the agent finds the most relevant source material.
4. The answer is written from your actual business information.
When to use:
- Product catalogs
- Company policies
- Product or service documentation
- Pricing sheets
- FAQ collections
4. Owner Guidance (Real-Time Context)
What it is: Commands you send to your agents from the Dashboard.
How it works: You can say things like:
- "We're having a sale on enterprise plans this week"
- "Server is down, tell users we're working on it"
- "New product launching tomorrow, mention it to interested visitors"
The agent uses these updates when they are relevant to future responses.
Memory Hierarchy
When generating a response, the agent uses this priority:
1. Owner guidance (highest priority)
2. Visitor profile (personalization)
3. Knowledge base (domain expertise)
4. Conversation context (current chat)
Best Practices
- Keep knowledge base updated - Outdated info leads to wrong answers
- Use visitor profiles strategically - Don't store sensitive data
- Add context regularly - Keep agents informed of business changes
- Test memory recall - Use the Test tab to verify agents respond correctly