Health check. Returns 'pong' to confirm the docqa server is reachable.

Use this to verify the connection between the host and this server.

Search the indexed document corpus.

Returns the k best-matching text chunks, each with its source metadata: doc_id, chunk_index, title, url, the chunk text, and a relevance score (higher is better; scores are comparable within one response, not across modes). Results may include multiple chunks from the same document. Use fetch_document with a result's doc_id to read the full source document.

Args: query: A natural-language question or search phrase. k: How many chunks to return (default 5, max 25). mode: 'hybrid' (default) fuses semantic and keyword search — best for most questions. 'vector' is semantic-only — best for paraphrased or conceptual questions. 'lexical' is keyword-only — best when the exact term must appear (identifiers, drug names, error codes).

Fetch one full source document by its id.

Use this after search_documents to read a promising source in full instead of reasoning from a chunk. Returns id, title, url, and the complete text.

Args: doc_id: The document id exactly as returned by search_documents.

Describe the indexed corpus: document/chunk counts, storage backend, and which embedding model built the index.

Call this first if you are unsure whether the corpus is relevant to the user's question or whether anything has been indexed at all.