v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Retriever Learned Fusion

Get Stats

Get aggregate statistics for a retriever's learned fusion system.

get/v1/retrievers/{retriever_id}/learned-fusion/stats

Path parameters

retriever_idstring required

Response

Successful Response

total_learnersinteger required

Total number of unique users with learned weights.

active_learnersinteger

Unique users the system is actively learning for (alias of total_learners — backs the Studio Overview 'Active Learners' card).

avg_interactions_per_usernumber required

Average number of interactions per user.

weight_spreadnumber required

Maximum divergence of any feature weight from uniform.

context_level_distributionobject required

Count of users at each context level (personal/demographic/global).

context_hit_ratenumber

Fraction of learners that have reached a personalized (non-global) context — enough interactions for personal weights (0-1).

enabledboolean required

Whether learned fusion is currently enabled for this retriever.

rollout_pctnumber required

Effective percentage of traffic receiving learned fusion weights (a live override takes precedence over the configured value).

rollout_overrideboolean

Whether a live rollout override is active (vs the config value).

config_rollout_pctnumber

The retriever's configured rollout_pct (ignoring any live override).

shadow_modeboolean required

Whether learned fusion is running in shadow mode (logging only).

warningstring nullable

Set when the response contains fallback defaults due to an internal error.

hintstring nullable

Set when learned fusion is NOT configured for this retriever — the payload is a well-formed empty state and this explains how to enable learning (BACKE-2525).