Zarządzaj pamięcią obszaru roboczego

Ten poradnik pokazuje, jak pracować z magazynem wiedzy obszaru roboczego.

Najważniejsza rzecz, którą warto wiedzieć przed rozpoczęciem: interfejs pamięci służy do przeglądania, a nie do tworzenia treści. Fakty i zasady zapisują agenci — przez propose_fact i propose_policy, a supersede_fact i supersede_policy służą do ich zastępowania. remember zapisuje element gorącej warstwy ograniczony do sesji, który consolidate_memory może później awansować na fakt. Decyzje ze spotkań są zbierane do domeny decisions; nie ma zbierania na zakończonych uruchomieniach agentów. To, co tutaj robisz, to odczyt tego, co zapisali, poprawianie, dezaktywowanie albo usuwanie.

Pamięć znajduje się w Ustawienia → Obszar roboczy → Pamięć (/workspaces/<id>/settings/memory). Nie jest to pozycja najwyższego poziomu na pasku bocznym.

Trzy karty

Strona ma dokładnie trzy karty. Fakty i Zasady pokazują liczbę na bieżąco; graf nie:

Fakty — każdy fakt w obszarze roboczym wraz z liczbą tych, które nie zostały zastąpione
Zasady — reguły normatywne pogrupowane według domeny, wraz z liczbą aktywnych
Graf wiedzy — interaktywne płótno z domenami, tematami, faktami i zasadami

Domen nie tworzy się ręcznie. Domena powstaje, gdy agent zapisze w niej pierwszy fakt albo zasadę; w interfejsie nie ma nigdzie kontrolki do tworzenia domen.

Przejrzyj i popraw fakt

Otwórz kartę Fakty.
Użyj pola wyszukiwania, aby zawęzić listę. To zwykły filtr podciągów po domenie, temacie i treści każdego faktu — bez indeksu słów kluczowych i bez rankingu.
Użyj filtra zakresu, aby pokazać wszystkie zakresy, tylko fakty obejmujące cały obszar roboczy albo fakty z jednego repozytorium.
Użyj przełącznika sortowania, aby uporządkować według świeżości albo pewności.
Kliknij kontrolkę edycji faktu.

W oknie edycji możesz zmienić:

Domena — przenoszenie faktu między domenami
Temat — jego krótką etykietę
Treść — tekst wiedzy
Pewność — suwak z krokiem 5%

Zapisz, aby utrwalić zmiany. Nie ma przycisku Dodaj fakt; okno otwiera się tylko dla istniejącego wiersza.

Zobacz zastąpione fakty

Karta Fakty ma przełącznik Pokaż zastąpione. Zastąpione fakty są domyślnie ukryte i odsłania je ten przełącznik — to w nim mieszka ścieżka audytu: zastąpienie nigdy nie usuwa.

Usuń fakt

Użyj kontrolki usuwania faktu i potwierdź. To prawdziwe usunięcie, a nie zastąpienie: używaj go w przypadku faktów, których po prostu nie warto było zapisywać, a fakty, których treść się zmieniła, pozwól zastępować agentom.

Zarządzaj zasadami

Karta Zasady grupuje aktywne zasady według domeny, a nieaktywne przenosi do sekcji na końcu. W przypadku każdej zasady możesz:

Edytować ją
Usunąć ją
Dezaktywować ją / Aktywować ją — opcja odwracalna i zwykle ta właściwa. Tylko aktywne zasady trafiają do promptów agentów.

Podobnie jak w przypadku faktów, nie ma kontrolki tworzenia.

Poznaj graf wiedzy

Karta Graf wiedzy przedstawia domeny, tematy, fakty i zasady jako nawigowalne płótno węzłów — przesuwaj, powiększaj, przeciągaj węzły. Dotknięcie węzła otwiera panel ze szczegółami, z którego dostępne są te same okna edycji. To najszybszy sposób, aby zobaczyć, które domeny są faktycznie wypełnione.

Edytuj pamięć roboczą agenta

Pamięć robocza to prywatny notatnik każdego agenta, wstrzykiwany do jego promptu w momencie wysłania. Agenci zapisują go sami przez record_observation i update_my_notes, ale możesz go odczytać i edytować bezpośrednio:

Ustawienia → Obszar roboczy → Agenci → wybierz agenta → karta Pamięć.

Granty dostępu

Granty dostępu do pamięci mapują rolę agenta na uprawnienie (none, read, write) w obrębie domeny. Zapisuje się je operacjami memory_access_grant.*.

Dwie rzeczy warto zrozumieć w kwestii tego, jak są rozstrzygane:

Odczyty działają w trybie fail-open. Gdy nie ma wiersza grantu dla pary (rola, domena), obowiązujące uprawnienie to read. Jedyny zapis, który rzuca błąd bez uprawnienia write, to propose_policy. Zapisy faktów nie wymagają grantu.
Granty są kluczowane według roli agenta. Narzędzia proponujące domyślnie przyjmują general dla brakującego agent_role. Grant zapisany dla innej roli nie wiąże tych agentów; wiąże ich grant general.

Wyszukiwanie nie wszędzie działa tak samo

Trzy różne rzeczy nazywa się „wyszukiwaniem pamięci” i nie są ze sobą zgodne:

Gdzie	Co robi
Pole wyszukiwania na karcie Fakty	Filtr podciągów po faktach już wczytanych w kliencie
Operacja RPC `memory_fact.search`	Tylko wyszukiwanie słów kluczowych FTS5 — cienki klient nie może przesłać osadzenia zapytania, więc wyszukiwanie hybrydowe pozostaje wewnętrzne dla hosta
Narzędzie `search_memory` po stronie agenta	`keyword`, `semantic` albo `hybrid` (domyślne). Hybrydowe łączy cztery głosy: leksykalny, semantyczny, czasowy i grafowy

Agent i strona Pamięć nie uszeregują więc tego samego zapytania w ten sam sposób. Gdy sprawdzasz, co agent faktycznie potrafi przywołać, zapytaj agenta.

Osadzenia

Fakty są osadzane w momencie zapisu i tylko wtedy, gdy zainstalowany jest model osadzania na urządzeniu. Sprawdź jego stan w Ustawienia → Serwer → Diagnostyka i prywatność → Wyszukiwanie semantyczne. Jeśli chcesz przywoływania semantycznego, zainstaluj model, zanim agenci zaczną zapisywać pamięć.