Arbeitsbereichs-Gedächtnis verwalten
Diese Anleitung zeigt, wie du mit dem Wissensspeicher eines Arbeitsbereichs arbeitest.
Das Wichtigste, bevor du anfängst: die Gedächtnis-Oberfläche dient dem Prüfen, nicht dem Verfassen. Fakten und Richtlinien schreiben Agenten — über propose_fact und propose_policy, mit supersede_fact und supersede_policy zum Ersetzen. remember schreibt einen auf die Sitzung begrenzten Eintrag der heißen Stufe, den consolidate_memory später zu einem Fakt befördern kann. Festgehaltene Besprechungsentscheidungen werden in die Domäne decisions übernommen; abgeschlossene Agentenläufe lösen keine solche Übernahme aus. Was du hier tust, ist lesen, was sie geschrieben haben, es korrigieren, deaktivieren oder löschen.
Das Gedächtnis liegt unter Einstellungen → Arbeitsbereich → Gedächtnis (/workspaces/<id>/settings/memory). Es ist kein Eintrag der Seitenleiste auf oberster Ebene.
Die drei Reiter
Abschnitt betitelt „Die drei Reiter“Die Seite hat genau drei Reiter. Fakten und Richtlinien zeigen eine aktuelle Anzahl; der Graph nicht:
- Fakten — jeder Fakt im Arbeitsbereich, mit der Anzahl derer, die nicht ersetzt sind
- Richtlinien — normative Regeln, nach Domäne gruppiert, mit der Anzahl der aktiven
- Wissensgraph — eine interaktive Fläche aus Domänen, Themen, Fakten und Richtlinien
Domänen legst du nicht selbst an. Eine Domäne entsteht, wenn ein Agent den ersten Fakt oder die erste Richtlinie hineinschreibt; in der Oberfläche gibt es nirgends eine Steuerung zum Anlegen einer Domäne.
Einen Fakt prüfen und korrigieren
Abschnitt betitelt „Einen Fakt prüfen und korrigieren“- Öffne den Reiter Fakten.
- Grenz die Liste über das Suchfeld ein. Es ist ein schlichter Teilstring-Filter über Domäne, Thema und Inhalt jedes Fakts — ohne Schlüsselwortindex und ohne Rangfolge.
- Mit dem Bereichsfilter zeigst du Alle Bereiche, nur Gesamter Arbeitsbereich oder die Fakten eines Repositorys.
- Mit dem Sortierumschalter ordnest du nach Neueste oder nach Konfidenz.
- Klicke bei einem Fakt auf Bearbeiten.
Im Bearbeitungsdialog änderst du:
- Domäne — einen Fakt in eine andere Domäne verschieben
- Thema — seine kurze Bezeichnung
- Inhalt — der Wissenstext
- Konfidenz — ein Schieberegler in Schritten von 5 %
Mit Speichern schreibst du ihn zurück. Es gibt keine Schaltfläche Neuer Fakt; der Dialog öffnet sich nur bei einer vorhandenen Zeile.
Ersetzte Fakten anzeigen
Abschnitt betitelt „Ersetzte Fakten anzeigen“Der Reiter Fakten hat den Schalter Ersetzte anzeigen. Ersetzte Fakten sind standardmäßig verborgen und erscheinen über diesen Schalter; dort liegt der Prüfpfad — Ersetzen löscht nie.
Einen Fakt löschen
Abschnitt betitelt „Einen Fakt löschen“Klicke bei einem Fakt auf Löschen und bestätige. Das ist ein echtes Löschen, kein Ersetzen: nimm es für Fakten, die schlicht falsch waren, und lass Agenten Fakten ersetzen, deren Inhalt sich weiterentwickelt hat.
Richtlinien verwalten
Abschnitt betitelt „Richtlinien verwalten“Der Reiter Richtlinien gruppiert aktive Richtlinien nach Domäne und setzt inaktive in einen Abschnitt am Ende. Pro Richtlinie kannst du:
- Bearbeiten
- Löschen
- Deaktivieren / Aktivieren — die umkehrbare Option und meist die richtige. Nur aktive Richtlinien erreichen die Prompts der Agenten.
Wie bei den Fakten gibt es keine Steuerung zum Anlegen.
Den Wissensgraph erkunden
Abschnitt betitelt „Den Wissensgraph erkunden“Der Reiter Wissensgraph legt Domänen, Themen, Fakten und Richtlinien als navigierbare Knotenfläche aus — schwenken, zoomen, Knoten ziehen. Ein Antippen eines Knotens öffnet sein Detailblatt, und von dort erreichst du dieselben Bearbeitungsdialoge. So siehst du am schnellsten, welche Domänen tatsächlich belegt sind.
Das Arbeitsgedächtnis eines Agenten bearbeiten
Abschnitt betitelt „Das Arbeitsgedächtnis eines Agenten bearbeiten“Das Arbeitsgedächtnis ist ein privater Notizblock je Agent und wird bei der Ausführung in seinen Prompt injiziert. Agenten schreiben ihn selbst mit record_observation und update_my_notes, du kannst ihn aber direkt lesen und bearbeiten:
Einstellungen → Arbeitsbereich → Agenten → den Agenten auswählen → der Reiter Gedächtnis.
Zugriffs-Grants
Abschnitt betitelt „Zugriffs-Grants“Gedächtnis-Grants ordnen der Rolle eines Agenten je Domäne eine Berechtigung zu (none, read, write). Du schreibst sie mit den Operationen memory_access_grant.*.
Zwei Dinge dazu, wie sie aufgelöst werden:
- Lesezugriffe fallen offen aus. Gibt es keine Grant-Zeile für ein Paar (role, domain), ist die wirksame Berechtigung
read. Der einzige Schreibvorgang, der ohnewriteeine Ausnahme wirft, istpropose_policy. Schreibvorgänge an Fakten hängen nicht an einem Grant. - Grants hängen an der Rolle des Agenten. Vorschlagswerkzeuge setzen ein fehlendes
agent_rolestandardmäßig aufgeneral. Ein Grant für eine andere Rolle bindet diese Agenten nicht; ein Grant fürgeneralschon.
Die Suche ist nicht überall dieselbe
Abschnitt betitelt „Die Suche ist nicht überall dieselbe“Drei verschiedene Dinge heißen „Gedächtnissuche“, und sie meinen nicht dasselbe:
| Wo | Was es tut |
|---|---|
| Das Suchfeld im Reiter Fakten | Teilstring-Filter über die Fakten, die der Client bereits geladen hat |
Die RPC-Operation memory_fact.search |
nur Schlüsselwortsuche mit FTS5 — ein dünner Client kann kein Anfrage-Embedding mitschicken, deshalb bleibt die hybride Suche im Host |
Das Werkzeug search_memory beim Agent |
keyword, semantic oder hybrid (die Voreinstellung). Hybrid führt vier Stimmen zusammen: lexikalisch, semantisch, zeitlich und Graph |
Ein Agent und die Seite Gedächtnis bringen dieselbe Anfrage also nicht in dieselbe Reihenfolge. Wenn du prüfst, was ein Agent wirklich abrufen kann, frag den Agenten.
Einbettungen
Abschnitt betitelt „Einbettungen“Fakten werden beim Schreiben eingebettet, und nur dann, wenn das Embedding-Modell auf dem Gerät installiert ist. Den Status prüfst du unter Einstellungen → Server → Diagnose und Datenschutz → Semantische Suche. Installiere das Modell, bevor Agenten Gedächtnis schreiben, wenn du semantischen Abruf willst.