Orchestrate multiple AI capabilities (knowledge base, web search, summarization) for comprehensive analysis.Method Signature#
Parameters#
prompt (str, required): Query or analysis task
use_knowledge_base (bool, optional): Query uploaded documents (default: True)
use_summary (bool, optional): Include document summary context (default: True)
use_web_search (bool, optional): Search web for current information (default: True)
use_memory (bool, optional): Enable conversation context/memory (default: True)
Returns#
Async iterator yielding response chunks (strings) for streaming display.Examples#
Basic Usage (All Features Enabled)#
Selective Feature Control#
LLM-Only Mode#
Market Analysis with Full Context#
Use Cases#
1. Research & Analysis#
Combine documents with web search for comprehensive research:2. Document-Grounded Q&A#
Query documents without external information:Get current information without document context:Behavior#
The engine intelligently decides which tools to use based on your query and enabled capabilities:Knowledge Base: Retrieves relevant document chunks
Summary: Provides document overview for context
Web Search: Searches web for current information
Memory: Maintains conversation context across queries
1.
Planning: Analyzes query to determine tool needs
2.
Parallel Execution: Runs applicable tools concurrently
3.
Synthesis: Combines results into coherent response
4.
Streaming: Delivers response as it's generated
Memory & Context#
With use_memory=True (default):Remembers previous queries in session
Maintains conversation context
Allows follow-up questions
Pros: Most comprehensive answers, combines multiple sources
Cons: Slower response time, higher token usage
Best for: Research, analysis, complex queries
Pros: Faster responses, lower costs
Cons: May miss relevant information
Best for: Simple queries, known information needs
Error Handling#
Engine vs Query#
| Feature | Engine | Query |
|---|
| Knowledge Base | Optional | Always |
| Web Search | Optional | No |
| Summary | Optional | No |
| Use Case | Flexible analysis | Document Q&A |
Engine vs Agent#
| Feature | Engine | Agent |
|---|
| Built-in Tools | Knowledge base, web, summary | Custom tools |
| Orchestration | Automated | Planned & executed |
| Use Case | Standard workflows | Custom workflows |
Tips & Best Practices#
1. Start with Defaults#
2. Disable Unused Features#
3. Use Memory for Conversations#
4. Disable Memory for Independent Queries#
See Also#
Modified at 2025-10-17 17:46:10