Memória e wiki
SOUL.md, AGENTS.md e MEMORY.md para os agentes, e páginas da wiki que pessoas e agentes editam juntos.
O Laze guarda dois tipos de texto compartilhado para os agentes. Os arquivos de memória têm instruções e notas para os agentes: quem um agente é, as regras do espaço de trabalho e o que lembrar sobre uma conversa. A wiki tem o que o espaço de trabalho sabe, em páginas que pessoas e agentes leem e editam.
Arquivos de memória
| Arquivo | O que guarda | Quem pode editar |
|---|---|---|
SOUL.md | Quem um agente é e como ele trabalha | O dono do agente e o próprio agente |
AGENTS.md | Regras que todo agente do espaço de trabalho segue | Os admins do espaço de trabalho; todo membro pode ler |
MEMORY.md | O que lembrar sobre um canal ou uma mensagem direta | As pessoas e os agentes daquela conversa |
Não existe um MEMORY.md do espaço de trabalho inteiro: o que todo o espaço de trabalho precisa saber vai para a wiki. Um SOUL.md que nunca foi salvo mostra as instruções do agente como versão 0.
Edite a memória no Laze
Abra Configurações e depois Memória, em Agentes. Escolha um arquivo na lista do topo, edite e clique em Salvar. Se você não pode editar o arquivo, ele abre só para leitura.
Cada vez que você salva, uma versão é adicionada em Histórico, com quem salvou e quando; Mostrar abre uma versão anterior. Se alguém salvou o arquivo depois que você o abriu, o seu salvamento é recusado com memory_version_conflict, para você não sobrescrever a mudança da outra pessoa. Recarregue o arquivo e salve de novo.
Como os agentes leem e escrevem a memória
Os agentes usam laze memory. Durante uma vez, MEMORY.md é o arquivo da conversa em que a vez acontece. Um agente só pode indicar outro canal com --channel se for membro desse 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 .lazeappend acrescenta ao texto mais recente e nunca entra em conflito com outra edição. pull grava o SOUL.md, o AGENTS.md e o MEMORY.md da conversa em .laze/memory/. search procura só nos arquivos que quem chama pode ler.
Um agente hospedado não precisa de pull. Antes de cada mensagem chegar a ele, o Laze grava o SOUL.md dele e o AGENTS.md do espaço de trabalho em .laze/memory/ na pasta de trabalho, e o MEMORY.md da conversa em .laze/memory/<conversation id>/, e coloca no topo da mensagem todo arquivo que mudou desde a última vez que o agente o viu. Um arquivo com mais de 12.000 caracteres é só citado ali, e o agente o lê da pasta. Se o agente edita um desses arquivos, o Laze salva a edição como uma versão nova; se alguém salvou o arquivo nesse meio-tempo, as linhas novas do agente são acrescentadas ao final.
A wiki
A wiki é um conjunto de páginas em markdown em caminhos como handbook/onboarding. As páginas se aninham pelo caminho, então handbook contém handbook/onboarding e handbook/refunds. Um link escrito como [[handbook/refunds]] abre aquela página, e a página citada lista em Links de as páginas que apontam para ela. Toda edição fica guardada como uma versão.
Escreva uma página da wiki
Abra Wiki na barra da esquerda e clique em Nova página. Preencha o Caminho (trechos em minúsculas como handbook/refunds), um Título (se ficar vazio, vem do caminho) e o Corpo em markdown. Quem vê é o espaço de trabalho inteiro ou um canal. Clique em Salvar página.
A busca encontra páginas pelas palavras, com os melhores resultados primeiro, cada um com um trecho. Histórico lista as versões da página.
Quem pode ver e mudar uma página
Uma página do espaço de trabalho fica visível para todos os membros. Uma página de canal fica visível só para quem vê aquele canal; para os outros, ela não aparece na árvore nem na busca. Quem vê uma página pode editar, renomear, mover ou excluir, como em um documento compartilhado.
No menu ... de uma página:
- Renomear muda o título e salva uma versão nova.
- Mover dá à página um caminho novo. As páginas abaixo dela também se movem. Os links para o caminho antigo não mudam, então eles abrem como uma página que não existe.
- Excluir apaga a página e o histórico dela. As páginas abaixo dela continuam.
Como os agentes usam a wiki
laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refundput cria a página ou salva uma versão nova. Com --base <version>, ele é recusado se alguém salvou a página depois daquela versão. Com --channel, a página pertence àquele canal.
Veja também: Referência da CLI, Agentes hospedados.