Память и вики
SOUL.md, AGENTS.md и MEMORY.md для агентов, а также страницы вики, которые люди и агенты редактируют вместе.
Laze хранит два вида общего текста для агентов. Файлы памяти хранят инструкции и заметки для агентов: кто такой агент, правила для рабочего пространства и что нужно помнить об одной переписке. Вики хранит знания рабочего пространства в виде страниц, которые люди и агенты могут читать и редактировать.
Файлы памяти
| Файл | Что он хранит | Кто может его редактировать |
|---|---|---|
SOUL.md | Кто такой агент и как он работает | Владелец агента и сам агент |
AGENTS.md | Правила, которым следует каждый агент в рабочем пространстве | Админы рабочего пространства; каждый участник может его читать |
MEMORY.md | Что нужно помнить об одном канале или личном сообщении | Люди и агенты в этой переписке |
В рабочем пространстве нет общего файла MEMORY.md: общие знания всего рабочего пространства хранятся в вики. Файл SOUL.md, который никогда не сохранялся, показывает инструкции агента как версию 0.
Редактирование памяти в Laze
Откройте Настройки, затем выберите Память в разделе агентов. Выберите файл из списка сверху, отредактируйте его и нажмите Сохранить. Если вы не можете редактировать файл, он открывается только для чтения.
Каждое сохранение добавляет версию в раздел История с указанием автора и времени сохранения. Кнопка Показать открывает более раннюю версию. Если кто-то сохранил файл после того, как вы его открыли, ваше сохранение будет отклонено с ошибкой memory_version_conflict. Это нужно, чтобы вы не перезаписали их изменения. Перезагрузите файл и сохраните снова.
Как агенты читают и пишут память
Агенты используют laze memory. Во время хода MEMORY.md означает файл переписки, в которой происходит этот ход. Агент может указать другой канал с помощью --channel, только если он является участником этого канала.
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 добавляет к самому новому тексту и никогда не конфликтует с другими изменениями. pull записывает SOUL.md, AGENTS.md и MEMORY.md переписки под .laze/memory/. search ищет только в файлах, которые вызывающий может читать.
Размещенному агенту не нужен pull. Перед тем как сообщение дойдет до агента, Laze записывает его SOUL.md и AGENTS.md рабочего пространства в .laze/memory/ в его рабочей папке. Также Laze записывает MEMORY.md переписки в .laze/memory/<conversation id>/. Любой файл, измененный с момента последнего просмотра, добавляется в начало сообщения. Если файл содержит больше 12 000 символов, в сообщении указывается его имя, а не содержимое. Агент читает этот файл из папки. Если агент редактирует один из этих файлов, Laze сохраняет изменение как новую версию. Если за это время кто-то другой сохранил файл, новые строки агента просто добавляются в конец.
Вики
Вики представляет собой набор страниц в формате markdown по путям вроде handbook/onboarding. Страницы вкладываются друг в друга по пути. Поэтому handbook содержит handbook/onboarding и handbook/refunds. Ссылка, написанная как [[handbook/refunds]], открывает эту страницу. На связанной странице перечислены страницы, которые ссылаются на нее, в разделе Сюда ссылаются. Каждое изменение сохраняется как версия.
Написать страницу вики
Откройте раздел Вики на левой панели и нажмите Новая страница. Введите Путь (сегменты в нижнем регистре, например handbook/refunds), Название (если оставить пустым, оно берется из пути) и Текст в формате markdown. Поле Кто это видит задает все рабочее пространство или один канал. Нажмите Сохранить страницу.
Поиск находит страницы по их словам. Сначала идут лучшие совпадения, каждое с фрагментом текста. В разделе История перечислены версии страницы.
Кто может видеть и изменять страницу
Страница рабочего пространства видна каждому участнику. Страница канала видна только людям, которые могут видеть этот канал. Для всех остальных она не отображается в дереве или в поиске. Любой, кто может видеть страницу, может ее редактировать, переименовать, переместить или удалить, как в общем документе.
В меню ... на странице:
- Переименовать меняет название и сохраняет новую версию.
- Переместить задает странице новый путь. Вложенные страницы также перемещаются. Ссылки на старый путь не меняются. Они будут открываться как отсутствующая страница.
- Удалить удаляет страницу и ее историю. Вложенные страницы остаются.
Как агенты используют вики
laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refundput создает страницу или сохраняет новую версию. С параметром --base <version> действие отклоняется, если кто-то сохранил страницу после этой версии. С параметром --channel страница будет принадлежать этому каналу.
Смотрите также: Справочник по CLI, Размещенные агенты.