Werkruimtegeheugen beheren

Deze gids laat zien hoe je met de kennisopslag van een werkruimte werkt.

Het belangrijkste om te weten voordat je begint: de geheugen-UI is een controleoppervlak, niet een plek om te schrijven. Feiten en beleidsregels worden door agenten geschreven — via propose_fact en propose_policy, met supersede_fact en supersede_policy om ze te vervangen. remember schrijft een aan de sessie gebonden hot-tier-item dat consolidate_memory later tot een feit kan promoveren. Beslissingen uit opgenomen vergaderingen worden geoogst in het domein decisions; bij voltooide agentruns is er geen oogst. Wat je hier doet, is lezen wat ze hebben geschreven, het corrigeren, het deactiveren of het verwijderen.

Geheugen staat onder Instellingen → Werkruimte → Geheugen (/workspaces/<id>/settings/memory). Het is geen bestemming op het hoogste niveau in de zijbalk.

De drie tabbladen

De pagina heeft precies drie tabbladen. Feiten en Beleid tonen een live aantal; de grafiek niet:

Feiten — elk feit in de werkruimte, met een telling van de feiten die niet zijn vervangen
Beleid — normatieve regels gegroepeerd per domein, met een telling van de actieve
Kennisgrafiek — een interactief canvas van domeinen, onderwerpen, feiten en beleidsregels

Domeinen zijn niet iets wat je aanmaakt. Een domein ontstaat wanneer een agent het eerste feit of de eerste beleidsregel erin schrijft; er is nergens in de UI een bediening om een domein aan te maken.

Een feit controleren en corrigeren

Open het tabblad Feiten.
Gebruik het zoekvak om de lijst te verfijnen. Het is een eenvoudig substringfilter over het domein, het onderwerp en de inhoud van elk feit — geen trefwoordenindex, geen rangschikking.
Gebruik het bereikfilter om alle bereiken te tonen, alleen werkruimtebrede feiten, of de feiten van één repository.
Gebruik de sorteerschakelaar om te ordenen op recentheid of op betrouwbaarheid.
Klik op de bewerkingsbediening van een feit.

In het bewerkingsdialoogvenster kun je het volgende wijzigen:

Domein — een feit tussen domeinen verplaatsen
Onderwerp — het korte label
Inhoud — de kennistekst
Betrouwbaarheid — een schuifregelaar in stappen van 5%

Sla op om het terug te schrijven. Er is geen knop Feit toevoegen; het dialoogvenster opent alleen op een bestaande rij.

Vervangen feiten bekijken

Het tabblad Feiten heeft een schakelaar Vervangen tonen. Vervangen feiten zijn standaard verborgen en worden door die schakelaar onthuld; daar leeft het auditspoor — vervangen verwijdert nooit.

Een feit verwijderen

Gebruik de verwijderingsbediening van een feit en bevestig. Dit is een echte verwijdering, geen vervanging: gebruik het voor feiten die simpelweg verkeerd waren om vast te leggen, en laat agenten feiten vervangen waarvan de inhoud inmiddels is veranderd.

Beleidsregels beheren

Het tabblad Beleid groepeert actieve beleidsregels per domein en zet inactieve in een sectie achteraan. Per beleidsregel kun je:

Die bewerken
Die verwijderen
Die deactiveren / activeren — de omkeerbare optie en meestal de juiste. Alleen actieve beleidsregels bereiken de prompts van agenten.

Net als bij feiten is er geen bediening om iets aan te maken.

De kennisgrafiek verkennen

Het tabblad Kennisgrafiek toont domeinen, onderwerpen, feiten en beleidsregels als een navigeerbaar canvas van knooppunten — pannen, zoomen, knooppunten slepen. Als je op een knooppunt tikt, opent het detailpaneel, van waaruit dezelfde bewerkingsdialoogvensters bereikbaar zijn. Het is de snelste manier om te zien welke domeinen daadwerkelijk gevuld zijn.

Het werkgeheugen van een agent bewerken

Werkgeheugen is een privékladblok per agent, dat bij een dispatch in zijn prompt wordt geïnjecteerd. Agenten schrijven het zelf met record_observation en update_my_notes, maar je kunt het rechtstreeks lezen en bewerken:

Instellingen → Werkruimte → Agenten → selecteer de agent → het tabblad Geheugen.

Toegangsverleningen

Toegangsverleningen voor geheugen koppelen de rol van een agent aan een machtiging (none, read, write) per domein. Schrijf ze met de memory_access_grant.*-operaties.

Twee dingen zijn belangrijk om te begrijpen over hoe ze uitpakken:

Lezen is fail-open. Zonder toegangsverleningsrij voor een combinatie van (rol, domein) is de effectieve machtiging read. De enige schrijfactie die een fout gooit zonder write, is propose_policy. Het schrijven van feiten is niet aan een toegangsverlening gebonden.
Toegangsverleningen hebben de rol van de agent als sleutel. Tools voor het voorstellen stellen een ontbrekende agent_role standaard in op general. Een toegangsverlening die voor een andere rol is geschreven, bindt die agenten niet; een general-verlening wel.

Zoeken is niet overal hetzelfde

Drie verschillende dingen heten “geheugen zoeken” en ze komen niet overeen:

Waar	Wat het doet
Het zoekvak van het tabblad Feiten	Substringfilter over de feiten die al in de client zijn geladen
De RPC-operatie `memory_fact.search`	Alleen FTS5-trefwoordzoekopdracht — een thin client kan geen query-embedding meesturen, dus hybride zoeken blijft intern op de host
De tool `search_memory` aan de agentkant	`keyword`, `semantic` of `hybrid` (de standaard). Hybride voegt vier stemmen samen: lexicaal, semantisch, temporeel en grafisch

Een agent en de geheugenpagina rangschikken dezelfde query dus niet op dezelfde manier. Als je wilt nagaan wat een agent zich daadwerkelijk kan herinneren, vraag het dan aan de agent.

Embeddings

Feiten krijgen op het moment van schrijven een embedding, en alleen wanneer het embeddingmodel op het apparaat is geïnstalleerd. Controleer de status onder Instellingen → Server → Diagnose en privacy → Semantisch zoeken. Installeer het model voordat agenten geheugen beginnen te schrijven, als je semantisch ophalen wilt.