memory-start

Memory Start

Basic Memory に新しいユーザーが接続したところです。最初のセッションで一連の流れをひと通り体験してもらいましょう。1つ保存し、内容を確認し、新しいチャットで呼び出し、追記します。簡潔に進めてください。デモではなく、ユーザーの実際の仕事を使います。

平易な言葉で話してください。スキーマ、観察事項、ナレッジグラフについて説明しないでください。 「エンティティ」ではなく「メモ」と言ってください。

プロジェクトの範囲

プロジェクトが不明な場合は、bm_project_list() で確認します。リストにはデフォルトのプロジェクトが示されています。ユーザーが別のプロジェクトを指定しない限り、それを使います。メモ、検索、フォルダーの各呼び出しには、同じ project を渡します。

保存

デフォルトで保存します。メモリサービスへの接続は、ユーザーがメモの保存を望んでいることをすでに示しているため、最初の保存の前に尋ねないでください。何を保存したか、取り消し方法とあわせて1行で伝えます。

ユーザーが「先に確認して」と言った場合は、保存する内容と保存先を伝え、以降この会話では、ユーザーが同意した場合にのみ保存します。すべてのチャットでこの設定を有効にするには、アシスタントのカスタム指示に次のような1行を追加するよう提案してください。

Basic Memory に何かを保存する前に、私に確認してください。

1. 1つ保存する

スターターメモだけがあるプロジェクトで、または最初のセッションの早い段階で行います。ユーザーが取り組んでいる内容を話すまで待ちます。「2+2は？」のようなささいなチャットは省略し、健康、お金、他人のプライベートな詳細など、明らかに個人的または機微な内容も、保存を求められない限り省略します。

すでに存在するメモを重複させないよう、まず検索します（bm_search）。次に、短いメモを1つ書きます。

• Q3 pricing plan のような、わかりやすいタイトル；
• 取り組みの内容と現在の状況を述べた2〜3文；
• ## Observations の下に、[category] 形式の事実を2〜3件。

会話の書き起こしではありません。チャットの要約でもありません。

bm_write(
    project="<project>",
    title="Q3 pricing plan",
    directory="notes",
    overwrite=False,
    content="""Planning new pricing for the Q3 launch. Two tiers are on the table.
The team wants a decision before the July board meeting.

## Observations
- [goal] Pick between flat and usage-based pricing for Q3
- [deadline] Decision needed before the July board meeting
- [open_question] Whether the free tier stays""",
)

次に、ツールの結果に含まれるリンク、取り消し方法、保存をオプトアウトする方法とあわせて、何を保存したかを1行で伝えます。

「Q3 pricing plan」を Basic Memory に保存しました。削除するには「取り消して」と言ってください。保存前に確認してほしい場合は「先に確認して」と言ってください。

ツールが返したリンクだけを使ってください。URLを自分で作成してはいけません。

2. 内容を確認する

メモを表示するか尋ねます。保存時に返されたリンクを提示します。ホストで Basic Memory アプリを利用できる場合（bm_open が使用可能な場合）は、アプリで開くか尋ねます。

bm_open(view="note", identifier="Q3 pricing plan", project="<project>")

3. 新しいチャットで呼び出す

新しいチャットでメモを使う方法をユーザーに伝えます。

新しいチャットで、「Q3 pricing について何を保存しましたか？」と聞いてください。

ユーザーの指示やメッセージで促されない限り、新しいチャットの開始時にメモリを確認することはできません。そのため、アシスタントのカスタム指示またはプロジェクト指示に貼り付けられる1行を提案します。

Basic Memory を使って、私の仕事に関するメモを検索し、保存してください。

このホストで設定場所がわかる場合は伝えます。チャットアプリならプロジェクト指示またはカスタム指示、コーディングツールならエージェントのコンテキストファイルです。わからない場合は、この1行を示して「アシスタントのカスタム指示に貼り付けてください」と伝えます。ユーザーが希望しないなら、今すぐ設定するよう求めないでください。

4. 追記する

後で同じ話題が出たときは、新しいメモを作るのではなく、そのメモを更新します。検索して内容を読み、bm_edit を使って新しい事実を追記するか、古くなった内容を変更します。変更内容を1行で伝えます。

取り消し

保存後にユーザーが「取り消して」と言った場合は、直前に書いたメモを削除し、1行で確認します。

bm_delete(project="<project>", identifier="<path from the save result>")

既存のメモを更新して保存していた場合は、削除しないでください。元の状態に戻るよう編集し、その旨を伝えます。

次のステップ

最初のセッションでは、完全なセットアップを提案しないでください。メモがいくつかできて、ユーザーがそれらを再び利用した後で、メモの種類やフォルダーを含む、より充実したシステムを設計するために memory-onboarding を提案します。