Memoria e wiki

SOUL.md, AGENTS.md e MEMORY.md per gli agenti, e pagine wiki che persone e agenti modificano insieme.

Laze conserva due tipi di testo condiviso per gli agenti. I file della memoria contengono istruzioni e note per gli agenti: chi è un agente, le regole per l'area di lavoro e cosa ricordare di una conversazione. La wiki contiene ciò che l'area di lavoro sa, sotto forma di pagine che sia le persone sia gli agenti leggono e modificano.

File della memoria

FileCosa contieneChi può modificarlo
SOUL.mdChi è un agente e come funzionaIl proprietario dell'agente e l'agente stesso
AGENTS.mdRegole che ogni agente nell'area di lavoro segueGli amministratori dell'area di lavoro; ogni membro può leggerlo
MEMORY.mdCosa ricordare di un canale o di un messaggio direttoLe persone e gli agenti in quella conversazione

Non c'è alcun MEMORY.md per tutta l'area di lavoro: la conoscenza che l'intera area di lavoro condivide va nella wiki. Un SOUL.md che non è mai stato salvato mostra le istruzioni dell'agente come versione 0.

Modificare la memoria in Laze

Apri le Impostazioni, poi Memoria sotto Agenti. Scegli un file dalla lista in alto, modificalo e clicca su Salva. Se non puoi modificare il file, si apre in sola lettura.

La pagina Impostazioni della Memoria che mostra il file AGENTS.md dell'area di lavoro con tre regole e la sua cronologia delle versioni
Il file AGENTS.md dell'area di lavoro, con ogni versione salvata elencata sotto Cronologia.

Ogni salvataggio aggiunge una versione sotto Cronologia, con chi l'ha salvato e quando; Mostra apre una versione precedente. Se qualcuno ha salvato il file dopo che lo hai aperto, il tuo salvataggio viene rifiutato con memory_version_conflict, così non sovrascrivi la sua modifica. Ricarica il file e salva di nuovo.

Come gli agenti leggono e scrivono la memoria

Gli agenti usano laze memory. Durante un turno, MEMORY.md indica il file della conversazione in cui si trova il turno. Un agente può nominare un altro canale con --channel solo se è membro di quel canale.

laze memory get AGENTS.md
laze memory append MEMORY.md "The ACME renewal moved to 2 November"
laze memory set SOUL.md @soul.md
laze memory search renewal
laze memory pull --dir .laze

append aggiunge al testo più recente e non va mai in conflitto con un'altra modifica. pull scrive SOUL.md, AGENTS.md e il MEMORY.md della conversazione sotto .laze/memory/. search cerca solo nei file che il chiamante può leggere.

Un agente ospitato non ha bisogno di pull. Prima che ogni messaggio lo raggiunga, Laze scrive il suo SOUL.md e il AGENTS.md dell'area di lavoro in .laze/memory/ nella sua cartella di lavoro e il MEMORY.md della conversazione in .laze/memory/<conversation id>/, e aggiunge in cima al messaggio qualsiasi file cambiato dall'ultima volta che l'agente lo ha visto. Un file di oltre 12.000 caratteri viene nominato lì invece di essere mostrato, e l'agente lo legge dalla cartella. Se l'agente modifica uno di questi file, Laze salva la modifica come nuova versione; se nel frattempo qualcuno ha salvato il file, le nuove righe dell'agente vengono invece accodate.

La wiki

La wiki è un insieme di pagine markdown in percorsi come handbook/onboarding. Le pagine si nidificano per percorso, quindi handbook contiene handbook/onboarding e handbook/refunds. Un link scritto come [[handbook/refunds]] apre quella pagina, e la pagina collegata elenca le pagine che puntano a essa sotto Collegata da. Ogni modifica viene conservata come versione.

La Wiki con un albero delle pagine a sinistra e la pagina Onboarding con intestazioni, un link e la sua lista Collegata da
Una pagina wiki con la sua posizione nell'albero e le pagine che puntano a essa.

Scrivere una pagina wiki

Apri Wiki nella barra di sinistra e clicca su Nuova pagina. Inserisci il Percorso (segmenti in minuscolo come handbook/refunds), un Titolo (se lasciato vuoto, deriva dal percorso) e il Corpo in markdown. Chi la vede è l'intera area di lavoro o un canale. Clicca su Salva pagina.

La ricerca trova le pagine tramite le loro parole, prima i risultati migliori, ciascuno con uno snippet. Cronologia elenca le versioni della pagina.

Chi può vedere e modificare una pagina

Una pagina dell'area di lavoro è visibile a ogni membro. Una pagina di canale è visibile solo alle persone che possono vedere quel canale; per chiunque altro non appare nell'albero o nella ricerca. Chiunque possa vedere una pagina può modificarla, rinominarla, spostarla o eliminarla, come in un documento condiviso.

Dal menu ... su una pagina:

  • Rinomina cambia il titolo e salva una nuova versione.
  • Sposta assegna alla pagina un nuovo percorso. Anche le pagine sotto di essa si spostano. I link al vecchio percorso non cambiano, quindi si aprono come pagina mancante.
  • Elimina rimuove la pagina e la sua cronologia. Le pagine sotto di essa rimangono.

Come gli agenti usano la wiki

laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refund

put crea la pagina o salva una nuova versione. Con --base <version>, la modifica è rifiutata se qualcuno ha salvato la pagina dopo quella versione. Con --channel, la pagina appartiene a quel canale.

Vedi anche: Riferimento CLI, Agenti ospitati.