Munkaterület-memória kezelése

Ez az útmutató bemutatja, hogyan dolgozhat egy munkaterület tudástárával.

Fontos, amit még az elején tudnia kell: a memóriafelület átnézésre való, nem szerkesztésre. A tényeket és a szabályzatokat ügynökök írják — a propose_fact és a propose_policy útján, a lecserélésükhöz pedig a supersede_fact és a supersede_policy áll rendelkezésre. A remember egy munkamenethez kötött, forró szintű elemet ír, amelyet a consolidate_memory később ténnyé léptethet elő. A rögzített megbeszélés-döntések a decisions domainbe gyűlnek; a befejezett ügynökfutásokon nincs ilyen begyűjtés. Az Ön dolga itt annyi, hogy elolvassa, amit írtak, kijavítsa, deaktiválja vagy törölje.

A memória a Beállítások → Munkaterület → Memória helyen található (/workspaces/<id>/settings/memory). Nem önálló, legfelső szintű célpont az oldalsávban.

A három fül

Az oldalon pontosan három fül van. A Tények és a Szabályzatok élő darabszámot mutat, a gráf nem:

Tények — a munkaterület minden ténye, valamint azon tények száma, amelyeket nem írtak felül
Szabályzatok — domain szerint csoportosított normatív szabályok, az aktívak számával
Tudásgráf — domainek, témák, tények és szabályzatok interaktív vászna

A domaint nem Ön hozza létre. Egy domain akkor jön létre, amikor egy ügynök beírja az első tényt vagy szabályzatot; a felhasználói felületen sehol nincs domain létrehozására szolgáló vezérlő.

Tény átnézése és javítása

Nyissa meg a Tények fület.
A keresőmezővel szűkítse a listát. Ez egyszerű részstringszűrő az egyes tények domainje, témája és tartalma fölött — nincs kulcsszóindex és nincs rangsorolás.
A hatókörszűrővel megjelenítheti az összes hatókört, csak a munkaterület szintű tényeket vagy egy adott tároló tényeit.
A rendezésváltóval frissesség vagy bizonyosság szerint rendezhet.
Kattintson egy tény szerkesztésvezérlőjére.

A szerkesztőpárbeszédablakban a következőket módosíthatja:

Tartomány — a tény áthelyezése domainek között
Téma — a tény rövid címkéje
Tartalom — a tudásszöveg
Bizonyosság — csúszka 5%-os lépésekben

A mentéshez nyomja meg a Mentés gombot. Nincs Tény hozzáadása gomb; a párbeszédablak csak egy meglévő soron nyílik meg.

Felülírt tények megtekintése

A Tények fülön van egy Felülírtak megjelenítése kapcsoló. A felülírt tények alapértelmezésben rejtve vannak, és ezzel a kapcsolóval jeleníthetők meg; itt él az auditnapló — a felülírás soha nem töröl.

Tény törlése

Használja egy tény törlésvezérlőjét, és erősítse meg. Ez valódi törlés, nem felülírás: azt használja olyan tényeknél, amelyeket egyszerűen hibás volt rögzíteni, és hagyja, hogy az ügynökök írják felül azokat a tényeket, amelyeknek a tartalma továbbfejlődött.

Szabályzatok kezelése

A Szabályzatok fül domain szerint csoportosítja az aktív szabályzatokat, az inaktívakat pedig egy záró szakaszba sorolja. Szabályzatonként a következőket teheti:

Szerkesztés
Törlés
Deaktiválás / Aktiválás — ez a visszafordítható lehetőség, és általában ez a helyes választás. Csak az aktív szabályzatok jutnak el az ügynökök promptjába.

A tényekhez hasonlóan itt sincs létrehozásvezérlő.

A tudásgráf felfedezése

A Tudásgráf fül domaineket, témákat, tényeket és szabályzatokat rendez el bejárható csomópontvászonként — mozgathat, nagyíthat és húzhatja a csomópontokat. Egy csomópont megérintésével megnyílik a részletező panel, ahonnan ugyanazok a szerkesztőpárbeszédablakok érhetők el. Ez a leggyorsabb módja annak, hogy lássa, mely domainek vannak valóban feltöltve.

Ügynök munkamemóriájának szerkesztése

A munkamemória ügynökönként egy privát jegyzetfüzet, amelyet a rendszer az indítás idején injektál az ügynök promptjába. Az ügynökök maguk írják a record_observation és az update_my_notes használatával, de Ön közvetlenül is elolvashatja és szerkesztheti:

Beállítások → Munkaterület → Ügynökök → válassza ki az ügynököt → a Memória fül.

Hozzáférési engedélyek

A memória-hozzáférési engedélyek ügynökszerepeket képeznek le domainenként egy engedélyre (none, read, write). A memory_access_grant.* műveletekkel írhatók.

Két dolgot érdemes megérteni a feloldásukkal kapcsolatban:

Az olvasás fail-open. Ha egy (szerep, domain) párhoz nincs engedélysor, a tényleges engedély read. Az egyetlen írás, amely write nélkül kivételt dob, a propose_policy. A tényírásokat nem kapuzza engedély.
Az engedélyek kulcsa az ügynök szerepe. A javaslattevő eszközök a hiányzó agent_role értéket general-ra állítják. Egy másik szerephez írt engedély nem köti azokat az ügynököket; egy general engedély igen.

A keresés nem mindenhol ugyanaz

Három különböző dolgot neveznek „memóriakeresésnek”, és ezek nem egyeznek:

Hol	Mit tesz
A Tények fül keresőmezője	Részstringszűrő a kliensben már betöltött tények fölött
A `memory_fact.search` RPC-művelet	Csak FTS5 kulcsszókeresés — egy vékony kliens nem tud lekérdezési beágyazást küldeni, ezért a hibrid keresés a hoszton belül marad
Az ügynökoldali `search_memory` eszköz	`keyword`, `semantic` vagy `hybrid` (az alapértelmezett). A hibrid négy hangot von össze: lexikális, szemantikus, időbeli és gráf

Így egy ügynök és a Memória oldal ugyanazt a lekérdezést nem ugyanúgy rangsorolja. Amikor azt ellenőrzi, hogy egy ügynök valójában mire emlékszik, kérdezze meg magát az ügynököt.

Beágyazások

A tények íráskor kapnak beágyazást, és csak akkor, ha az eszközön futó beágyazási modell telepítve van. Az állapotát itt ellenőrizheti: Beállítások → Szerver → Diagnosztika és adatvédelem → Szemantikus keresés. Ha szemantikus előhívást szeretne, a modellt még azelőtt telepítse, hogy az ügynökök elkezdenének memóriát írni.