Skip to main content

Query Engine API

Configure how queries are processed and answered.

Flag

--query-mode <mode>
# or
--mode <mode>

Available Modes

ModeDescription
defaultDirect retrieval + answer synthesis
sub_questionDecompose into sub-questions
summarizeSummarize all retrieved content
sqlGenerate SQL queries (structured data)
routerAuto-select best mode

Usage

Default Mode

# Simple retrieve and answer
praisonai knowledge query "What is Python?" --query-mode default

Sub-Question Mode

# Decompose complex questions
praisonai knowledge query "Compare Python and Java for web development" \
  --query-mode sub_question

Summarize Mode

# Summarize all relevant content
praisonai knowledge query "Summarize the documentation" --query-mode summarize

Router Mode

# Auto-select best mode
praisonai knowledge query "What are the pros and cons?" --query-mode router

Mode Selection Guide

Query TypeRecommended Mode
Simple factualdefault
Multi-part questionssub_question
Overview requestssummarize
Unknown complexityrouter

Examples

Complex Comparison Query

# Decompose into sub-questions
praisonai knowledge query \
  "What are the advantages and disadvantages of microservices vs monolith?" \
  --query-mode sub_question

Document Summary

# Get overview of all content
praisonai knowledge query "Give me an overview of the project" \
  --query-mode summarize

Full Pipeline

# Complete RAG configuration
praisonai knowledge query "How should I architect this system?" \
  --vector-store chroma \
  --retrieval fusion \
  --reranker simple \
  --index-type hybrid \
  --query-mode sub_question

See Also