Search
Coming soon (Phase 5)Semantic search, RAG retrieval, and vector similarity search across your content. Not yet callable — returns a gated error today.
Not yet callable
Search capabilities are planned for Phase 5 of the platform roadmap. The RAG subsystem (Qdrant, vector-search service, ingestion worker) has not yet been introduced.
Calling any rag:* slug today returns 403 capability_gated. Do not depend on these endpoints in production code yet.
Intended Capabilities (Phase 5)
| Slug | What it will do |
|---|---|
| rag:embed-and-index | Embed and index a document or text chunk into the vector store |
| rag:retrieve-context | Retrieve relevant chunks for a query using vector similarity |
| rag:answer-with-citations | Answer a question grounded in indexed documents with source citations |
| rag:doc-ingest | Ingest a full document (PDF, HTML, plain text) into the knowledge base |
Intended API Shape
When live, search capabilities will follow the standard capability execution pattern — no special search endpoints.
JavaScript SDK (future)
// NOT callable yet — returns 403 today
const run = await client.capabilities.run('rag:retrieve-context', {
query: 'How do I reset my password?',
topK: 5,
})cURL (future)
# NOT callable yet — returns 403 today
curl -X POST https://api.whizur.ai/v1/capabilities/rag:retrieve-context/execute \
-H "X-API-Key: cw_dev_..." \
-H "Content-Type: application/json" \
-d '{
"input": {
"query": "How do I reset my password?",
"topK": 5
}
}'Intended input shape — rag:retrieve-context
{
"query": string, // natural-language query
"topK"?: number, // default: 10
"collectionId"?: string // scope to a specific knowledge base
}Intended output artifact
{
"chunks": [
{
"text": string,
"score": number,
"sourceDocumentId": string
}
]
}Why Phase 5?
The RAG subsystem requires Qdrant (vector database), a dedicated vector-search service, and an ingestion worker — all of which are gated behind the service reintroduction playbook. Phase 5 introduces and stabilizes these before the search capabilities are published. See context/architecture/launch-scope.md for the full phase plan.