エージェントにメモリーを持たせる

チュートリアル · 読了時間5分

エージェントメモリーは、あなたのSkilnuアカウントに結び付けられた短く私的なメモだ——好み、制約、わざわざ説明し直す価値のない事実。接続するどのMCPクライアントでも保存でき、後で接続するどのMCPクライアントでも見つけ直せる。これは記録でもスキルでもない——何かが明示的に保存しない限り何も記憶されず、ここで保存したものはバージョン管理も、合成も、公開もされない。これはPro/Team向けの機能だ。無料アカウントは静かに失敗するのではなく、明確なアップグレードエラーを受け取る。

1. 覚えておく価値のあることを保存する

アプリでアカウントメニューを開き、Memoriesをクリックする。どのエージェントにもすでに知っていてほしいことを書く——「デプロイはmainブランチでGitHub Actions経由で行い、手動では絶対に行わない」は有用だ。「火曜日にCIについて長い会話をした」はそうではない——行動につながる何もないからだ。後でトピックごとに見つけたい場合はカンマ区切りのタグを追加し、それから保存する。

内容は4,000文字に制限されている——これはメモであり、文書ではない。保存しようとしている内容がそれより長い場合、それはおそらくメモリーではなくスキルだ。代わりに公開すれば、静かに切り捨てられる代わりにバージョン管理され、共有できるようになる。

2. もう一度見つける

検索は可能な限りセマンティックにランク付けする——「この人はどんなレビューが好きか」と検索すると、「変数名について細かく指摘しないでください」と言い換えて保存したメモリーが見つかることがある。二つの文がほとんど単語を共有していなくても、意味が同じだからだ。セマンティックな一致がしきい値に達しない場合は、内容とタグに対する単純なキーワード一致にフォールバックするので、embeddingのステップが実行されなかったという理由だけで検索結果が空になることはない。

検索ボックスを空にしておくと、すべてを新しい順に閲覧できる。

3. 間違っていたり古くなったりしたら削除する

どのメモリーでも「削除」をクリックして確認する。元に戻すことはできない——このプラットフォームの他の削除と同じだ。間違ってしまったメモリー（もう持っていない好み、もう真実ではなくなった事実）は、後でエージェントがそれを信頼してしまう前に削除する価値がある。

エージェントから行う方法

同じ4つの操作は4つのMCPツールであり、エージェントは会話の途中でメモリーを保存・取得でき、あなたがアプリを開く必要すらない：

save_memory(content="Deploys happen via GitHub Actions on main.", tags=["ci", "deploy"])
  -> { memory_id, content, tags, created_at }

search_memories(query="how are deploys triggered")
  -> { items: [...], total, limit, offset }

list_memories(limit=20)
  -> { items: [...], total, limit, offset }

forget_memory(memory_id="...")
  -> { deleted: true, memory_id }

4つすべてはオプションの publisher_id を受け取る。これは接続が複数のpublisherに結び付いている場合にのみ必要で、ほとんどの接続はそうではないので、ほとんどの呼び出し元はこれを省略できる。

何かを保存する価値があるかどうかの判断は、エージェントがうまく行うべきものだ。あなたがウェブフォームに入力するときに自分で行っている判断と同じように。何でも通り過ぎる発言のたびに save_memory を呼び出すツールは、何でも貼り付けるメモファイルと同じ、役に立たない山を作ってしまう。

費用について

メモリーの保存、一覧表示、検索、削除には、Pro/Teamのサブスクリプション自体を超える費用はかからない——スキルのコンパイルにあるような呼び出しごとのクォータはない。唯一の制限はアカウントあたり2,000件というメモリーの上限であり、それを超えると save_memory は最も古いエントリを静かに削除する代わりに、その上限を明示するエラーを返す。

何を保存すべきか、何を保存すべきでないか

良いメモリーは次回のための指示のように読める——安定した好み、固定された制約、セッションをまたいでも変わらない事実。良くないメモリーはこのセッションについての日記のように読める——何をすべきかの指針ではなく、何が起きたかの要約だ。初日の新しい同僚に繰り返したくないようなことなら、おそらくここに保存する価値もない。