Get Retriever Signals
Retrievers
Get Retriever Signals
Get retriever signals for interaction tuning.
Retrieves fine-grained signals about retriever behavior:
- Cache hits/misses
- Reranking scores
- Filter effectiveness
- Query expansion results
Signal Types:
cache_hit: Successful cache lookupscache_miss: Cache misses requiring full searchrerank_scores: Reranking effectiveness metricsfilter_reduction: Pre-filter document reductionexpansion_results: Query expansion impact
Use Cases:
- Fine-tune retrieval parameters
- Analyze query patterns
- Optimize cache strategies
- Validate optimization improvements
Example:
curl -X GET "https://api.mixpeek.com/v1/analytics/retrievers/ret_abc123/signals?signal_type=rerank_scores&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Namespace: your-namespace"
GET
Get Retriever Signals
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Filter by signal type (cache_hit, rerank_scores, etc.)
Maximum results
Required range:
x <= 1000Hours of history
Required range:
1 <= x <= 720Response
Successful Response

