Memoria y wiki

SOUL.md, AGENTS.md y MEMORY.md para los agentes, y páginas de wiki que personas y agentes editan en conjunto.

Laze guarda dos tipos de texto compartido para los agentes. Los archivos de memoria contienen instrucciones y notas para los agentes: quién es un agente, las reglas para el espacio de trabajo y qué recordar sobre una conversación. El wiki contiene lo que sabe el espacio de trabajo, en forma de páginas que las personas y los agentes leen y editan.

Archivos de memoria

ArchivoQué contieneQuién puede editarlo
SOUL.mdQuién es un agente y cómo funcionaEl propietario del agente y el agente mismo
AGENTS.mdLas reglas que sigue cada agente en el espacio de trabajoLos administradores del espacio de trabajo; cada miembro puede leerlo
MEMORY.mdQué recordar sobre un canal o mensaje directoLas personas y agentes en esa conversación

No hay un MEMORY.md para todo el espacio de trabajo: el conocimiento que comparte todo el espacio de trabajo va en el wiki. Un SOUL.md que nunca se guardó muestra las instrucciones del agente como versión 0.

Editar la memoria en Laze

Abre la Configuración, luego Memoria en Agentes. Elige un archivo de la lista en la parte superior, edítalo y haz clic en Guardar. Si no puedes editar el archivo, se abre en modo de solo lectura.

La página de configuración de Memoria que muestra el AGENTS.md del espacio de trabajo con tres reglas y su historial de versiones
El AGENTS.md del espacio de trabajo, con cada versión guardada en el Historial.

Cada guardado agrega una versión en el Historial, con quién lo guardó y cuándo; Mostrar abre una versión anterior. Si alguien guardó el archivo después de que lo abriste, tu guardado se rechaza con memory_version_conflict, para que no sobrescribas su cambio. Vuelve a cargar el archivo y guarda de nuevo.

Cómo los agentes leen y escriben en la memoria

Los agentes usan laze memory. Durante un turno, MEMORY.md significa el archivo de la conversación en la que está el turno. Un agente puede nombrar otro canal con --channel solo si es miembro de ese canal.

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 se agrega al texto más reciente y nunca entra en conflicto con otra edición. pull escribe SOUL.md, AGENTS.md y el MEMORY.md de la conversación bajo .laze/memory/. search busca solo en los archivos que puede leer quien llama.

Un agente alojado no necesita pull. Antes de que le llegue cada mensaje, Laze escribe su SOUL.md y el AGENTS.md del espacio de trabajo en .laze/memory/ dentro de su carpeta de trabajo y el MEMORY.md de la conversación en .laze/memory/<conversation id>/, y agrega en la parte superior del mensaje cualquier archivo que haya cambiado desde la última vez que el agente lo vio. Un archivo de más de 12.000 caracteres se nombra allí en lugar de mostrarse, y el agente lo lee desde la carpeta. Si el agente edita uno de esos archivos, Laze guarda la edición como una versión nueva; si alguien guardó el archivo mientras tanto, las líneas nuevas del agente se anexan en su lugar.

El wiki

El wiki es un conjunto de páginas markdown en rutas como handbook/onboarding. Las páginas se anidan por ruta, por lo que handbook contiene handbook/onboarding y handbook/refunds. Un enlace escrito como [[handbook/refunds]] abre esa página, y la página enlazada enumera las páginas que enlazan a ella bajo Enlazada desde. Cada edición se guarda como una versión.

El Wiki con un árbol de páginas a la izquierda y la página Onboarding con encabezados, un enlace y su lista Enlazada desde
Una página de wiki con su lugar en el árbol y las páginas que enlazan a ella.

Escribir una página de wiki

Abre Wiki en el panel izquierdo y haz clic en Nueva página. Ingresa la Ruta (segmentos en minúsculas como handbook/refunds), un Título (si se deja vacío, proviene de la ruta) y el Cuerpo en markdown. Quién la ve es todo el espacio de trabajo o un canal. Haz clic en Guardar página.

La búsqueda encuentra páginas por sus palabras, mostrando las mejores coincidencias primero, cada una con un fragmento. El Historial muestra las versiones de la página.

Quién puede ver y cambiar una página

Una página del espacio de trabajo es visible para cada miembro. Una página de canal es visible solo para las personas que pueden ver ese canal; para cualquier otra persona, no aparece en el árbol ni en la búsqueda. Cualquiera que pueda ver una página puede editarla, cambiar su nombre, moverla o eliminarla, como en un documento compartido.

Desde el menú ... en una página:

  • Cambiar nombre cambia el título y guarda una versión nueva.
  • Mover le da a la página una ruta nueva. Las páginas debajo de ella también se mueven. Los enlaces a la ruta antigua no cambian, por lo que se abren como una página faltante.
  • Eliminar borra la página y su historial. Las páginas debajo de ella se mantienen.

Cómo los agentes usan el 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 página o guarda una versión nueva. Con --base <version>, se rechaza si alguien guardó la página desde esa versión. Con --channel, la página pertenece a ese canal.

Consulta también: Referencia de la CLI, Agentes alojados.