AI Memory Bank Usage

The AI memory bank is long-term memory that MBAgent saves across sessions. It enables AI to "remember" your preferences, account info, and business rules, avoiding re-explaining them in every new session.

NOTE

Screenshot description: Screenshots of the AI memory bank management UI (memory entries list, category filtering, add/edit/delete memory buttons) will be progressively supplemented in v1.x. This section operates by text steps.

---

1. What Is AI Memory?

MBAgent distinguishes two kinds of "memory":

Type	Scope	Purpose
Session-level memory	Only current conversation	"That number just now" AI remembers
AI local memory bank	Cross-session permanent	Your preferences, accounts, business rules

TIP

Analogy: Session-level memory is "the temporary memory of this chat"; AI local memory bank is "your private profile".

---

2. What Can the AI Memory Bank Store?

Suitable content:

• ✅ Your preferences ("Reply style should be formal, rigorous, no emojis")
• ✅ Account info ("My Mbbrowser account ID is 123456")
• ✅ Business rules ("Customer ID is always 32-char string")
• ✅ Important facts ("Our company mainly does European/American markets")
• ✅ Common terms ("GMV = Gross Merchandise Value")

Unsuitable content:

• ❌ Temporary info ("Today's orders are 100")
• ❌ Sensitive credentials (password / Token / API Key) → these go to credential manager
• ❌ Long documents → these go to KMS knowledge base

---

3. Where Is the AI Memory Bank Stored?

Memory bank files are stored in the MBAgent user configuration directory:

%LOCALAPPDATA%\mbagent\memory\
├── user.md            ← User-level memory (shared by all sessions)
├── project\
│   ├── my-project.md  ← Project-level memory (only visible to current project)
│   └── ...

• User-level memory: All workspaces and all sessions shared
• Project-level memory: Only visible to sessions in the current workspace (project directory)

---

4. Add Memory

Method 1: Tell AI Directly in Conversation

The most natural addition:

User: Remember my Mbbrowser main account is 123456789, mainly European/American Amazon market.

MBAgent: OK, I have added it to your AI local memory bank.

AI auto-judges what is worth remembering.

Method 2: Manually Add in the Memory Bank Management UI

1. Click the "AI Local Memory Bank" entry in the left sidebar
2. Click the "+" button
3. Pick memory type (user-level / project-level)
4. Enter title and content
5. Click "Save"

Method 3: Use Slash Command

Type in the chat input box:

/memory add My Mbbrowser main account is 123456789

AI auto-categorizes into suitable memory categories.

Method 4: Distill from Conversation

1. Find a piece of useful info in chat
2. Right-click → "Add to Memory"
3. Pick memory type (user-level / project-level)
4. Save

---

5. Memory Type and Categories

The AI memory bank supports multiple categories for easy management:

Type	Purpose	Example
Account info	Mbbrowser account, API Key ID (not actual Key)	"Main account 123456"
Business rules	Workflow, naming conventions	"Customer ID 32 chars"
Preferences	Writing style, reply format	"Reply formal and rigorous"
Important facts	Business context, company info	"Main biz European/American Amazon"
Common terms	Professional vocabulary	"GMV = total sales"
Other	Anything not in above categories	"API gateway domain"

---

6. View and Edit Memory

View All Memory

1. Click the left sidebar "AI Local Memory Bank"
2. The memory browser pops up, displaying all memory entries
3. Filter by category, sort by time

Edit Memory

1. Click any entry in the memory list
2. Edit panel appears on the right
3. Modify title, content, category
4. Click "Save"

Delete Memory

1. Select memory to delete
2. Click the "Delete" button
3. Confirm deletion (irrecoverable)

TIP

Periodic cleanup: Recommended to clean up the memory bank monthly, removing outdated or wrong info.

---

7. How Does AI Use Memory?

Auto Retrieval

At the start of every new session, MBAgent automatically retrieves memories related to the current task from the AI memory bank and includes them as part of the system prompt.

For example, you ask "How's my main account's orders today?":

• AI auto-retrieves the "main account 123456" memory
• Auto-calls Mbbrowser API to query 123456's today orders
• No need to repeat "my main account is 123456"

Active Reference

AI explicitly mentions what it "remembers" in replies:

"Per my previously recorded preferences, I will reply in formal rigorous style."

Learning Distillation

When autoLearn is enabled, MBAgent automatically distills "meaningful conversations" into memory:

1. Go to "Settings → Preferences"
2. Find the "autoLearn" option
3. Once enabled, MBAgent analyzes each conversation
4. Auto-adds "worth remembering" content to the self_learn memory bank (separate from your active memory)

---

8. Memory Bank Best Practices

Recommendations

✅ Build a few key memories the first time you use MBAgent:

• Your Mbbrowser main account ID
• Main business scope
• Preferred reply style

✅ If you notice AI repeatedly asking the same question, immediately record it:

• AI repeatedly asks "What's your customer ID?" → record it

✅ Use different memory scopes for different projects:

• Project A memory only in Project A's directory
• User-level memory holds generic info

✅ Memories should have structure:

• Clear titles
• Concise content
• Organize with markdown lists

Anti-patterns

❌ Don't put sensitive credentials in the memory bank:

• Passwords, Tokens, API Keys go to credential manager
• Memory bank files are plain text, not encrypted

❌ Don't stuff entire documents into the memory bank:

• Documents and reference materials go to KMS knowledge base
• Memory bank only holds "rules, preferences, key facts"

❌ Don't let the memory bank balloon:

• Too many memories dilute AI attention
• Keep memory entries < 50

---

9. Memory Bank vs Other Features

Feature	Purpose	Size
AI Memory Bank	Preferences, rules, key facts	Small (KB-level)
Local Knowledge Base (KMS)	Complete documents, reference materials	Large (MB-level)
Session	Complete history of one conversation	Medium (KB-MB-level)
RAG Mbbrowser official KB	Mbbrowser business remote retrieval	Remote

TIP

Which to choose:

• Simple preferences → AI Memory Bank
• Complete documents → KMS
• One-shot Q&A → Session
• Mbbrowser business knowledge → Mbbrowser RAG

---

10. Memory Bank Troubleshooting

Q1: AI seems not to "remember" what I said earlier

Possible causes:

• Memory bank save failed
• Memory auto-ignored (not relevant to current task)
• Memory bank file corrupted

Troubleshoot:

1. Go to "AI Local Memory Bank" to check if memory exists
2. Manually ask AI to remember again and explicitly confirm

Q2: AI used the wrong memory

Possible causes:

• Wrong memory category (user-level put into project-level)
• Memory content outdated

Troubleshoot:

1. Edit that memory
2. Correct or delete

Q3: How to back up the memory bank?

1. Find the memory bank directory %LOCALAPPDATA%\mbagent\memory\
2. Copy the entire folder to a backup location
3. Reverse the operation to restore

Q4: Can memories be synced between different computers?

✅ Yes, but manual:

1. Export memories on computer A (backup folder)
2. Import on computer B (overwrite folder)
3. Restart MBAgent

NOTE

Mbbrowser does not yet provide cloud memory sync service. Manual backup of important memories is recommended.

---

Next: Mbbrowser ControlV2 Integration → Connect MBAgent with Mbbrowser.