AIエージェントの「脳」をファイル管理するように構築！コンテキストデータベースの新発想 — OpenViking

アーキテクチャ・仕組み

• ファイルシステムパラダイム: すべてのコンテキスト（記憶・資料・スキル）を viking:// プロトコルの仮想ファイルシステムとして管理。ls、find、grep、tree などの標準的なコマンド操作でコンテキストを操作可能
• 3階層コンテキスト構造:
  • L0（Abstract）: 約100トークンの1文要約。素早い関連性チェック用
  • L1（Overview）: 約2,000トークンの概要。構造と要点の把握用
  • L2（Details）: 完全な原文データ。必要時のみロード
• ディレクトリ再帰検索: 意図分析 → ベクトル検索で高スコアディレクトリ特定 → ディレクトリ内で二次検索 → サブディレクトリへ再帰的にドリルダウン → 結果集約
• 検索軌跡の可視化: ディレクトリ探索・ファイル特定の軌跡を完全記録し、問題の原因特定と検索ロジック最適化を支援
• 自動セッション管理: セッション終了時に会話内容を自動分析し、ユーザーの好みやエージェントの経験をメモリディレクトリに自動更新

対応環境

対応モデルプロバイダー

VLM（視覚言語モデル）

• Volcengine（Doubao）: doubao-seed-2-0-pro 等
• OpenAI: gpt-4o, gpt-4-vision-preview 等
• LiteLLM経由: Anthropic（Claude）、DeepSeek、Gemini、Qwen（DashScope）、OpenRouter、vLLM、Ollama など多数

Embedding モデル

• Volcengine: doubao-embedding-vision-250615
• OpenAI: text-embedding-3-large
• Jina: Jina Embeddings

パフォーマンス・ベンチマーク（LoCoMo10データセット、1,540ケース）

OpenViking統合により、タスク完了率は最大49%向上、入力トークンコストは最大96%削減。

主要コンポーネント

• openviking-server: HTTPサーバーとして永続的に稼働するコンテキストデータベース本体
• ov CLI: Rust製のコマンドラインツール。ov status、ov add-resource、ov ls、ov find、ov grep、ov tree 等のコマンドを提供
• VikingBot: OpenViking上に構築されたAIエージェントフレームワーク。ov chat でインタラクティブチャットが可能

コンテキストの3分類

• Resources（資料）: プロジェクトドキュメント、リポジトリ、Webページなど
• User（ユーザー）: 個人の好み、習慣、対話履歴
• Agent（エージェント）: スキル、指示、タスク記憶

設定オプション

• ストレージのワークスペースパス指定
• ログレベル（INFO等）と出力先（stdout / file）
• Embeddingの並列数（デフォルト10）
• VLMの並列数（デフォルト100）
• ベクトル次元数の指定

ライセンス

Apache License 2.0（商用利用可能）

Pythonパッケージのインストール

pip install openviking --upgrade --force-reinstall

Rust CLI（オプション）

curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash

設定ファイルの作成

~/.openviking/ov.conf に設定ファイルを作成し、VLMとEmbeddingモデルのAPI情報を記述します。

サーバー起動

openviking-server

動作確認

ov status
ov add-resource https://github.com/volcengine/OpenViking
ov ls viking://resources/
ov find "what is openviking"

VikingBot（AIチャット機能）

pip install "openviking[bot]"
openviking-server --with-bot
ov chat