Spravujte paměť pracovního prostoru

Tenhle návod ukazuje, jak pracovat se znalostním úložištěm pracovního prostoru.

Než začneš, tohle je podstatné: rozhraní paměti je ke kontrole, ne k psaní. Fakta a politiky zapisují agenti, přes propose_fact a propose_policy. supersede_fact a supersede_policy je nahrazují. remember zapíše položku horké vrstvy vázanou na relaci a consolidate_memory ji může později povýšit na fakt. Rozhodnutí ze zaznamenaných schůzek se sklízejí do domény decisions. Dokončené běhy agentů se nesklízejí. Tady čteš, co zapsali, opravíš to, deaktivuješ, nebo smažeš.

Paměť najdeš v Nastavení → Pracovní prostor → Paměť (/workspaces/<id>/settings/memory). V postranním panelu to není položka na nejvyšší úrovni.

Tři karty

Stránka má přesně tři karty. Fakta a Politiky ukazují aktuální počet, graf ne:

Fakta – každý fakt v pracovním prostoru a počet těch, které nejsou nahrazené
Politiky – normativní pravidla seskupená podle domény a počet aktivních
Graf znalostí – interaktivní plátno domén, témat, fakt a politik

Domény nezakládáš. Doména vznikne, když do ní agent zapíše první fakt nebo první politiku. V rozhraní nikde není ovládání, kterým bys doménu založil.

Zkontroluj a oprav fakt

Otevři kartu Fakta.
Vyhledávacím polem seznam zúžíš. Je to obyčejný filtr podřetězce přes doménu, téma a obsah každého faktu. Žádný index klíčových slov, žádné řazení podle relevance.
Filtr rozsahu přepneš na Všechny rozsahy, jen na Celý pracovní prostor, nebo na fakta jednoho repozitáře.
Řazení přepneš mezi Nedávné a Jistota.
Klepni na Upravit u faktu.

V dialogu úpravy změníš:

Doména – přesun faktu mezi doménami
Téma – jeho krátký štítek
Obsah – text znalosti
Jistota – posuvník v krocích po 5 %

Uložit to zapíše zpátky. Ovládání pro přidání tu není a dialog se otevře jen nad existujícím řádkem.

Podívej se na nahrazená fakta

Na kartě Fakta je přepínač Zobrazit nahrazené. Nahrazená fakta jsou ve výchozím stavu skrytá a ten přepínač je odhalí. Tam je auditní stopa, protože nahrazení nikdy nemaže.

Smaž fakt

Klepni na Smazat u faktu a potvrď. Tohle je skutečné smazání, ne nahrazení. Použij ho u faktů, které se neměly vůbec zaznamenat, a nech agenty nahradit fakta, jejichž obsah se posunul.

Spravuj politiky

Karta Politiky seskupuje aktivní politiky podle domény a neaktivní odsouvá do závěrečné sekce. U každé politiky můžeš:

Upravit ji
Smazat ji
Deaktivovat / Aktivovat ji – vratná volba a obvykle ta správná. Do promptů agentů se dostanou jen aktivní politiky.

Stejně jako u fakt tu není ovládání pro vytvoření.

Prozkoumej graf znalostí

Karta Graf znalostí rozloží domény, témata, fakta a politiky na plátno uzlů, po kterém se pohybuješ: posun, přiblížení, tažení uzlů. Klepnutí na uzel otevře jeho detail a z něj se dostaneš ke stejným dialogům úpravy. Je to nejrychlejší způsob, jak vidět, které domény jsou opravdu naplněné.

Uprav pracovní paměť agenta

Pracovní paměť je soukromý zápisník jednoho agenta a při odeslání se mu vloží do promptu. Agenti si ji zapisují sami přes record_observation a update_my_notes, ale můžeš ji číst a upravovat přímo:

Nastavení → Pracovní prostor → Agenti → vyber agenta → karta Paměť.

Přístupové granty

Přístupové granty paměti mapují roli agenta na oprávnění (none, read, write) pro každou doménu. Zapisuješ je operacemi memory_access_grant.*.

Dvě věci k tomu, jak se vyhodnocují:

Čtení je ve výchozím stavu otevřené. Když pro dvojici (role, domain) neexistuje řádek grantu, účinné oprávnění je read. Jediný zápis, který bez write vyhodí výjimku, je propose_policy. Zápisy fakt na grant vázané nejsou.
Grant se váže na roli agenta. Nástroje pro návrh dosadí chybějící agent_role hodnotou general. Grant zapsaný pro jinou roli se na ty agenty nevztahuje. Grant general ano.

Hledání není všude stejné

Tři různé věci se jmenují „hledání v paměti“ a neshodují se:

Kde	Co dělá
Vyhledávací pole na kartě Fakta	Filtr podřetězce přes fakta, která už má klient načtená
RPC operace `memory_fact.search`	Jen hledání klíčových slov přes FTS5. Tenký klient neumí poslat embedding dotazu, takže hybridní hledání zůstává uvnitř hostitele
Nástroj `search_memory` na straně agenta	`keyword`, `semantic` nebo `hybrid` (výchozí). Hybrid slučuje čtyři hlasy: lexikální, sémantický, časový a grafový

Agent a stránka Paměť tedy stejný dotaz neseřadí stejně. Když ověřuješ, co agent skutečně dokáže vyvolat, zeptej se agenta.

Embeddingy

Fakta dostanou embedding při zápisu a jen tehdy, když je nainstalovaný embeddingový model na zařízení. Stav zkontroluješ v Nastavení → Server → Diagnostika a soukromí → Sémantické vyhledávání. Chceš-li sémantické vyvolání, nainstaluj model dřív, než agenti začnou paměť zapisovat.