Hướng dẫn 20: Bộ nhớ Bền vững — Bộ nhớ Dài hạn

Đây là một phần trong chuỗi hướng dẫn chính thức của Hermes Agent. Xem tất cả các bài hướng dẫn

Hãy nghĩ về tính năng này như một tờ giấy ghi chú dán trên bàn làm việc của bạn: Hermes Agent sẽ ghi lại những điều quan trọng về bạn và dự án của bạn để không quên chúng giữa các cuộc trò chuyện. Không còn phải lặp lại chính mình mỗi khi bắt đầu một cuộc trò chuyện mới.

Bộ Nhớ Dài Hạn Làm Được Gì?

Thông thường, một tác tử AI sẽ bắt đầu mới mỗi phiên làm việc — nó quên hết mọi thứ khi cuộc trò chuyện kết thúc. Bộ Nhớ Dài Hạn thay đổi điều đó. Hermes Agent giữ hai tệp văn bản nhỏ trên máy tính của bạn. Nó đọc chúng ở đầu mỗi phiên làm việc, để ngay lập tức nhớ được sở thích của bạn, chi tiết dự án của bạn, và bất cứ điều gì khác mà bạn đã dạy nó.

Bước 1: Biết Hai Tệp Bộ Nhớ

Bộ nhớ của tác tử nằm trong hai tệp, được lưu trữ trong ~/.hermes/memories/:

Tệp	Nội Dung Lưu Trữ	Giới Hạn Kích Thước
MEMORY.md	Ghi chú cá nhân của tác tử — các sự kiện về môi trường, quy ước, những điều nó học được	2.200 ký tự (~800 token)
USER.md	Hồ sơ của bạn — sở thích, phong cách giao tiếp, kỳ vọng	1.375 ký tự (~500 token)

Các giới hạn này là có chủ đích. Chúng buộc tác tử chỉ giữ lại những gì quan trọng, giống như một cuốn sổ tay được sắp xếp gọn gàng thay vì một ngăn kéo bừa bộn.

Bước 2: Xem Bộ Nhớ Xuất Hiện Như Thế Nào Trong Lời Nhắc

Vào đầu mỗi phiên làm việc, tác tử tải cả hai tệp và hiển thị chúng như một ảnh chụp nhanh cố định trong lời nhắc hệ thống của nó. Đây là ví dụ về những gì tác tử “nhìn thấy”:

══════════════════════════════════════════════
BỘ NHỚ (ghi chú cá nhân của bạn) [67% — 1.474/2.200 ký tự]
══════════════════════════════════════════════
Dự án của người dùng là một dịch vụ web Rust tại ~/code/myapi sử dụng Axum + SQLx
§
Máy này chạy Ubuntu 22.04, có cài đặt Docker và Podman
§
Người dùng thích câu trả lời ngắn gọn, không thích giải thích dài dòng

Chú ý các chi tiết:

Tiêu đề cho biết đó là kho lưu trữ nào (BỘ NHỚ hoặc HỒ SƠ NGƯỜI DÙNG)
Phần trăm sử dụng và số lượng ký tự — để tác tử biết còn bao nhiêu chỗ trống
Các mục được phân tách bằng § (ký hiệu section)
Các mục có thể xuống dòng

Quan trọng: Ảnh chụp nhanh này được chụp một lần khi bắt đầu phiên và không bao giờ thay đổi giữa phiên. Nếu tác tử cập nhật bộ nhớ của nó trong khi trò chuyện, các thay đổi sẽ được lưu ngay lập tức vào đĩa nhưng sẽ không xuất hiện trong lời nhắc cho đến phiên tiếp theo. Điều này giúp mọi thứ nhanh chóng bằng cách giữ nguyên bộ nhớ đệm của mô hình.

Bước 3: Tác Tử Tự Quản Lý Bộ Nhớ Của Nó

Tác tử sử dụng một công cụ gọi là memory với ba hành động:

add — Thêm một mục bộ nhớ mới
replace — Thay thế một mục hiện có (sử dụng khớp chuỗi con với old_text)
remove — Xóa một mục không còn liên quan (cũng sử dụng old_text)

Không có hành động read vì bộ nhớ đã được chèn vào lời nhắc — tác tử luôn nhìn thấy nó.

Đây là một ví dụ đơn giản về cách tác tử có thể sử dụng công cụ:

memory action=add content="Người dùng thích gạch đầu dòng hơn là đoạn văn"

Hoặc thay thế một sở thích cũ:

memory action=replace old_text="Người dùng thích câu trả lời ngắn gọn" new_text="Người dùng thích câu trả lời một dòng có biểu tượng cảm xúc"

Bước 4: Điều Gì Xảy Ra Khi Bộ Nhớ Đầy?

Bộ nhớ không tự động nén. Khi một lần ghi vượt quá giới hạn, công cụ memory sẽ trả về lỗi thay vì âm thầm bỏ qua các mục. Tác tử sau đó tự tạo chỗ trống — hợp nhất hoặc xóa các mục trong cùng một lượt trước khi thử lại.

Cũng cần lưu ý: replace cũng bị giới hạn. Thay một mục bằng một mục dài hơn vẫn có thể vượt quá giới hạn, vì vậy nội dung mới phải được rút ngắn (hoặc xóa một mục khác) để vừa vặn.

Bước 5: Một Tác Tử Cho Mỗi Thư Mục Hermes (Quan Trọng!)

Đừng trỏ hai tiến trình tác tử vào cùng một thư mục chính Hermes. Việc ghi bộ nhớ là tự động và được tải lại vào lời nhắc hệ thống khi bắt đầu phiên, vì vậy hai trình ghi dùng chung một thư mục chính sẽ cộng dồn các mục của nhau thành một mớ hỗn độn mà cả hai đều không tạo ra. Bộ nhớ được phạm vi theo từng hồ sơ theo thiết kế — hãy cấp cho tác tử thứ hai một hồ sơ riêng. Nếu chúng cần bộ nhớ dùng chung, hãy sử dụng nhà cung cấp bộ nhớ ngoài.

Tóm Tắt

Bộ Nhớ Dài Hạn cung cấp cho Hermes Agent một cách đơn giản, có giới hạn để ghi nhớ bạn qua các phiên làm việc. Hai tệp nhỏ — MEMORY.md và USER.md — lưu giữ các ghi chú được chọn lọc, được chèn như một ảnh chụp nhanh cố định khi bắt đầu phiên. Tác tử tự quản lý các tệp này bằng công cụ memory, và các giới hạn ký tự giúp mọi thứ tập trung. Chỉ cần nhớ: một tác tử cho mỗi thư mục chính, và ảnh chụp nhanh chỉ cập nhật khi bắt đầu phiên.