# RAG Search Playground

Test console to evaluate natural-language queries against the vector store and calibrate retrieval parameters.

- id: `rag-search-playground`
- Page: https://agentic-ui-kit.com/components/rag-search-playground
- Live preview: https://agentic-ui-kit.com/live/component/rag-search-playground

## Install

```bash
agentic-ui add rag-search-playground
npx shadcn@4.17.0 add @agentic-ui/rag-search-playground
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** vector-query-testing, similarity-threshold-tuning, top-k-adjustment, hybrid-dense-sparse-toggle, vector-embedding-inspection, score-decomposition, preset-queries, collection-selector, chunk-preview-copy, keyboard-navigation, empty-state, error-recovery
- **Intents:** retrieve-knowledge, explore-detail, track-status, manage-collection
- **Suits domains:** knowledge, ai-workspace, devtools, saas, support
- **Interaction:** vector-query-testing, parameter-tuning-slider, mode-selection, result-inspection, keyboard-navigation
- **Screen role:** detail
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** test console to evaluate natural-language queries against the vector store and calibrate retrieval parameters, hybrid search test bench combining dense embedding similarity and BM25 lexical matching, vector store diagnostic tool to inspect scores, dimensions and returned fragments, interactive environment to tune similarity thresholds and top-k before sending context to the generative model
- **Avoid when:** management of bulk document ingestion without running searches (use rag-source-manager), traditional tabular search based solely on SQL without vectors
- **Preserve when adapting:** query-and-parameter-layout, vector-match-score-decomposition, keyboard-navigation-contract, telemetry-hud
- **Replace when adapting:** vector-collection-fixtures, embedding-dimensions-and-models, domain-documents
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives