centersl/open-webui-docs
1
0
Fork 0
mirror of https://github.com/open-webui/docs.git synced 2026-03-26 13:18:42 +07:00
Code Issues Packages Projects Releases Wiki Activity

memory

Browse Source
This commit is contained in:
DrMelone
2026-02-19 22:21:41 +01:00
parent 6b34253f9e
commit e1a9add00f
2 changed files with 10 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/features/chat-conversations/memory.mdx
View File

@@ -23,7 +23,7 @@ Users can manually add, edit, or delete memories by navigating to:
### 2. Native Memory Tools (Agentic Mode)
When using a model with **Native Function Calling (Agentic Mode)** enabled, quality models can manage your memory autonomously using three built-in tools. For a detailed breakdown of how administrators can configure and manage these system-level tools, see the [**Central Tool Calling Guide**](/features/extensibility/plugin/tools#tool-calling-modes-default-vs-native).
When using a model with **Native Function Calling (Agentic Mode)** enabled, quality models can manage your memory autonomously using five built-in tools. For a detailed breakdown of how administrators can configure and manage these system-level tools, see the [**Central Tool Calling Guide**](/features/extensibility/plugin/tools#tool-calling-modes-default-vs-native).
:::tip Quality Models for Memory Management
Autonomous memory management works best with frontier models (GPT-5, Claude 4.5+, Gemini 3+) that can intelligently decide what facts are worth saving and when to recall relevant memories. Small local models may struggle with appropriate memory selection.
@@ -32,12 +32,16 @@ Autonomous memory management works best with frontier models (GPT-5, Claude 4.5+
- **`add_memory`**: Allows the model to proactively save a new fact it learned about you during the conversation.
- **`search_memories`**: Allows the model to search your memory bank for relevant context. Results include a unique `id` for each memory snippet. The model can optionally specify how many memories to return (default is 5).
- **`replace_memory_content`**: Allows the model to update or correct a specific existing memory using its `id`.
- **`delete_memory`**: Allows the model to remove a memory that is no longer relevant or correct, using its `id`.
- **`list_memories`**: Allows the model to retrieve all stored memories for the user, including content and timestamps.
## Benefits of the New Memory System
- **Proactive Learning**: Instead of you manually typing preferences, a model can say: *"I'll remember that you prefer dark mode for your UI projects"* and call `add_memory` behind the scenes.
- **Contextual Retrieval**: If a conversation drifts into a topic mentioned months ago, the model can "search its brain" using `search_memories` to find those past details.
- **Dynamic Correction**: If the model remembers something incorrectly, it can use `replace_memory_content` to fix the fact rather than creating a duplicate.
- **Cleanup**: The model can use `delete_memory` to remove outdated or irrelevant facts, keeping your memory bank clean.
- **Full Visibility**: Using `list_memories`, the model can review everything it knows about you and identify gaps or contradictions.
- **User Control**: Even though models can add memories, users retain full control. Every memory added by a model can be reviewed and deleted in the Personalization settings.
## Enabling Memory Tools

6
docs/features/extensibility/plugin/tools/index.mdx
View File

@@ -195,6 +195,8 @@ These models excel at multi-step reasoning, proper JSON formatting, and autonomo
| `search_memories` | Searches the user's personal memory/personalization bank. |
| `add_memory` | Stores a new fact in the user's personalization memory. |
| `replace_memory_content` | Updates an existing memory record by its unique ID. |
| `delete_memory` | Deletes a memory by its ID. |
| `list_memories` | Lists all stored memories for the user with content and dates. |
| **Notes** | *Requires `ENABLE_NOTES` AND per-model "Notes" category enabled (default: on).* |
| `search_notes` | Search the user's notes by title and content. |
| `view_note` | Get the full markdown content of a specific note. |
@@ -237,6 +239,8 @@ These models excel at multi-step reasoning, proper JSON formatting, and autonomo
| `search_memories` | `query` (required), `count` (default: 5) | Array of `{id, date, content}` |
| `add_memory` | `content` (required) | `{status: "success", id}` |
| `replace_memory_content` | `memory_id` (required), `content` (required) | `{status: "success", id, content}` |
| `delete_memory` | `memory_id` (required) | `{status: "success", message}` |
| `list_memories` | None | Array of `{id, content, created_at, updated_at}` |
| **Notes** | | |
| `search_notes` | `query` (required), `count` (default: 5), `start_timestamp`, `end_timestamp` | Array of `{id, title, snippet, updated_at}` |
| `view_note` | `note_id` (required) | `{id, title, content, updated_at, created_at}` |
@@ -317,7 +321,7 @@ When the **Builtin Tools** capability is enabled, you can further control which
| Category | Tools Included | Description |
|----------|----------------|-------------|
| **Time & Calculation** | `get_current_timestamp`, `calculate_timestamp` | Get current time and perform date/time calculations |
| **Memory** | `search_memories`, `add_memory`, `replace_memory_content` | Search and manage user memories |
| **Memory** | `search_memories`, `add_memory`, `replace_memory_content`, `delete_memory`, `list_memories` | Search and manage user memories |
| **Chat History** | `search_chats`, `view_chat` | Search and view user chat history |
| **Notes** | `search_notes`, `view_note`, `write_note`, `replace_note_content` | Search, view, and manage user notes |
| **Knowledge Base** | `list_knowledge_bases`, `search_knowledge_bases`, `query_knowledge_bases`, `search_knowledge_files`, `query_knowledge_files`, `view_knowledge_file` | Browse and query knowledge bases |