adding-memory

OpenViking (OV) add-memory

ov add-memory コマンドは、長期的に保持するメモリーを追加します。テキストや構造化された会話を、OpenViking のコンテキストデータベースで検索・取得できるメモリーに変換します。

使用するタイミング

• セッションをまたいで覚えておく価値のあることを学んだ後
• 会話から得た洞察、決定事項、発見を保持するとき
• やり取りからナレッジベースを構築するとき
• エージェントが将来の取得に備えてコンテキストを保存するとき

入力モード

プレーンテキストと複数ターンモードのどちらを使うか、適切に選択してください。複数ターンモードでは、より複雑な洞察を含めることができ、メモリーの抽出は OpenViking に任せられます。

モード 1：圧縮メモリー用のプレーンテキスト

単純な文字列が user メッセージとして保存されます：

ov add-memory "User's name is Bob, he participate in Global Hackathon in 2025-01-08, and won Champion."

モード 2：より豊かなコンテキスト用の複数ターン会話

完全なやり取りを保存するための、{role, content} オブジェクトの JSON 配列です：

ov add-memory '[
  {"role": "user", "content": "I love traveling. Give me some options of Transport from Beijing to Shanghai."},
  {"role": "assistant", "content": "You can use train, bus, or plane. Train is the fastest, but you need to book in advance. Bus is cheaper, but you need to wait. Plane is the most expensive, but you can get there any time of day."},
  {"role": "user", "content": "I prefer train. I like sightseeing on the train. Can you give me the train schedule?"},
  < ... more possible conversation about schedule and tickest need to be memorized ... >
]'

出力

抽出されたメモリーの件数を返します：

memories_extracted   1

エージェントのベストプラクティス

良いメモリーの書き方

1. 具体的にする — 曖昧な要約ではなく、具体的な詳細を含めます
2. コンテキストを含める — なぜ重要なのか、どのような場合に当てはまるのかを示します
3. 構造化された形式を使う — 何が起きたかと、なぜ起きたかを分けます

関連する事実をまとめる

関連するメモリーは、小分けにして何度も呼び出すのではなく、1 回の呼び出しにまとめます：

ov add-memory '[
  {"role": "user", "content": "Key facts about the ov_cli Rust crate"},
  {"role": "assistant", "content": "1. runs faster than python cli\n2. uses HttpClient to connect openviking server\n3. Output formatting supports table and JSON modes\n4. Config lives at ~/.openviking/ovcli.conf"}
]'

前提条件

• CLI が設定済みであること：~/.openviking/ovcli.conf