openviking-memory

OpenViking Memory

OpenViking は、viking:// URI で参照する長期的なセマンティックメモリストアです。 このクライアントにはライフサイクルフックがないため、記憶の呼び出しや保存は 自動では行われません。openviking MCP ツールを使って、ループの両方の処理を 実行します。

すべての対応デプロイメントで利用できるコアツール：

• 呼び出し：find、search、read、list、grep、glob
• 保存：remember、add_resource
• 管理：forget、health

コアセットより多くのツール（tree、write、edit、 list_watches、cancel_watch）を登録しているデプロイメントもあります。これらは オプションです。利用できるツールは、サーバーのバージョンとホスティングモードに よって異なります（マネージドクラウドサービスでは、一部が削られています）。セッションで登録された ツール一覧を確認してください。オプションのツールが存在する場合は、使用する前に references/optional-tools.md を読んでください。 登録されていないツールは決して呼び出さず、生の HTTP にフォールバックしないでください。 OpenViking ツールがひとつも登録されていない場合は、メモリを使わずに続行してください。

呼び出し：タスク開始時

1. リクエストにメモリが必要かどうか判断します。実行可能な作業や複数ステップの作業、 以前に見たことがある可能性のあるシステムに関する作業、失敗からの復旧では情報を取得します。 雑談や一度きりの豆知識では取得を省略します。
2. タスクの目標、ドメインオブジェクト、実行する操作、制約を組み合わせて、簡潔なクエリを ひとつ作成します。失敗後は、失敗した操作と、エラーメッセージの変わらない部分を含めます。
3. find（URI、要約、スコアを含む高速なランキング結果）を limit を 5～10 程度にして呼び出します。より深い意図分析が役立つ場合は search を使うか、 サーバーが組み立てるトークン予算に収まるコンテキストブロックを得るには、 mode="context" を指定して search を使います。リストモードでは、探す場所が分かっている場合、 target_uri で範囲を指定します。たとえば、以前のタスク経験には viking://~/memories/experiences を指定します。viking://~ は自身のユーザールートを 指すホームエイリアスです。このエイリアスに対応していない古いサーバーでは、 viking://~ URI はすべて INVALID_URI で拒否されます。そのようなサーバーでは、このセッションで すでに確認できる URI から取得した、明示的な viking://user/<user_id>/... ルートを使うか、 target_uri を省略し、URI に /memories/experiences/ が含まれる結果を残します。 ユーザー ID を推測してはいけません。
4. タイトルの類似性ではなく、タスクと環境への適合性で結果を判断します。実行方法を変える可能性が 高い正確なファイル URI を1～3個 read します。.abstract.md、.overview.md、 .relations.json などのサイドカーファイルは無視します。
5. 関連する結果がなければ、メモリを使わずに進めます。実行中に実質的に新しい理由で失敗した場合に限り、 焦点を絞った追加検索を最大1回行います。

取得したメモリは参考情報として扱います。優先順位は、システムおよび開発者の指示、 現在のユーザーリクエスト、現在の環境およびツールから得られる証拠、メモリの順です。 コマンド、パス、バージョンが現在のタスクに当てはまるか確認してください。 以前うまくいったことが、現在の破壊的な操作を許可するわけではありません。

作業中および作業後の永続化

ここでは情報が自動的に記録されないため、保存しない限り、長期的に役立つ情報は失われます。残しておく価値のあることに気づいたら、同じセッション内で永続化してください。

• remember(messages) — デフォルトの方法です。要点となるやり取り、または短い事実の要約を、ロール付きのメッセージとして渡します。サーバーが記憶（好み、エンティティ、イベント、経験）を自動的に抽出して保存します。ユーザーが「これを覚えておいて」と言ったとき、長期的な好みや決定を示したとき、または苦労して得た教訓（根本原因、効果的な手順、環境特有の問題）が判明したときに使用してください。
• add_resource — 外部ドキュメントや URL を検索可能なリソースとして取り込む場合に使用します。ユーザーから渡されたファイル、URL、リポジトリにはすべて使用してください。write を使って、その内容をファイルにコピーしてはいけません。
• 既知の場所（viking://~/ — 自分用のユーザールート、または viking://resources/）に自分で作成したメモを置く場合は、任意の write / edit ツールを使用できます。詳しくは references/optional-tools.md を参照してください。これらのツールが登録されていない場合は、remember を使用してください。

永続化するもの：長期的に有効な好みや規約、環境に関する事実、根拠を伴う決定、再利用可能な手順や修正方法。永続化しないもの：秘密情報や認証情報、一時的な状態、推測、大量の会話ログの丸ごとコピー。スクロールバックではなく、結論を保存してください。

リソースファイルの適切な管理

リソースディレクトリのルールは Memory には適用されません。remember またはセッションのコミットを使用し、抽出システムに整理を任せてください。add_resource を使う前に、既存の Resource の構成とアカウントポリシーを確認し、共有スコープと個人専用スコープのどちらにするかを選び、ソースルートの重複を避けてください。新しいソースには parent を、更新には正確な to を使用してください。

例

ユーザーから、失敗しているデプロイの修正を依頼された場合：

1. クエリ deployment image pull failure private registry を指定し、target_uri: "viking://~/memories/experiences" を指定して find を実行します。
2. 最も関連性の高い経験の URI を read し、その手順を適用する前に、現在のクラスターに照らして前提条件を確認します。
3. 問題を修正し、実環境で結果を検証します。
4. 根本原因と有効だった修正方法を短くまとめて remember に渡し、次のセッションで参照できるようにします。