Hoppa till innehåll

Hantera arbetsytans minne

Den här guiden visar hur du arbetar med en arbetsytas kunskapslager.

Det viktiga att känna till innan du börjar: minnesgränssnittet är en yta för granskning, inte för författande. Fakta och policyer skrivs av agenter — via propose_fact och propose_policy, med supersede_fact och supersede_policy för att ersätta dem. remember skriver ett sessionsbundet objekt på hot-tier-nivån som consolidate_memory senare kan befordra till en fakta. Inspelade mötesbeslut skördas in i domänen decisions; det finns ingen skörd för slutförda agentkörningar. Det du gör här är att läsa vad de skrev, rätta det, inaktivera det eller ta bort det.

Minnet finns under Inställningar → Arbetsyta → Minne (/workspaces/<id>/settings/memory). Det är inte en destination på sidofältets översta nivå.

Sidan har exakt tre flikar. Fakta och Policyer visar en aktuell räknare; grafen gör det inte:

  • Fakta — varje fakta i arbetsytan, med en räknare över de som inte är ersatta
  • Policyer — normativa regler grupperade efter domän, med en räknare över de aktiva
  • Kunskapsgraf — en interaktiv nodcanvas över domäner, ämnen, fakta och policyer

Domäner är inget du skapar. En domän uppstår när en agent skriver in den första faktan eller policyn i den; det finns ingen kontroll för att skapa domäner någonstans i gränssnittet.

  1. Öppna fliken Fakta.
  2. Använd sökrutan för att begränsa listan. Det är ett enkelt delsträngsfilter över varje faktas domän, ämne och innehåll — inget nyckelordsindex, ingen rangordning.
  3. Använd omfångsfiltret för att visa alla omfång, endast arbetsyteövergripande fakta eller en enskild repos fakta.
  4. Använd sorteringsväxlaren för att ordna efter senaste eller tillförlitlighet.
  5. Klicka på en faktas redigeringskontroll.

Redigeringsdialogen låter dig ändra:

  • Domän — flytta en fakta mellan domäner
  • Ämne — dess korta etikett
  • Innehåll — själva kunskapstexten
  • Tillförlitlighet — ett reglage med steg om 5 %

Spara för att skriva tillbaka den. Det finns ingen Lägg till fakta-knapp; dialogen öppnas bara på en befintlig rad.

Fliken Fakta har en växlare för Visa ersatta. Ersatta fakta är dolda som standard och visas av den växlaren, och det är där spårbarheten finns — att ersätta tar aldrig bort något.

Använd en faktas borttagningskontroll och bekräfta. Det här är en riktig borttagning, inte en ersättning: använd den för fakta som helt enkelt var fel att registrera, och låt agenterna ersätta fakta vars innehåll har förändrats.

Fliken Policyer grupperar aktiva policyer efter domän och flyttar inaktiva till ett avsnitt i slutet. Per policy kan du:

  • Redigera den
  • Ta bort den
  • Inaktivera / Aktivera den — det återställbara alternativet och oftast rätt. Endast aktiva policyer når agentprompter.

Precis som för fakta finns det ingen kontroll för att skapa.

Fliken Kunskapsgraf lägger ut domäner, ämnen, fakta och policyer som en navigerbar nodcanvas — panorera, zooma, dra noder. Att trycka på en nod öppnar dess detaljpanel, och därifrån nås samma redigeringsdialoger. Det är det snabbaste sättet att se vilka domäner som faktiskt har innehåll.

Arbetsminnet är ett privat kladdblock per agent som injiceras i dess prompt vid dispatch. Agenterna skriver det själva med record_observation och update_my_notes, men du kan läsa och redigera det direkt:

Inställningar → Arbetsyta → Agenter → välj agenten → fliken Minne.

Åtkomstbehörigheter för minnet mappar en agents roll till en behörighet (none, read, write) per domän. Skriv dem med operationerna memory_access_grant.*.

Två saker att förstå om hur de löses ut:

  • Läsningar är fail-open. Utan en behörighetsrad för ett (roll, domän)-par är den effektiva behörigheten read. Den enda skrivning som kastar ett fel utan write är propose_policy. Faktaskrivningar styrs inte av behörigheter.
  • Behörigheter är nycklade på agentens roll. Förslagsverktyg sätter en saknad agent_role till general som standard. En behörighet skriven för en annan roll binder inte de agenterna; det gör däremot en general-behörighet.

Tre olika saker kallas “minnessökning” och de är inte överens:

Var Vad den gör
Sökrutan på fliken Fakta Delsträngsfilter över de fakta som redan är inlästa i klienten
RPC-op:en memory_fact.search Endast FTS5-sökning på nyckelord — en tunn klient kan inte skicka med en frågeinbäddning, så hybridsökningen förblir intern i värden
Verktyget search_memory på agentsidan keyword, semantic eller hybrid (standard). Hybrid slår samman fyra röster: lexikal, semantisk, temporal och graf

En agent och minnessidan kommer alltså inte att rangordna samma fråga på samma sätt. När du kontrollerar vad en agent faktiskt kan återkalla, fråga agenten.

Fakta bäddas in vid skrivtillfället och bara när inbäddningsmodellen på enheten är installerad. Kontrollera dess status under Inställningar → Server → Diagnostik och integritet → Semantisk sökning. Installera modellen innan agenterna börjar skriva minne om du vill ha semantisk återkallning.