qdrant-haystack 11.0.0__tar.gz → 11.1.0__tar.gz

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [integrations/qdrant-v11.0.0] - 2026-09-25
+
+### 🚜 Refactor
+
+- [**breaking**] Qdrant - propagate errors on backend failures instead of empty responses (#3997)
+
+### ⚙️ CI
+
+- Improve changelog generation; fix existing changelogs (#3883)
+
+
 ## [integrations/qdrant-v10.6.0] - 2026-09-01
 
 ### 🐛 Bug Fixes

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qdrant-haystack
-Version: 11.0.0
+Version: 11.1.0
 Summary: An integration of Qdrant ANN vector database backend with Haystack
 Project-URL: Source, https://github.com/deepset-ai/haystack-core-integrations
 Project-URL: Documentation, https://github.com/deepset-ai/haystack-core-integrations/blob/main/integrations/qdrant/README.md

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/src/haystack_integrations/components/retrievers/qdrant/retriever.py

@@ -188,9 +188,9 @@ class QdrantEmbeddingRetriever:
             query_embedding=query_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -243,9 +243,9 @@ class QdrantEmbeddingRetriever:
             query_embedding=query_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -433,9 +433,9 @@ class QdrantSparseEmbeddingRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -493,9 +493,9 @@ class QdrantSparseEmbeddingRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -560,9 +560,10 @@ class QdrantHybridRetriever:
         :param return_embedding: Whether to return the embeddings of the retrieved Documents.
         :param filter_policy: Policy to determine how filters are applied.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -659,7 +660,7 @@ class QdrantHybridRetriever:
         rrf_weights: list[float] | None = None,
     ) -> dict[str, list[Document]]:
         """
-        Run the Sparse Embedding Retriever on the given input data.
+        Run the Hybrid Retriever on the given input data.
 
         :param query_embedding: Dense embedding of the query.
         :param query_sparse_embedding: Sparse embedding of the query.
@@ -670,9 +671,10 @@ class QdrantHybridRetriever:
              groups to return.
         :param return_embedding: Whether to return the embedding of the retrieved Documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -704,8 +706,8 @@ class QdrantHybridRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
             rrf_k=rrf_k if rrf_k is not None else self._rrf_k,
@@ -729,7 +731,7 @@ class QdrantHybridRetriever:
         rrf_weights: list[float] | None = None,
     ) -> dict[str, list[Document]]:
         """
-        Asynchronously run the Sparse Embedding Retriever on the given input data.
+        Asynchronously run the Hybrid Retriever on the given input data.
 
         :param query_embedding: Dense embedding of the query.
         :param query_sparse_embedding: Sparse embedding of the query.
@@ -740,9 +742,10 @@ class QdrantHybridRetriever:
              groups to return.
         :param return_embedding: Whether to return the embedding of the retrieved Documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -774,8 +777,8 @@ class QdrantHybridRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
             rrf_k=rrf_k if rrf_k is not None else self._rrf_k,

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/src/haystack_integrations/document_stores/qdrant/document_store.py

@@ -1757,9 +1757,10 @@ class QdrantDocumentStore:
              groups to return.
         :param return_embedding: Whether to return the embeddings of the retrieved documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -2020,9 +2021,10 @@ class QdrantDocumentStore:
              groups to return.
         :param return_embedding: Whether to return the embeddings of the retrieved documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/tests/test_embedding_retriever.py

@@ -200,6 +200,37 @@ class TestQdrantRetriever:
         mock_store._query_by_embedding_async.assert_awaited_once()
         assert res["documents"][0].content == "doc"
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_embedding.return_value = []
+
+        retriever = QdrantEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        retriever.run(query_embedding=[0.5, 0.7], scale_score=False, return_embedding=False, score_threshold=0.0)
+
+        call_kwargs = mock_store._query_by_embedding.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_embedding_async = AsyncMock(return_value=[])
+
+        retriever = QdrantEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        await retriever.run_async(
+            query_embedding=[0.5, 0.7], scale_score=False, return_embedding=False, score_threshold=0.0
+        )
+
+        call_kwargs = mock_store._query_by_embedding_async.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
     def test_run_raises_when_merge_with_native_init_filter(self):
         document_store = QdrantDocumentStore(location=":memory:", index="test")
         retriever = QdrantEmbeddingRetriever(

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/tests/test_hybrid_retriever.py

@@ -229,6 +229,39 @@ class TestQdrantHybridRetriever:
         assert call_args[1]["rrf_k"] == 100
         assert call_args[1]["rrf_weights"] == [3.0, 1.0]
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_hybrid.return_value = []
+
+        retriever = QdrantHybridRetriever(document_store=mock_store, return_embedding=True, score_threshold=0.5)
+        retriever.run(
+            query_embedding=[0.5, 0.7],
+            query_sparse_embedding=SparseEmbedding(indices=[0, 5], values=[0.1, 0.7]),
+            return_embedding=False,
+            score_threshold=0.0,
+        )
+
+        call_args = mock_store._query_hybrid.call_args
+        assert call_args[1]["return_embedding"] is False
+        assert call_args[1]["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_hybrid_async = AsyncMock(return_value=[])
+
+        retriever = QdrantHybridRetriever(document_store=mock_store, return_embedding=True, score_threshold=0.5)
+        await retriever.run_async(
+            query_embedding=[0.5, 0.7],
+            query_sparse_embedding=SparseEmbedding(indices=[0, 5], values=[0.1, 0.7]),
+            return_embedding=False,
+            score_threshold=0.0,
+        )
+
+        call_args = mock_store._query_hybrid_async.call_args
+        assert call_args[1]["return_embedding"] is False
+        assert call_args[1]["score_threshold"] == 0.0
+
     def test_run_with_group_by(self):
         mock_store = Mock(spec=QdrantDocumentStore)
         sparse_embedding = SparseEmbedding(indices=[0, 1, 2, 3], values=[0.1, 0.8, 0.05, 0.33])

{qdrant_haystack-11.0.0 → qdrant_haystack-11.1.0}/tests/test_sparse_embedding_retriever.py

@@ -199,6 +199,39 @@ class TestQdrantSparseEmbeddingRetriever:
         mock_store._query_by_sparse_async.assert_awaited_once()
         assert res["documents"][0].content == "doc"
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_sparse.return_value = []
+        sparse = SparseEmbedding(indices=[0, 5], values=[0.1, 0.7])
+
+        retriever = QdrantSparseEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        retriever.run(query_sparse_embedding=sparse, scale_score=False, return_embedding=False, score_threshold=0.0)
+
+        call_kwargs = mock_store._query_by_sparse.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_sparse_async = AsyncMock(return_value=[])
+        sparse = SparseEmbedding(indices=[0, 5], values=[0.1, 0.7])
+
+        retriever = QdrantSparseEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        await retriever.run_async(
+            query_sparse_embedding=sparse, scale_score=False, return_embedding=False, score_threshold=0.0
+        )
+
+        call_kwargs = mock_store._query_by_sparse_async.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
     def test_run_raises_when_merge_with_native_filter(self):
         document_store = QdrantDocumentStore(location=":memory:", index="test")
         retriever = QdrantSparseEmbeddingRetriever(