@mrtrinhvn/ag-kit 1.0.9 → 1.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "Cognitive Session Manager"
|
|
3
|
+
description: "Kiến trúc Quản lý Trí nhớ Phân Nhiệm (Topic-based Memory) và Rọn Rác Ký Ức (Garbage Collection) cho các Hàng đợi Tác vụ."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# THE COGNITIVE SESSION MANAGER: THIẾT KẾ BỘ NHỚ THEO PHIÊN
|
|
7
|
+
|
|
8
|
+
Toàn bộ các Lõi LLM-Agents (Orchestrator hoặc Sub-Agents Doctor) tuyệt đối không được dùng chung một mảng `ChatHistory` tĩnh nằm trên RAM. Đây là hành vi chống mô-đun (anti-pattern) sẽ dẫn đến rò rỉ trí nhớ và nhầm lẫn bối cảnh.
|
|
9
|
+
|
|
10
|
+
Bạn **BẮT BUỘC** phải tuân thủ Kiến trúc Ký Ức Phân Hạch (Fission Memory) sau đây:
|
|
11
|
+
|
|
12
|
+
## 1. File-Based Isolation (Nguyên lý Thùng Chứa Độc Lập)
|
|
13
|
+
Bất cứ khi nào Agent nhận được một luồng chat mới hoặc một sự cố mới (Crash), hãy gán cho nó một ID duy nhất:
|
|
14
|
+
- Tương tác với Khách hàng: `topic-<threadId>` hoặc `chat-<userId>`
|
|
15
|
+
- Tương tác nội bộ (Doctor Box): `doc-heal-<target>-<timestamp>`
|
|
16
|
+
|
|
17
|
+
Tất cả Lịch sử Suy nghĩ (Thoughts), Tool Calls, và Lỗi của Session đó phải lưu xuống Ổ cứng (Ví dụ: `.data/sessions/topic-123.json`) thông qua `SessionManager.ts`.
|
|
18
|
+
|
|
19
|
+
## 2. Ephemeral Injection (Giới Hạn Tầm Nhìn)
|
|
20
|
+
Mỗi lần khởi tạo LLM Prompt, chỉ được phép nạp **6 đến 10 tin nhắn gần nhất** từ File JSON của Session đó vào `ContextWindow` làm Working Memory. Nếu nạp quá nhiều, LLM (đặc biệt là model local như Nvidia/Groq) sẽ bị đuối Token và sinh ra ảo giác.
|
|
21
|
+
|
|
22
|
+
## 3. Lệnh Tử Hình Ký Ức (Garbage Collection)
|
|
23
|
+
Ký ức của Session là rác sau khi tác vụ hoàn thành. Khi hệ thống nhận lệnh `/close`, `/end`, `/forget` từ User, hoặc khi Bác Sĩ Sub-Agent chạy pass xong Unit Test:
|
|
24
|
+
- Hệ thống phải gọi hàm `SessionManager.destroySession(sessionId)` nhằm dùng hàm `fs.unlink()` Xóa Vĩnh Viễn file JSON của Session đó khỏi ổ đĩa.
|
|
25
|
+
- Hành động này giữ cho dự án siêu nhẹ nhàng vĩnh viễn, giải phóng mặt bằng cho các Topic khác.
|
|
26
|
+
|
|
27
|
+
## Tóm gọn Nguyên tắc
|
|
28
|
+
"Cấp ID -> Ghi vào Ổ Cứng -> Giới hạn RAM lúc Suy Nghĩ -> Hoàn tất -> Đốt sạch Hồ sơ."
|
package/package.json
CHANGED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "Cognitive Session Manager"
|
|
3
|
+
description: "Kiến trúc Quản lý Trí nhớ Phân Nhiệm (Topic-based Memory) và Rọn Rác Ký Ức (Garbage Collection) cho các Hàng đợi Tác vụ."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# THE COGNITIVE SESSION MANAGER: THIẾT KẾ BỘ NHỚ THEO PHIÊN
|
|
7
|
+
|
|
8
|
+
Toàn bộ các Lõi LLM-Agents (Orchestrator hoặc Sub-Agents Doctor) tuyệt đối không được dùng chung một mảng `ChatHistory` tĩnh nằm trên RAM. Đây là hành vi chống mô-đun (anti-pattern) sẽ dẫn đến rò rỉ trí nhớ và nhầm lẫn bối cảnh.
|
|
9
|
+
|
|
10
|
+
Bạn **BẮT BUỘC** phải tuân thủ Kiến trúc Ký Ức Phân Hạch (Fission Memory) sau đây:
|
|
11
|
+
|
|
12
|
+
## 1. File-Based Isolation (Nguyên lý Thùng Chứa Độc Lập)
|
|
13
|
+
Bất cứ khi nào Agent nhận được một luồng chat mới hoặc một sự cố mới (Crash), hãy gán cho nó một ID duy nhất:
|
|
14
|
+
- Tương tác với Khách hàng: `topic-<threadId>` hoặc `chat-<userId>`
|
|
15
|
+
- Tương tác nội bộ (Doctor Box): `doc-heal-<target>-<timestamp>`
|
|
16
|
+
|
|
17
|
+
Tất cả Lịch sử Suy nghĩ (Thoughts), Tool Calls, và Lỗi của Session đó phải lưu xuống Ổ cứng (Ví dụ: `.data/sessions/topic-123.json`) thông qua `SessionManager.ts`.
|
|
18
|
+
|
|
19
|
+
## 2. Ephemeral Injection (Giới Hạn Tầm Nhìn)
|
|
20
|
+
Mỗi lần khởi tạo LLM Prompt, chỉ được phép nạp **6 đến 10 tin nhắn gần nhất** từ File JSON của Session đó vào `ContextWindow` làm Working Memory. Nếu nạp quá nhiều, LLM (đặc biệt là model local như Nvidia/Groq) sẽ bị đuối Token và sinh ra ảo giác.
|
|
21
|
+
|
|
22
|
+
## 3. Lệnh Tử Hình Ký Ức (Garbage Collection)
|
|
23
|
+
Ký ức của Session là rác sau khi tác vụ hoàn thành. Khi hệ thống nhận lệnh `/close`, `/end`, `/forget` từ User, hoặc khi Bác Sĩ Sub-Agent chạy pass xong Unit Test:
|
|
24
|
+
- Hệ thống phải gọi hàm `SessionManager.destroySession(sessionId)` nhằm dùng hàm `fs.unlink()` Xóa Vĩnh Viễn file JSON của Session đó khỏi ổ đĩa.
|
|
25
|
+
- Hành động này giữ cho dự án siêu nhẹ nhàng vĩnh viễn, giải phóng mặt bằng cho các Topic khác.
|
|
26
|
+
|
|
27
|
+
## Tóm gọn Nguyên tắc
|
|
28
|
+
"Cấp ID -> Ghi vào Ổ Cứng -> Giới hạn RAM lúc Suy Nghĩ -> Hoàn tất -> Đốt sạch Hồ sơ."
|