Skip to main content

​
Overview

Junis provides a hierarchical memory system that enables AI agents to remember users across conversations. Unlike traditional chatbots that forget everything after each session, Junis agents build a growing understanding of each user over time.
Your AI agents don’t just respond — they remember, learn, and evolve with every conversation.
Automatic: Memory collection and consolidation happen automatically. No manual setup required — just start chatting.

​
How It Works

Remembers Conversations

Key information from every conversation is captured and stored automatically.

Learns Over Time

Daily memories are consolidated into monthly, quarterly, and yearly summaries by AI.

Personalized Responses

Agents use stored memories to provide contextual, personalized interactions for each user.

User-Controlled

Users can view and update their own profile. Memory is scoped per-user with full privacy.

​
Memory Architecture

Junis organizes memory into a hierarchical tier system, inspired by how human memory works — from detailed daily notes to high-level life narratives:

​
Memory Tiers

TierDescriptionUpdated
User ProfileName, preferences, communication style, expertiseAnytime (by agent or user)
Eternal MemoryCore truths and permanent preferencesAnytime (by agent)
Daily MemoryConversation summaries per dayAfter each conversation
Monthly SummaryConsolidated patterns and themesAutomatically, 1st of each month
Quarterly SummaryGrowth trajectories and milestonesAutomatically, every quarter
Yearly NarrativeAutobiographical narrative of the yearAutomatically, January 1st

​
Consolidation Flow

AI-Powered Consolidation: An AI model reviews and consolidates memories at each tier, preserving important patterns while letting trivial details naturally fade — mimicking how human memory works.

​
What Gets Remembered

​
Automatic Memory (No Action Needed)

The system automatically captures:
  • Conversation summaries from each session
  • User preferences mentioned naturally in conversation
  • Key decisions and outcomes
  • Recurring topics and interests

​
Explicit Memory Commands

Users can explicitly ask agents to remember things: 
"Remember that I prefer concise responses."
"Don't forget that our quarterly reviews are on Fridays."
"Always format reports with bullet points for me."
Agents store these as Eternal Memory — persistent facts that are always available.

​
User Profile Updates

When agents learn about users, they automatically update the profile: 
"My name is Sarah and I'm a marketing director."
→ Agent updates User Profile with name and role

"I prefer Korean for internal docs and English for client-facing work."
→ Agent updates communication preferences

​
Memory in Action

​
How Agents Use Memory

Every time an agent starts a conversation, it automatically loads the user’s memory context:
  1. User Profile — Who the user is
  2. Eternal Memory — Permanent preferences and instructions
  3. Recent Daily Memories — What happened in recent conversations
  4. Latest Summaries — Monthly/quarterly/yearly patterns
This context is automatically injected into the agent’s awareness, so it can reference past interactions naturally.

​
Example Interaction

Day 1:
User: "I'm working on the Q4 marketing campaign for product launch."
Agent: [Stores in daily memory]

Day 5:
User: "How's the project going?"
Agent: "Based on our conversation earlier this week about the
Q4 marketing campaign for the product launch, here's where
we can pick up..."
→ Agent references past context without being asked

​
Cross-Session Continuity

Week 1: User discusses project goals and timelines
Week 2: User mentions team members and responsibilities
Week 3: User provides budget details

Monthly Summary (auto-generated):
"User is managing a Q4 product launch campaign with a team of 5.
Key priorities: timeline adherence, budget of $50K, and
cross-department coordination."

​
Managing Memory

​
View Your Memory

You can ask any agent to show your stored memories: 
"Show me my profile."
→ Agent displays your current User Profile

"What do you remember about me?"
→ Agent reads and summarizes your memory context

​
Update Your Profile

Ask an agent to update your information: 
"Update my profile: I've moved to the product team."
→ Agent updates your role

"Remove the note about my old email address."
→ Agent reads eternal memory, removes the entry, saves

​
Memory via API & MCP

Access memory programmatically through the Junis Magic MCP tools:
ToolPurpose
get_memory_directoryList all memory files for a user
get_memory_contentRead specific memory content
update_memory_contentUpdate the user profile

​
Memory Tools for Agents

Junis automatically equips all orchestrator agents with two memory tools:

​
update_user_memory

Read or update the user’s profile.When agents use this tool:
  • User shares their name, role, or job title
  • Communication preferences are revealed
  • Professional expertise becomes apparent
  • User explicitly asks to see their profile
Actions: read (view profile), update (save changes)
Automatic: These tools are available to all orchestrator agents by default. No configuration needed.

​
Privacy & Security

Memory is strictly scoped to individual users. No user can access another user’s memories, even within the same organization.
Memory is completely isolated between organizations. Switching organizations means working with a separate memory context.
Users can view, update, and manage their own memory at any time. Agents are designed to never store sensitive information like passwords, financial data, or API keys in memory.
Memory consolidation (monthly/quarterly/yearly) is processed only for users with active subscriptions, ensuring fair resource usage.

Soul & Identity

Define your AI’s personality (organization-level)

Agent System

Learn about agent types and orchestration

Junis Magic

Manage memory via MCP tools

Billing & Credits

Understand usage costs
Need Help? Contact us at contact@junis.ai for questions about the memory system.