Luồng ghi và phê duyệt
Luồng ghi là ranh giới tin cậy. Agent đề xuất, con người phê duyệt.
Luồng ghi
- Agent đề xuất một hoặc nhiều ứng viên.
Với
save-session --query-level <n>, agent có thể xem xét tối đa n cuộc trò chuyện gần đây giữa người và agent mà có thể truy cập, nhưng chỉ dùng làm ngữ cảnh đề xuất. Câu tự nhiên/engram ss -f last 50 sessionscó cùng phạm vi đó cộng với sự phê duyệt buộc lưu tường minh:engram save-session --query-level 50 --force. - Engram phân tích loại ứng viên và phạm vi đích.
- Engram kiểm tra schema, bí mật, các mẫu prompt-injection và an toàn đường dẫn.
- Con người thấy bản xem trước. Mỗi ứng viên mang một dòng
Verdict:xác định:ADD,UPDATE <id>,SUPERSEDE <id>hoặcNOOP duplicate of <id>(không gọi mô hình). - Phản hồi trên CLI trực tiếp dùng
A,A 1,3,B <note>hoặcC. - Phản hồi trong chat với AI agent dùng
yes,audithoặccancelsau các ứng viên đã được hiển thị chính xác. - Chỉ bộ nhớ đã duyệt mới được ghi.
AvàBbỏ qua các ứng viênNOOP, và việc phê duyệt mộtSUPERSEDEđánh dấu bộ nhớ cũ là đã bị thay thế;--forcevà autosave không bao giờ áp dụngSUPERSEDE, mà hoãn lại để rà soát. - Chỉ mục, đồ thị, hash và changelog được làm mới.
Từ phê duyệt
Các từ phê duyệt là yes, approve, confirm hoặc save. Các từ audit là audit, revise, correct hoặc văn bản thay thế đã chỉnh sửa. Các từ hủy là cancel, stop hoặc lời từ chối. Chỉ sự phê duyệt sau khi đã hiển thị chính xác các ứng viên mới ủy quyền engram save-session --force cho những ứng viên đó.
CLI terminal trực tiếp vẫn là A/B/C. Các công cụ đề xuất MCP vẫn không ghi.
Gợi ý về bộ nhớ liên quan
Khi engram save tìm thấy các bộ nhớ đang hoạt động có liên quan, bản xem trước phê duyệt báo cáo chúng kèm gợi ý depends_on hoặc cảnh báo có thể trùng lặp. Chấp nhận sẽ lưu bản xem trước nguyên trạng; hãy từ chối trước nếu bạn muốn tái cấu trúc phụ thuộc hoặc lưu trữ các bản trùng lặp trước khi lưu.
Với save-session --force, Engram tạm dừng trước khi ghi nếu xuất hiện các gợi ý bộ nhớ liên quan đó. Agent nên dùng phản hồi để brainstorm một lần chạy lại có cấu trúc: thêm DEPENDS_ON: memory-id cho các phụ thuộc, LEVEL: advanced khi một bộ nhớ sâu hơn tiền đề của nó, hoặc UPDATE: memory-id khi một ứng viên nên hợp nhất vào một bản có thể trùng lặp.
Bộ nhớ có bằng chứng
Với tài liệu nguồn cần được rà soát trước khi trở thành bộ nhớ đang hoạt động:
engram observe --file session.md
engram save-session --file .agents/.engram/inbox/<observation>.md
Lệnh đầu tiên làm sạch nguồn và ghi một dấu vết bất biến được định danh bằng trace_id cùng một lớp bọc inbox có thể chỉnh sửa. Lệnh thứ hai đối chiếu lớp bọc về dấu vết của nó, xác minh hash và phạm vi, rồi chỉ ghi bộ nhớ schema v3 đã được con người phê duyệt kèm evidence_refs. Chỉnh sửa ## Raw Note không thể thay thế bằng chứng là dấu vết.
Các kiểm tra an toàn khi lưu
- Kiểm tra schema
- Quét bí mật
- Quét prompt-injection
- An toàn đường dẫn
- Toàn vẹn hash
Vì sao điều này quan trọng
Nếu không có giao thức, bộ nhớ có thể trở thành trạng thái vô hình. Trạng thái vô hình khó rà soát, khó chia sẻ và dễ bị agent làm nhiễm một cách vô tình.
Engram cố ý làm cho bộ nhớ trở nên nhàm chán: tệp, diff, hash, các cổng rà soát và các lệnh mà con người có thể chạy lại.