v4

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-13216144508.7 KB
kb

Search

Search documents in the knowledge base.

Args: collection: Target collection to search within. query_text: Query text to search for. embedding_model_id: Embedding model ID (required for dense/hybrid search). search_type: Search strategy (dense, sparse, or hybrid). top_k: Maximum number of results to return. filters: Optional filters for search. fusion_config: Optional fusion configuration for hybrid search. rerank_model_id: Optional rerank model for result reordering. rerank_top_k: Override for rerank result count. readonly: Whether to avoid index modifications. nprobes: Number of partitions to probe for ANN search. refine_factor: Refine factor for ANN search re-ranking. fallback_to_sparse: Allow hybrid search to fallback to sparse.

post/api/kb/search

Response

Successful Response

statusstring required

Pipeline status: success|partial_success|error

search_type'dense' | 'sparse' | 'hybrid' required

Unified search types for the document search pipeline.

result_countinteger required

Number of results returned

warningsstring[]

Non-fatal warnings and fallback messages

messagestring required

Human-readable pipeline outcome message

used_rerankboolean

Whether rerank model was applied to the results