Use the results
Results are ordered by relevance. Every response also includes request-level usage:- Load the source record using
doc_id. - Apply your application’s current access rules.
- Preserve the returned order when showing results or building context.
chunk_id as a permanent business ID; it can change when a document is replaced.
Adjust search
Start with the defaults. Increase
candidate_k only after testing with representative queries. Scores are for ordering one response; do not assume a fixed score range.
Filters are not an authorization boundary. Always check access after loading the source record.
An empty results array is valid. Confirm that documents were added to the same index, then retry without a filter.