Commit Graph
2446 Commits
Author SHA1 Message Date
Dylan Couzon def2b3a39b improve clarity FormulaQuery syntax 2026-05-11 20:51:07 -04:00
Dylan CouzonandClaude Opus 4.7 3de7b1ddfb tighten intro, dataset, and wrap-up; add notebook pointer before setup
Tightens awkward and stale phrasing across the intro and Dataset
section (per a full review pass), repositions FormulaQuery in Wrapping
Up as an alternative rather than part of the default pipeline, drops
the redundant 'document-side equivalent' closing line, and adds a
one-line pointer to the notebook right before the Setup section so
readers can pivot to runnable code.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 20:23:42 -04:00
Dylan CouzonandClaude Opus 4.7 b30140820f tighten retrieval section and remove vector-description duplication
Adds dense_abstract as a fourth prefetch in retrieve() since we
ingest it already. Removes the unactionable dense_abstract hedge
paragraph, the When to Group section (the prefetch-limit gotcha
folds into a code comment), the duplicate schema-section vector
bullets, and the awkward transition sentence between the code and
the design subsections. Replaces 'summary' with 'abstract as a
whole' in descriptions for consistency with the schema rename done
earlier.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:53:39 -04:00
Dylan CouzonandClaude Opus 4.7 479d305aca explain query_points_groups inline and remove pattern-doesnt-fit section
Adds a one-line comment above the query_points_groups call so readers
see what the function does without waiting for the When to Group
subsection (which now sits at the end of the design-decisions list).

Removes the entire 'Where This Pattern Doesn't Fit' section: the
short/homogeneous paragraph read as obvious (a reader who's deep into
this tutorial wouldn't try to multi-rep a tweet), and the
inconsistent-metadata paragraph was too vague to be actionable.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:08:37 -04:00
Dylan CouzonandClaude Opus 4.7 8ea4653ee8 move categories from BM25 input to filterable payload
Renames sparse_keywords to sparse_title (the vector now indexes only
the title text), adds a keyword index on the tags payload field, and
gives retrieve() an optional tags parameter that builds a query_filter
when set. Pre-filtering on the tags payload is faster and more precise
than mixing categories into BM25 lexical matching.

Updates the schema description bullets, the prefetch justification,
the intro failure-mode list, and the dataset framing to match the
new design. Drops avg_len from 15 to 10 to reflect title-only word
counts.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 18:44:37 -04:00
Dylan CouzonandClaude Opus 4.7 8abae12a8c consolidate chunking note and remove open ends section
Moves the standalone chunking-strategy sentence into the Dataset
paragraph that already explains why we chunk, and drops the dedicated
Open Ends section. The chunking-method link list (POMA-AI VST, Jina,
Chonkie) goes away with the section, and the BM25F note is also
removed since the workaround it describes is what the tutorial
already demonstrates. Cleans up two stale step-number references in
Wrapping Up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 18:18:51 -04:00
Dylan CouzonandClaude Opus 4.7 a9610d2a30 restructure fusion section to cover four named strategies
Renames "How to Fuse" to "Which Fusion to Use" and expands it to
cover RRF (default), Weighted RRF, DBSF, and custom formulas as four
named options, with the FormulaQuery code block moved in from what
was the boosting section. Softens RRF framing from "stick with RRF
unless..." to "reasonable starting point; variants often do better
once you have an eval set." Adds the distribution-alignment
explanation in the custom-formula paragraph and links the in-repo
Decay Functions and Score Boosting references along with the RRF vs
DBSF FAQ entry.

The "When to Boost, When to Rerank" section now only covers true
boosting (recency, authority, decay) and reranking, and is reordered
to sit immediately after fusion so the ranking decisions stay
together. The "When to Group, When Not To" section moves to the end
as a presentation concern.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 17:33:32 -04:00
Dylan CouzonandClaude Opus 4.7 68cec300f2 set avg_len for BM25 ingestion and trim parameter notes
Calibrates BM25 length normalization for the short title+categories
sparse field with a comment on why. Removes redundant k1/b/avg_len
prose from the tutorial Open Ends section and the cross-link paragraph
in text-search.md, since the BM25 Parameters subsection above already
documents calibration with a working example.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 16:06:03 -04:00
Dylan CouzonandClaude Opus 4.7 376202a113 remove lookup_from references, point to with_lookup for payload splits
The two lookup_from mentions were misleading: the feature is for
querying by ID across collections, not for splitting representation
storage. The line-107 paragraph now points readers to the documented
with_lookup pattern for the payload-split case and stays silent on
vector splits, which are a separate design problem (multiple queries
plus client-side fusion) that doesn't fit this tutorial's scope.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 15:24:08 -04:00
Dylan CouzonandClaude Opus 4.7 433cae62a5 rename dense_summary to dense_abstract and explain chunking choice
The arxiv data has abstracts, not summaries. Renaming the named
vector and prose throughout removes the ambiguity flagged on the PR.
Adds a short paragraph to the Dataset section explaining that
abstracts fit any embedding model's context window, so chunking is
included to mirror the pipeline shape you'd use on full bodies.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 15:03:52 -04:00
Dylan CouzonandClaude Opus 4.7 972568940d switch tutorial to qdrant cloud inference and core bm25
Drops FastEmbed in favor of server-side embedding via Cloud Inference
for dense vectors and core BM25 (in Qdrant since 1.15) for sparse.
Simplifies ingestion and query code; adds an aside covering the
self-host path. Also clears two em dashes from the tutorial prose.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 14:48:21 -04:00
Dylan CouzonandClaude Opus 4.7 300397b467 point hybrid search prerequisite at text search guide
Replaces the FastEmbed tutorial link with the hybrid search section
of the core Text Search guide, since FastEmbed is a satellite library.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 14:32:47 -04:00
Dylan CouzonandClaude Opus 4.7 a5e4ef0532 Fix FAQ link to point at the relevance tutorial directly
The FAQ linked to /documentation/tutorials-search-engineering/retrieval-quality/,
which only exists as a Hugo alias on the ANN recall tutorial. Aliases emit
HTML redirects but not Markdown ones, so the link checker hits the .md
output and 404s. The surrounding prose (golden query set, NDCG@10) is
relevance-tutorial territory anyway.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 12:08:02 -04:00
Dylan Couzon d21b5a5435 Merge pull request #2305 from qdrant/retrival-quality-guide-improvement
docs(tutorials): split retrieval-quality into three evaluation layers
2026-05-11 11:55:53 -04:00
Tim Visée c37393a17e Merge pull request #2298 from qdrant/version-1.18
Publish docs for version 1.18
2026-05-11 17:02:50 +02:00
Abdon Pijpelink cba308dc31 Fix tracing ID Python snippet import 2026-05-11 11:32:10 +02:00
Mohamed Arbi c3a3c1b0fd fix typos in hybrid-cloud and private cloud docs (#2343) 2026-05-11 08:46:00 +02:00
46e81449a8 Add TurboQuant quantization documentation (v1.18.0) (#2313)
* Add TurboQuant quantization documentation (v1.18.0)

Adds a new TurboQuant section to the quantization guide covering the
four encoding options (bits1/bits1_5/bits2/bits4), automatic asymmetric
quantization, distance metric support, and the automatic TQ+ precision
enhancement for sealed segments. Updates the comparison table and
method-selection guidance to recommend TurboQuant over Binary and
Scalar Quantization for new collections. Adds HTTP-only snippets for
basic setup and explicit bit-depth selection.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case for headers

* Restructure doc to lead with TurboQuant

* Clarify rescoring

* Edits

* Soften TQ advice

* Updates

* Fix

* Apply suggestions from code review

Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>

* Review feedback

* Add Go/Java/C# code snippets

* Add list of 4 quantization methods to introduction

* Review feedback

* Stronger advice for TQ4

* Add Python snippets

* Add Rust snippets

* Add TS snippets

* Update recommendation table

* Update production checklist

* Remove link to article

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>
2026-05-11 08:13:03 +02:00
Bastian Hofmann 0abdaee413 Hugo and dependency updates (#2310)
* Adds a run script to easily serve the page locally
* Updates the Hugo version
* Updates deprecated fields
* Add version checks in the run and build scripts
* Update JS dependencies to fix CVEs
2026-05-07 15:49:20 +02:00
Abdon Pijpelink 506639965d Add Rust snippets for adding/removing named vectors 2026-05-07 10:25:37 +02:00
Abdon Pijpelink cb585a1fce Add TS snippets for adding/removing named vectors 2026-05-07 09:46:50 +02:00
Abdon Pijpelink 483b384421 Add Python snippets 2026-05-07 09:36:00 +02:00
Dylan Couzon 66264ac07c Improve category filter and scale corpus to match notebook 2026-05-06 16:54:52 -04:00
Dylan CouzonandClaude Opus 4.7 bb877b23f7 add cross-links from search and vectors docs to multi-rep tutorial
- hybrid-queries: see-also link at end of grouping section
- vectors: clarify MaxSim returns one combined score and point to named vectors + tutorial
- text-search: BM25 short-field calibration note plus BM25F workaround pointer

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 19:10:24 -04:00
Dylan Couzon 120895c75d update notebook 2026-05-05 19:00:14 -04:00
Abdon PijpelinkandTim Visée 165aab26ad Update FAQ (#2322)
* Update FAQ

* Fix links

* One more link

* Apply suggestions from code review

Co-authored-by: Tim Visée <tim+github@visee.me>

---------

Co-authored-by: Tim Visée <tim+github@visee.me>
2026-05-05 16:25:34 +02:00
Dylan Couzon 67ebec2831 add sidebar + menu references 2026-05-05 09:57:35 -04:00
Dylan Couzon ce3223541f add tutorial 2026-05-05 09:57:25 -04:00
Anush 27b0dbabbb docs: Updated gemini.md for multiple inputs (#2330) 2026-05-05 11:29:49 +05:30
Abdon Pijpelink 46fc4f0350 Add Go/Java/C# snippets for named vector CRUD 2026-05-04 14:44:48 +02:00
Abdon Pijpelink 0fc11c07de Documentation for the Query Audit Logs API (#2232)
* Documentation for the Query Audit Logs API

* Add missing empty request body

* Review feedback
2026-05-04 13:33:57 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 506e326f43 Document per-collection metrics (v1.18.0) (#2288)
* Document per-collection API metrics (v1.18.0)

Add a footnote to rest_responses_total and grpc_responses_total in the
metrics table and a new "Per-Collection API Metrics" subsection explaining
the ?per_collection=true query parameter added in qdrant/qdrant#8214.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case

* Review feedback

* Edit

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-04 12:23:15 +02:00
Dylan Couzon 942f358f20 Soften Ragas Framing 2026-05-02 16:32:51 -04:00
Dylan Couzon 3b4346e3ae change embedding at query time 2026-05-02 14:37:04 -04:00
kanungle c9a0a672c1 Revert "added quote wrapping to meta description content"
This reverts commit 4ad8ced35e.
2026-05-01 09:28:30 -07:00
kanungle 4ad8ced35e added quote wrapping to meta description content 2026-05-01 09:21:28 -07:00
kanungle deb8b5533f initial commit; Claude generated SEO descriptions 2026-05-01 09:07:30 -07:00
Dylan CouzonandClaude Opus 4.7 9fbcd1adad Rename retrieval-quality slugs to match tutorial scope
Tutorial slugs now match their content:
- retrieval-quality/ -> ann-recall/ (alias preserves the old published path)
- retrieval-quality-golden-set/ -> retrieval-relevance/
- retrieval-quality-pipeline-output/ -> pipeline-output-quality/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 16:32:46 -04:00
ecd4887576 Document new strict_mode_config parameters (v1.18.0) (#2303)
* Document 7 missing strict_mode_config parameters

Adds documentation sections and code snippets (Python, TypeScript, Rust,
Go, Java, C#, HTTP, bash) for search_allow_exact, search_max_hnsw_ef,
search_max_oversampling, search_max_batchsize, max_resident_memory_percent,
multivector_config, and sparse_config.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Use title case for all headers

* Update qdrant-landing/content/documentation/ops-configuration/administration.md

Co-authored-by: Tim Visée <tim@visee.me>

* Mention default strict mode on Cloud; Clarify behavior of only setting enabled=true

* Apply suggestion from @timvisee

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Tim Visée <tim@visee.me>
2026-04-30 20:25:21 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 dc7d66545e Add Monitor Collection Memory Usage page (v1.18.0) (#2300)
* Add Monitor Collection Memory Usage page (v1.18.0)

New page in Monitoring & Telemetry documenting the Web UI Memory tab and
the GET /collections/{name}/memory API endpoint added in qdrant/qdrant#8606
and qdrant/qdrant-web-ui#372.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Update web-ui docs link

* Review feedback

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-30 20:24:27 +02:00
Dylan CouzonandClaude Opus 4.7 33bd663d80 Move retrieval relevance and pipeline-output tutorials to Improve Search
Splits the three retrieval-evaluation tutorials across two sections.
ANN Recall (Web UI, language-agnostic) stays under Search Engineering.
The two Python ecosystem tutorials (ranx, ragas) move to a new top-level
Improve Search section under the Ecosystem partition.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 12:30:08 -04:00
Dylan CouzonandClaude Opus 4.7 8ca87dc442 Update ANN Recall Tutorial assets
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 10:52:59 -04:00
Abdon Pijpelink 920d957ab5 Explicitly list Cloud strict mode restrictions (#2320) 2026-04-30 14:28:40 +02:00
b541a7aa7d Document low memory mode (v1.18.0) (#2301)
* Document low memory mode (v1.18.0)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case for all headers

* Update qdrant-landing/content/documentation/ops-configuration/administration.md

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Tim Visée <tim@visee.me>
2026-04-30 09:05:59 +02:00
Abdon Pijpelink 10b98c3ca2 Docs for adding/removing named vectors (#2282)
* Initial commit

* Switch to title case for Collections page

* Move to Collections page

* One more clarification

* Update section title
2026-04-30 09:03:48 +02:00
Dylan CouzonandClaude Opus 4.7 04426d8fec Rename Search Quality tab to ANN Recall in tutorial
Web UI is renaming the tab, card title, and column header to
"ANN Recall" alongside the precision-to-recall switch. Update the
prose and screenshot alt text to match. Button label
(Check Index Quality) stays as is.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:03:30 -04:00
Dylan CouzonandClaude Opus 4.7 9f4b4c05ea Rename ANN precision tutorial to ANN recall
Recall@k is the standard metric for ANN benchmarks. Rename the
tutorial title, headings, helper function, and prose; update the
recent inline edits and merge sentence; and update cross-links from
the relevance and pipeline-output tutorials and the tutorials index.
Generic Precision@k mentions in the ranx metric list are unrelated
and left alone.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:00:06 -04:00
Dylan CouzonandClaude Opus 4.7 b7b2865e14 Fix ANN precision tutorial: tune hnsw_ef, not build-time params
The Search Quality tab uses the Query Points API, so it can only
tune search-time SearchParams. Replace the m/ef_construct walkthrough
with hnsw_ef and link to the Essentials course for the build-time
trade-offs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 14:49:05 -04:00
Dylan CouzonandClaude Opus 4.7 ac9f77d9f3 Trim business-impact framing from retrieval-quality tutorials
Keep a brief Layer 4 mention in the ANN guide and remove the dedicated section from the pipeline-output guide.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-28 12:02:53 -04:00
Dylan Couzon 9f096c4d7e Simplify definitions 2026-04-27 11:30:43 -04:00