Skip to content

Commit 0830577

Browse files
authored
📝 Add memory management user guide in Chinese and English
2 parents 3cff130 + 3dbdf17 commit 0830577

File tree

8 files changed

+170
-0
lines changed

8 files changed

+170
-0
lines changed
13.1 KB
Loading
13.7 KB
Loading
14.8 KB
Loading

doc/docs/en/user-guide/memory.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# 🧠Nexent Intelligent Memory System Technical Specification
2+
3+
## 1. System Architecture Overview
4+
5+
The Nexent Intelligent Memory System is built on an advanced memory storage architecture that provides intelligent agents with persistent context-aware capabilities. Through a multi-layered memory management mechanism, the system achieves cross-conversation knowledge accumulation and retrieval, significantly enhancing the coherence and personalization of human-machine interactions.
6+
7+
### Core Technical Features
8+
- **Layered Memory Architecture**: Four-level memory storage system built on the mem0 framework
9+
- **Adaptive Memory Management**: Supports both automated and manual memory operation modes
10+
- **Cross-Session Persistence**: Ensures continuity of knowledge and context across multiple conversations
11+
- **Fine-Grained Permission Control**: Provides flexible memory sharing strategy configuration
12+
13+
---
14+
15+
## 2. Configuration and Initialization
16+
17+
### 2.1 System Activation
18+
1. Access the memory management interface: Click the **Memory Management Icon** in the upper right corner of the conversation interface
19+
2. Enter the **System Configuration** module for initialization settings
20+
21+
### 2.2 Core Configuration Parameters
22+
23+
| Configuration Item | Options | Default Value | Description |
24+
|-------------------|---------|---------------|-------------|
25+
| Memory Service Status | Enable/Disable | Enable | Controls the operational status of the entire memory system |
26+
| Agent Memory Sharing Strategy | Always Share/Ask Me Each Time/Prohibit Sharing | Always Share | Defines whether user authorization consent is required for memory sharing between agents |
27+
28+
<div style="display: flex; justify-content: left;">
29+
<img src="./assets/memory/mem-config.png" style="width: 80%; height: auto;" alt="Select Agent" />
30+
</div>
31+
32+
---
33+
34+
## 3. Layered Memory Architecture
35+
36+
Nexent adopts a four-layer memory storage architecture based on **mem0**, achieving precise memory classification and retrieval through different scopes and lifecycle management:
37+
38+
### 3.1 Architecture Layer Details
39+
40+
| Memory Level | Scope | Storage Content | Lifecycle | Configuration Role | Typical Applications |
41+
|--------------|-------|-----------------|-----------|-------------------|---------------------|
42+
| **Tenant Level Memory** | Organization-wide | Enterprise-level standard operating procedures, compliance policies, organizational structure, factual information | Long-term storage | Tenant Administrator | Enterprise knowledge management, standardized process execution, compliance checking |
43+
| **Agent Level Memory** | Specific Agent | Professional domain knowledge, skill templates, historical conversation summaries, learning accumulation | Consistent with agent lifecycle | Tenant Administrator | Professional skill accumulation, domain knowledge sedimentation, experiential learning |
44+
| **User Level Memory** | Specific User Account | Personal preference settings, usage habits, common instruction templates, personal information | Long-term storage | All Users | Personalized services, user experience optimization, preference management |
45+
| **User-Agent Level Memory** | Specific Agent under Specific User Account | Collaboration history, personalized factual information, specific task context, relationship models | Consistent with agent lifecycle | All Users | Deep collaboration scenarios, personalized tuning, task continuity maintenance |
46+
47+
### 3.2 Memory Priority and Retrieval Strategy
48+
49+
Memory retrieval follows the following priority order (from high to low):
50+
1. **Tenant Level** → Basic facts
51+
2. **User-Agent Level** → Most specific context information
52+
3. **User Level** → Personal preferences and habits
53+
4. **Agent Level** → Professional knowledge and skills
54+
55+
---
56+
57+
## 4. Operation Modes and Functional Interfaces
58+
59+
### 4.1 Automated Memory Management
60+
- **Intelligent Extraction**: Automatically identifies key factual information in conversations and generates memory entries
61+
- **Automatic Context Embedding**: Agents automatically retrieve the most relevant memory entries and implicitly embed them in conversation context
62+
- **Incremental Updates**: Supports progressive updates, supplementation, and automatic cleanup of memory content
63+
64+
### 4.2 Manual Memory Operations
65+
66+
#### Adding Memory
67+
- Click the green plus button, input text, then click the checkmark to add a memory entry (maximum 500 characters)
68+
69+
<div style="display: flex; justify-content: left;">
70+
<img src="./assets/memory/add-mem.png" style="width: 80%; height: auto;" alt="Select Agent" />
71+
</div>
72+
73+
#### Deleting Memory
74+
- Click the red cross button, then click confirm in the popup confirmation dialog to delete all memory entries under a specific Agent group
75+
- Click the red eraser button to delete a specific memory entry
76+
77+
<div style="display: flex; justify-content: left;">
78+
<img src="./assets/memory/delete-mem.png" style="width: 80%; height: auto;" alt="Select Agent" />
79+
</div>
80+
81+
### 4.3 Memory Management Best Practices
82+
83+
1. **Atomicity Principle**: Each memory entry should contain **concise**, **single**, **clear** factual information
84+
2. **Temporal Management**: Regularly clean up outdated or no longer relevant memory entries to maintain the timeliness and accuracy of the memory database
85+
3. **Privacy Protection**: Sensitive information should be avoided from being shared at the tenant level or agent level
14.3 KB
Loading
15.1 KB
Loading
15.7 KB
Loading

doc/docs/zh/user-guide/memory.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# 🧠Nexent 智能记忆系统技术规格说明
2+
3+
## 1. 系统架构概述
4+
5+
Nexent 智能记忆系统基于先进的记忆存储架构,为智能体提供持久化的上下文感知能力。该系统通过多层级记忆管理机制,实现了跨对话会话的知识累积与检索,显著提升了人机交互的连贯性和个性化程度。
6+
7+
### 核心技术特性
8+
- **分层记忆架构**:基于 mem0 框架构建的四级记忆存储体系
9+
- **自适应记忆管理**:支持自动化和手动化的记忆操作模式
10+
- **跨会话持久化**:确保知识和上下文在多次对话中的连续性
11+
- **细粒度权限控制**:提供灵活的记忆共享策略配置
12+
13+
---
14+
15+
## 2. 配置与初始化
16+
17+
### 2.1 系统激活
18+
1. 访问记忆管理界面:点击对话界面右上角的**记忆管理图标**
19+
2. 进入**系统配置**模块进行初始化设置
20+
21+
### 2.2 核心配置参数
22+
23+
| 配置项 | 选项 | 默认值 | 说明 |
24+
|--------|-----------------|--------|--------------------------|
25+
| 记忆服务状态 | 启用/禁用 | 启用 | 控制整个记忆系统的运行状态 |
26+
| Agent 记忆共享策略 | 总是共享/每次询问我/禁止共享 | 总是共享 | 定义Agent间共享记忆生成是否需要用户授权同意 |
27+
28+
<div style="display: flex; justify-content: left;">
29+
<img src="./assets/memory/mem-config.png" style="width: 80%; height: auto;" alt="选择智能体" />
30+
</div>
31+
32+
---
33+
34+
## 3. 分层记忆架构
35+
36+
Nexent 采用基于 **mem0** 的四层记忆存储架构,通过不同的作用域和生命周期管理,实现精确的记忆分类与检索:
37+
38+
### 3.1 架构层级详解
39+
40+
| 记忆级别 | 作用域 | 存储内容 | 生命周期 | 配置角色 | 典型应用 |
41+
|---------|--------|----------|----------|----------|----------|
42+
| **租户级记忆**<br/>(Tenant Level Memory) | 组织全局 | 企业级标准操作流程、合规政策、组织架构、事实信息 | 长期存储 | 租户管理员 | 企业知识管理、标准化流程执行、合规性检查 |
43+
| **智能体级记忆**<br/>(Agent Level Memory) | 特定智能体 | 专业领域知识、技能模板、历史对话摘要、学习积累 | 与智能体生命周期一致 | 租户管理员 | 专业技能积累、领域知识沉淀、经验学习 |
44+
| **用户级记忆**<br/>(User Level Memory) | 特定用户账户 | 个人偏好设置、使用习惯、常用指令模板、个人信息 | 长期存储 | 全体用户 | 个性化服务、用户体验优化、偏好管理 |
45+
| **用户-智能体级记忆**<br/>(User-Agent Level Memory) | 特定用户账户下的特定智能体 | 协作历史、个性化事实信息、特定任务上下文、关系模型 | 与智能体生命周期一致 | 全体用户 | 深度协作场景、个性化调优、任务连续性维护 |
46+
47+
### 3.2 记忆优先级与检索策略
48+
49+
记忆检索遵循以下优先级顺序(由高到低):
50+
1. **租户级** → 基础事实
51+
2. **用户-智能体级** → 最具体的上下文信息
52+
2. **用户级** → 个人偏好和习惯
53+
3. **智能体级** → 专业知识和技能
54+
55+
---
56+
57+
## 4. 操作模式与功能接口
58+
59+
### 4.1 自动化记忆管理
60+
- **智能提取**:自动识别对话中的关键事实信息并生成记忆条目
61+
- **自动上下文嵌入**:智能体将自动检索相关性最高的记忆条目,隐式嵌入对话上下文中
62+
- **增量更新**:支持记忆内容的渐进式更新、补充和自动清理
63+
64+
### 4.2 手动记忆操作
65+
66+
#### 添加记忆
67+
- 点击绿色的“对话加号”按钮,输入文本,再点击对钩可添加一条记忆条目(最多500字符)
68+
69+
<div style="display: flex; justify-content: left;">
70+
<img src="./assets/memory/add-mem.png" style="width: 80%; height: auto;" alt="选择智能体" />
71+
</div>
72+
73+
#### 删除记忆
74+
- 点击红色叉号按钮,在跳出的二次确认弹框中点击确认按钮,可删除某个Agent分组下所有的记忆条目
75+
- 点击红色橡皮按钮,可删除特定的一条记忆条目
76+
77+
<div style="display: flex; justify-content: left;">
78+
<img src="./assets/memory/delete-mem.png" style="width: 80%; height: auto;" alt="Select Agent" />
79+
</div>
80+
81+
### 4.3 记忆管理最佳实践
82+
83+
1. **原子性原则**:每条记忆应包含 **简洁****单一****明确** 的事实信息
84+
2. **时效性管理**:定期清理过时或不再相关的记忆条目,保持记忆库的时效性和准确性
85+
3. **隐私保护**:敏感信息应尽量避免在租户层级或智能体层级进行共享

0 commit comments

Comments
 (0)