Core Concepts
Understanding the fundamental building blocks of Sovant.
Memories
Memories are the core unit of storage in Sovant. Each memory represents a piece of information about a user.
Memory Types
- preference - User preferences and settings
- observation - Behavioral patterns and actions
- insight - Derived understanding and analysis
- task - Action items and reminders
Memory Structure
{
"id": "mem_abc123",
"user_id": "user_123",
"type": "preference",
"content": "Prefers email over phone calls",
"metadata": {
"source": "settings",
"confidence": 0.95
},
"thread_id": "thread_xyz",
"created_at": "2024-01-15T10:30:00Z"
}
Threads
Threads group related memories together, typically representing a conversation or session.
Use Cases
- Chat conversations
- Support tickets
- User sessions
- Transaction flows
Semantic Search
Find memories using natural language queries powered by vector embeddings.
How It Works
- Query is converted to embeddings
- Similar memories are found via vector search
- Results ranked by relevance score (0-1)
Metadata
Attach custom data to memories for filtering and enrichment.
Common Patterns
- source - Where the memory originated
- confidence - How certain the information is
- tags - Categories for organization
- timestamp - When events occurred
Best Practices
- Use appropriate types - Choose the right memory type for clarity
- Add metadata - Enrich memories with context
- Link to threads - Group related memories
- Set confidence - Indicate certainty levels
- Regular cleanup - Remove outdated memories