Diversity: Maximal Marginal Relevance
Maximal Marginal Relevance (MMR) picks results one at a time, preferring candidates that match the query and differ from what it has already picked. In Qdrant it is a parameter on a nearest neighbors query, and diversity sets how much relevance it trades for variety.
The trap is candidates_limit. It defaults to the query’s limit, which leaves MMR nothing spare to choose from, so all it can do is reorder the results it was already given. This is the most common reason MMR looks like it did nothing.

- Maximal Marginal Relevance: both parameters, and the scores an MMR query returns.
- The Use of MMR, Diversity-Based Reranking for Reordering Documents and Producing Summaries: the 1998 paper the
diversityparameter implements.