Gestisci la memoria dello spazio di lavoro

Questa guida mostra come lavorare con l’archivio di conoscenza di uno spazio di lavoro.

La cosa importante da sapere prima di iniziare: l’interfaccia della memoria è una superficie di revisione, non di scrittura. I fatti e le policy vengono scritti dagli agenti — tramite propose_fact e propose_policy, con supersede_fact e supersede_policy per sostituirli. remember scrive un elemento del livello hot limitato alla sessione, che consolidate_memory può in seguito promuovere a fatto. Le decisioni registrate durante le riunioni vengono raccolte nel dominio decisions; non esiste alcuna raccolta al termine delle esecuzioni degli agenti. Qui il tuo compito è leggere ciò che hanno scritto, correggerlo, disattivarlo o eliminarlo.

La memoria si trova in Impostazioni → Spazio di lavoro → Memoria (/workspaces/<id>/settings/memory). Non è una destinazione di primo livello nella barra laterale.

Le tre schede

La pagina ha esattamente tre schede. Fatti e Politiche mostrano un conteggio in tempo reale; il grafo no:

Fatti — tutti i fatti dello spazio di lavoro, con il conteggio di quelli non sostituiti
Politiche — regole normative raggruppate per dominio, con il conteggio di quelle attive
Grafo della conoscenza — una tela interattiva di domini, argomenti, fatti e policy

I domini non si creano. Un dominio nasce quando un agente vi scrive il primo fatto o la prima policy; non esiste alcun comando di creazione dei domini in nessuna parte dell’interfaccia.

Esamina e correggi un fatto

Apri la scheda Fatti.
Usa il campo di ricerca per restringere l’elenco. È un semplice filtro per sottostringa su dominio, argomento e contenuto di ogni fatto — nessun indice per parole chiave, nessuna classificazione.
Usa il filtro per ambito per mostrare tutti gli ambiti, solo i fatti dell’intero spazio di lavoro o i fatti di un singolo repository.
Usa l’interruttore di ordinamento per ordinare per data recente o per affidabilità.
Fai clic sul comando di modifica di un fatto.

La finestra di dialogo di modifica ti consente di cambiare:

Dominio — sposta un fatto da un dominio a un altro
Argomento — la sua etichetta breve
Contenuto — il testo della conoscenza
Confidenza — un cursore con incrementi del 5%

Salva per rendere effettive le modifiche. Non esiste un pulsante Aggiungi fatto; la finestra di dialogo si apre solo su una riga esistente.

Visualizza i fatti sostituiti

La scheda Fatti ha un interruttore Mostra sostituiti. I fatti sostituiti sono nascosti per impostazione predefinita e vengono rivelati da quell’interruttore, dove vive il registro di controllo — la sostituzione non elimina mai.

Elimina un fatto

Usa il comando di eliminazione di un fatto e conferma. Si tratta di un’eliminazione reale, non di una sostituzione: usala per i fatti che era semplicemente sbagliato registrare, e lascia che siano gli agenti a sostituire i fatti il cui contenuto è cambiato.

Gestisci le policy

La scheda Politiche raggruppa le policy attive per dominio e relega quelle inattive in una sezione finale. Per ogni policy puoi:

Modificarla
Eliminarla
Disattivarla / Attivarla — l’opzione reversibile e di solito quella giusta. Solo le policy attive arrivano ai prompt degli agenti.

Come per i fatti, non esiste un comando di creazione.

Esplora il grafo della conoscenza

La scheda Grafo della conoscenza dispone domini, argomenti, fatti e policy in una tela di nodi navigabile — sposta la vista, ingrandisci, trascina i nodi. Toccando un nodo si apre la sua scheda di dettaglio, dalla quale si raggiungono le stesse finestre di dialogo di modifica. È il modo più rapido per vedere quali domini sono davvero popolati.

Modifica la memoria di lavoro di un agente

La memoria di lavoro è un blocco di appunti privato per agente, iniettato nel suo prompt al momento dell’invio. Gli agenti la scrivono da soli con record_observation e update_my_notes, ma tu puoi leggerla e modificarla direttamente:

Impostazioni → Spazio di lavoro → Agenti → seleziona l’agente → la scheda Memoria.

Concessioni di accesso

Le concessioni di accesso alla memoria mappano il ruolo di un agente su un permesso (none, read, write) per dominio. Scrivile con le operazioni memory_access_grant.*.

Due cose da capire sul modo in cui vengono risolte:

Le letture sono fail-open. Senza una riga di concessione per una coppia (ruolo, dominio), il permesso effettivo è read. L’unica scrittura che genera un errore senza write è propose_policy. Le scritture di fatti non sono vincolate dalle concessioni.
Le concessioni sono indicizzate sul ruolo dell’agente. Gli strumenti di proposta impostano general come valore predefinito per un agent_role mancante. Una concessione scritta per un altro ruolo non vincola quegli agenti; una concessione general sì.

La ricerca non è uguale ovunque

Tre cose diverse si chiamano «ricerca nella memoria» e non concordano:

Dove	Che cosa fa
Il campo di ricerca della scheda Fatti	Filtro per sottostringa sui fatti già caricati nel client
L’operazione RPC `memory_fact.search`	Solo ricerca per parole chiave FTS5 — un client leggero non può inviare l’embedding di una query, quindi la ricerca ibrida resta interna all’host
Lo strumento `search_memory` lato agente	`keyword`, `semantic` o `hybrid` (il valore predefinito). La modalità ibrida fonde quattro voci: lessicale, semantica, temporale e di grafo

Quindi un agente e la pagina Memoria non classificheranno la stessa query allo stesso modo. Quando verifichi ciò che un agente riesce davvero a richiamare, chiedilo all’agente.

Gli embedding

I fatti ricevono un embedding al momento della scrittura e solo se il modello di embedding sul dispositivo è installato. Controllane lo stato in Impostazioni → Server → Diagnostica e privacy → Ricerca semantica. Installa il modello prima che gli agenti inizino a scrivere in memoria se vuoi il richiamo semantico.