メモリと wiki

エージェント用の SOUL.md、AGENTS.md、MEMORY.md や、メンバーとエージェントが共同で編集する wiki ページです。

Laze はエージェント用の2種類の共有テキストを保持します。メモリファイルには、エージェントへの指示とメモ(エージェントとは何か、ワークスペースのルール、1つの会話について覚えておくべきこと)が保存されます。wiki には、人やエージェントが読んで編集するページとして、ワークスペースの知識が保存されます。

メモリファイル

ファイル内容編集できる人
SOUL.mdエージェントの役割と動作方法エージェントのオーナー、およびエージェント自身
AGENTS.mdワークスペースのすべてのエージェントが従うルールワークスペースの管理者(すべてのメンバーが閲覧可能)
MEMORY.md1つのチャンネルまたはダイレクトメッセージについて覚えておくべきことその会話に参加している人とエージェント

ワークスペース全体の MEMORY.md はありません。ワークスペース全体で共有する知識は wiki に保存します。保存されていない SOUL.md は、エージェントの指示をバージョン0として表示します。

Laze でメモリを編集する

設定を開き、エージェントの下にあるメモリを開きます。上部のリストからファイルを選んで編集し、保存をクリックします。ファイルを編集できない場合は、読み取り専用として開きます。

3つのルールとバージョン履歴を示す、ワークスペースの AGENTS.md を表示するメモリの設定ページ
ワークスペースの AGENTS.md。保存された各バージョンは履歴に表示されます。

保存するたびに、保存した人と日時が履歴にバージョンとして追加されます。表示をクリックすると、以前のバージョンが開きます。あなたがファイルを開いた後に別の誰かが保存した場合、彼らの変更を上書きしないように、あなたの保存は 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 .laze

append は最新のテキストに追記されるため、他の編集と競合することはありません。pull は、SOUL.md、AGENTS.md、およびその会話の MEMORY.md を .laze/memory/ の下に書き込みます。search は呼び出し元が読み取れるファイルのみを検索します。

ホストされているエージェントは pull を必要としません。各メッセージがエージェントに届く前に、Laze はその SOUL.md とワークスペースの AGENTS.md を作業フォルダー内の .laze/memory/ に書き込み、会話の MEMORY.md を .laze/memory/<conversation id>/ に書き込みます。そして、エージェントが最後に見てから変更されたすべてのファイルをメッセージの先頭に追加します。12,000文字を超えるファイルは内容が表示されず名前だけが追加され、エージェントはフォルダーからそのファイルを読み取ります。エージェントがこれらのファイルのいずれかを編集した場合、Laze はその編集を新しいバージョンとして保存します。その間に別の誰かがファイルを保存していた場合、エージェントの新しい行は代わりに追記されます。

wiki

wiki は、handbook/onboarding のようなパスにある markdown ページの集まりです。ページはパスによってネストされるため、handbook には handbook/onboarding と handbook/refunds が含まれます。[[handbook/refunds]] と記述されたリンクはそのページを開き、リンク先のページにはそのページにリンクしているページがリンク元にリストされます。すべての編集はバージョンとして保持されます。

左側にページツリーがあり、見出し、リンク、リンク元のリストがある Onboarding ページを表示する wiki
ツリー内の場所とリンク元のページを表示する wiki ページ。

wiki ページを書く

左側のメニューで wiki を開き、新規ページをクリックします。パス (handbook/refunds のような小文字のセグメント)、タイトル (空のままにするとパスから生成されます)、および markdown で 本文を入力します。閲覧できるメンバーには、ワークスペース全体または1つのチャンネルを指定します。ページを保存をクリックします。

検索では単語でページを見つけ、最も一致するものがスニペットとともに最初に表示されます。履歴にはページのバージョンがリストされます。

ページを閲覧および変更できる人

ワークスペースのページはすべてのメンバーが閲覧できます。チャンネルのページは、そのチャンネルを閲覧できる人のみが閲覧できます。それ以外の人には、ツリーや検索には表示されません。ページを閲覧できる人であれば誰でも、共有ドキュメントのように、ページの編集、名前の変更、移動、または削除ができます。

ページの ... メニューから:

  • 名前を変更はタイトルを変更し、新しいバージョンを保存します。
  • 移動はページに新しいパスを割り当てます。その下にあるページも一緒に移動します。古いパスへのリンクは変更されないため、開くと見つからないページとして表示されます。
  • 削除はページとその履歴を削除します。その下にあるページはそのまま残ります。

エージェントが wiki を使用する方法

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

put はページを作成するか、新しいバージョンを保存します。--base <version> を指定した場合、そのバージョン以降に誰かがページを保存していると拒否されます。--channel を指定した場合、そのページはそのチャンネルに属します。

あわせて確認: CLI リファレンス、ホスト型エージェント。