本文へ移動
cccskills
無料GitHub で公開

agentdb-explainable-recall

Search with feature attributions — return WHY each match scored where it did. Use when debugging recall quality, auditing for bias, or explaining results to a user.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md1.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Explainable Recall

Standard search returns scores; explainable recall returns features — which dimensions of the embedding (or which keywords in hybrid search) drove the match.

When to use

  • Recall quality is off and you need to debug why
  • Auditing for bias / fairness
  • User asks "why this result?" — show the receipts
  • Building UIs that surface match rationale

API

agentdb_explainable_recall(
  query:        <embedding | string>
  k:            5
  features:     'embedding-dims' | 'bm25-tokens' | 'hybrid-both' | 'metadata'
)

Returns: [
  {
    id, score,
    explanation: {
      topDims?:       [{ dim: 12, contribution: 0.18 }, ...],
      topTokens?:     [{ token: "jwt", contribution: 0.31 }, ...],
      metadataMatch?: { topic: 'auth', project: 'api' }
    }
  },
  ...
]

Use cases

UseFeatures setting
Debug an unexpected high-scoreembedding-dims — see which dims spiked
Verify keyword fall-back worksbm25-tokens — see if exact terms were the driver
Confirm metadata filters firedmetadata — see which filter values matched
Build user-facing UIhybrid-both — show both text-level + dim-level signals

Don't

  • Don't pipe the full feature vector to the user — it's noisy. Pick top 3-5 contributing dims/tokens.
  • Don't use explainable recall for normal searches. The feature extraction adds 20-50ms per query.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Master advanced AgentDB features including QUIC synchronization, multi-database management, custom distance metrics, hybrid search, and distributed systems integration. Use when building distributed AI systems, multi-agent coordination, or advanced vector search applications.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

Create and train AI learning plugins with AgentDB's 9 reinforcement learning algorithms. Includes Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more. Use when building self-learning agents, implementing RL, or optimizing agent behavior through experience.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

Implement persistent memory patterns for AI agents using AgentDB. Includes session memory, long-term storage, pattern learning, and context management. Use when building stateful agents, chat systems, or intelligent assistants.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

Optimize AgentDB performance with quantization (4-32x memory reduction), HNSW indexing (150x faster search), caching, and batch operations. Use when optimizing memory usage, improving search speed, or scaling to millions of vectors.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

Implement semantic vector search with AgentDB for intelligent document retrieval, similarity matching, and context-aware querying. Use when building RAG systems, semantic search engines, or intelligent knowledge bases.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

Walk the causal graph in AgentDB to explain why two memories are connected, or trace a root cause. Use when the user asks "why did X happen", "what led to Y", or after an incident.

日本語の概要は準備中です。原文の説明を表示しています。

ruvnet/agentdb912026年10月10日 更新

ruvnet のスキルをすべて見る

このスキルの問題を報告する