mcpField
A
agentdb-query

agentdb-query

github.com/ruvnetエージェントワークフロー80.0k745 回インストール今日更新
リポジトリ

agentdb-query について

agentdb-queryは、コントローラーブリッジ経由でAgentDBを操作するスキルです。エージェントセッションをまたいだ知識の保存、取得、検索に使い、階層型メモリやパターン検索、コンテキスト合成、因果グラフを扱います。

主な機能

  1. 01階層型ストレージと想起
  2. 02パターンの保存と検索
  3. 03セマンティックルーティングとコンテキスト合成
  4. 04因果グラフの作成とクエリ
  5. 05セッションライフサイクル管理
  6. 06一括操作とフィードバック

活用シーン

  1. 01エージェントセッション間で知識を保存・取得
  2. 02学習済みパターンの検索
  3. 03複数の記憶を統合してコンテキストを作成
  4. 04ヘルスチェックとセッション管理

MCP 対応

コントローラーブリッジを通じて、AgentDBの20個のMCPツールを呼び出します。ヘルスチェック、メモリ操作、グラフ検索、セッション管理に対応します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ruvnet/ruflo --skill agentdb-query

インストール後、Claude Code で/agentdb-queryを入力して読み込まれたか確認します。

詳細

AgentDB クエリ

コントローラーブリッジを通じて AgentDB にクエリを実行し、管理します。AgentDB は 20 個の agentdb_* MCP ツールを公開しており、このスキルでは標準的な使用手順を説明します。

使用する場面

エージェントのセッション間でナレッジを保存、取得、検索する必要がある場合に使用します。AgentDB は階層型ストレージ、因果ナレッジグラフ、セマンティックルーティング、コンテキスト統合を提供します。

手順

  1. ヘルスチェック — mcp__plugin_ruflo-core_ruflo__agentdb_health。available: true であることを確認します。
  2. セッションを開始 — まだアクティブでない場合は、mcp__plugin_ruflo-core_ruflo__agentdb_session-start を実行します。
  3. ナレッジを保存 — 構造化された階層キー付きデータには、mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store を使用します（階層：working|episodic|semantic）。
  4. ナレッジを想起 — クエリを指定して mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-recall を実行します。
  5. パターンを検索 — 学習済みパターンには、mcp__plugin_ruflo-core_ruflo__agentdb_pattern-search を使用します（ReasoningBank 経由）。
  6. コンテキストを統合 — 複数のメモリを組み合わせるには、mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize を実行します。
  7. 因果グラフを構築 — 関連するナレッジをリンクするには、mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge を実行します。

利用可能なコントローラーグループ

mcp__plugin_ruflo-core_ruflo__agentdb_controllers を呼び出して、実行時レジストリを一覧表示します。20 個の MCP ツールから利用できる機能カテゴリは次のとおりです。

  • 階層型 — agentdb_hierarchical-store、_recall（階層経由）
  • パターン — agentdb_pattern-store、_search（ReasoningBank 経由）
  • セマンティック — agentdb_semantic-route、_context-synthesize
  • 因果 — agentdb_causal-edge（グラフノードバックエンドとブリッジフォールバック）
  • ライフサイクル — agentdb_health、_controllers、_session-start、_session-end
  • 一括処理 — agentdb_batch（最大 500 件）、_consolidate
  • 品質 — agentdb_feedback
  • グラフの読み取り — agentdb_graph-query（entity:xyz のようなドメイン接頭辞付きノード ID からの k ホップ／セマンティック／pagerank。SQL の k ホップは最大 3 ホップに制限されるため、appliedDepth と truncated を確認してください）および agentdb_graph-pathfinder
  • 削除（破壊的操作） — agentdb_hierarchical-delete、agentdb_causal-edge-delete、agentdb_causal-node-delete。呼び出す前に、ユーザーに正確な ID を確認してください。このプラグインでは元に戻せません。

重要：名前空間の扱い

名前空間文字列が適用されるのは memory_* と embeddings_search のみです。agentdb_hierarchical-*、agentdb_pattern-*、agentdb_causal-edge ツールは、名前空間ではなく階層またはコントローラーによってルーティングされます。これらのツールに namespace: 'foo' を渡さないでください。無視されます。プラグインの README にある「Namespace convention」を参照してください。

運用上のフォールバック（これらの場合分けに応じて処理してください）

  • controller: 'memory-store-fallback' — パターンは memory_store --namespace pattern 経由で永続化されています。失敗ではありません。
  • _graphNodeBackend: true — 因果エッジは @ruvector/graph-node によって処理されています。
  • success: false, error: '...Use memory_store/memory_search instead.' — ブリッジを利用できません。README の置換表に従って memory_* ツールに切り替えてください。

CLI の代替手段

npx @claude-flow/cli@latest memory search --query "your query" --namespace patterns
npx @claude-flow/cli@latest memory store --key "key" --value "value" --namespace patterns
npx @claude-flow/cli@latest memory list --namespace patterns

コメント

Markdown 対応