Quản lý bộ nhớ không gian làm việc

Hướng dẫn này trình bày cách làm việc với kho tri thức của một không gian làm việc.

Điều quan trọng cần biết trước khi bắt đầu: giao diện bộ nhớ là bề mặt để xem lại, không phải để soạn thảo. Sự kiện và chính sách do agent ghi — thông qua propose_fact và propose_policy, cùng supersede_fact và supersede_policy để thay thế chúng. remember ghi một mục thuộc tầng nóng, giới hạn theo phiên, mà consolidate_memory có thể nâng cấp thành một sự kiện sau này. Các quyết định cuộc họp đã ghi lại được thu hoạch vào miền decisions; không có thu hoạch nào khi các lần chạy agent hoàn tất. Việc bạn làm ở đây là đọc những gì chúng đã ghi, sửa lại, vô hiệu hóa hoặc xóa đi.

Bộ nhớ nằm tại Cài đặt → Không gian làm việc → Bộ nhớ (/workspaces/<id>/settings/memory). Nó không phải là một đích đến cấp cao nhất trên thanh bên.

Ba thẻ

Trang có đúng ba thẻ. Sự kiện và Chính sách hiển thị số lượng trực tiếp; đồ thị thì không:

Sự kiện — mọi sự kiện trong không gian làm việc, kèm số lượng những sự kiện chưa bị thay thế
Chính sách — các quy tắc mang tính quy phạm được nhóm theo miền, kèm số lượng những chính sách đang hoạt động
Đồ thị tri thức — một khung tương tác gồm các miền, chủ đề, sự kiện và chính sách

Miền không phải thứ bạn tự tạo. Một miền ra đời khi agent ghi sự kiện hoặc chính sách đầu tiên vào đó; không có điều khiển tạo miền nào ở bất kỳ đâu trong giao diện.

Xem lại và sửa một sự kiện

Mở thẻ Sự kiện.
Dùng ô tìm kiếm để thu hẹp danh sách. Đây chỉ là bộ lọc chuỗi con trên miền, chủ đề và nội dung của từng sự kiện — không có chỉ mục từ khóa, không có xếp hạng.
Dùng bộ lọc phạm vi để hiển thị mọi phạm vi, chỉ sự kiện toàn không gian làm việc, hoặc sự kiện của một kho mã.
Dùng nút chuyển sắp xếp để sắp theo độ mới hoặc theo độ tin cậy.
Nhấp vào điều khiển chỉnh sửa của một sự kiện.

Hộp thoại chỉnh sửa cho phép bạn thay đổi:

Miền — di chuyển một sự kiện giữa các miền
Chủ đề — nhãn ngắn của sự kiện
Nội dung — văn bản tri thức
Độ tin cậy — thanh trượt theo bước 5%

Lưu để ghi lại. Không có nút Thêm sự kiện; hộp thoại chỉ mở trên một dòng đã tồn tại.

Xem các sự kiện bị thay thế

Thẻ Sự kiện có công tắc Hiện bản bị thay thế. Các sự kiện bị thay thế mặc định bị ẩn và được công tắc đó hiện ra; đây chính là nơi lưu dấu vết kiểm toán — việc thay thế không bao giờ xóa.

Xóa một sự kiện

Dùng điều khiển xóa của một sự kiện rồi xác nhận. Đây là xóa thật, không phải thay thế: hãy dùng nó cho những sự kiện vốn dĩ không nên ghi lại, và để agent thay thế những sự kiện mà nội dung của chúng đã thay đổi.

Quản lý chính sách

Thẻ Chính sách nhóm các chính sách đang hoạt động theo miền và đẩy những chính sách không hoạt động xuống một mục ở cuối. Với mỗi chính sách, bạn có thể:

Sửa nó
Xóa nó
Vô hiệu hóa / Kích hoạt nó — lựa chọn có thể đảo ngược và thường là lựa chọn đúng. Chỉ những chính sách đang hoạt động mới đến được prompt của agent.

Như với sự kiện, không có điều khiển tạo mới.

Khám phá đồ thị tri thức

Thẻ Đồ thị tri thức bày biện các miền, chủ đề, sự kiện và chính sách thành một khung nút có thể điều hướng — di chuyển, thu phóng, kéo các nút. Chạm vào một nút sẽ mở bảng chi tiết của nút đó, từ đó có thể truy cập chính những hộp thoại chỉnh sửa như trên. Đây là cách nhanh nhất để thấy những miền nào thực sự có dữ liệu.

Chỉnh sửa bộ nhớ làm việc của một agent

Bộ nhớ làm việc là một bảng nháp riêng tư của từng agent, được chèn vào prompt của nó tại thời điểm điều phối. Agent tự ghi vào đó bằng record_observation và update_my_notes, nhưng bạn có thể đọc và chỉnh sửa trực tiếp:

Cài đặt → Không gian làm việc → Agent → chọn agent → thẻ Bộ nhớ.

Cấp quyền truy cập

Cấp quyền truy cập bộ nhớ ánh xạ vai trò của một agent vào một quyền (none, read, write) theo từng miền. Ghi chúng bằng các thao tác memory_access_grant.*.

Hai điều cần hiểu về cách chúng được giải quyết:

Thao tác đọc mở khi lỗi. Khi không có dòng cấp quyền nào cho cặp (vai trò, miền), quyền hiệu lực là read. Thao tác ghi duy nhất ném lỗi khi không có quyền write là propose_policy. Ghi sự kiện không bị chặn bởi cấp quyền.
Cấp quyền được đánh khóa theo vai trò của agent. Các công cụ đề xuất mặc định agent_role còn thiếu thành general. Một cấp quyền viết cho vai trò khác không ràng buộc những agent đó; cấp quyền general thì có.

Tìm kiếm không giống nhau ở mọi nơi

Có ba thứ khác nhau đều được gọi là “tìm kiếm bộ nhớ” và chúng không khớp với nhau:

Nơi	Việc nó làm
Ô tìm kiếm của thẻ Sự kiện	Lọc chuỗi con trên những sự kiện đã được nạp sẵn trong máy khách
Thao tác RPC `memory_fact.search`	Chỉ tìm kiếm từ khóa FTS5 — một máy khách mỏng không thể gửi kèm embedding truy vấn, nên tìm kiếm kết hợp vẫn nằm trong nội bộ máy chủ
Công cụ `search_memory` phía agent	`keyword`, `semantic` hoặc `hybrid` (mặc định). Chế độ hybrid hợp nhất bốn tiếng nói: từ vựng, ngữ nghĩa, thời gian và đồ thị

Vì vậy, một agent và trang Bộ nhớ sẽ không xếp hạng cùng một truy vấn theo cùng một cách. Khi bạn muốn kiểm tra xem agent thực sự có thể nhớ lại được gì, hãy hỏi chính agent.

Nhúng vector

Sự kiện được nhúng tại thời điểm ghi và chỉ khi mô hình nhúng trên thiết bị đã được cài đặt. Kiểm tra trạng thái của nó tại Cài đặt → Máy chủ → Chẩn đoán & quyền riêng tư → Tìm kiếm ngữ nghĩa. Hãy cài mô hình trước khi agent bắt đầu ghi bộ nhớ nếu bạn muốn truy hồi ngữ nghĩa.