Repository navigation
v2.0.0
Release Notes - OpenWebUI Agentic Tooling Suite
Version 2.0.0 - January 2026
🚀 Major Release: Introducing Exa Agentic Search
This release marks a significant evolution in the search capabilities of the OpenWebUI Agentic Tooling Suite. We've completely reimagined the search architecture with a new agentic approach that gives the AI full control over search parameters, resulting in more intelligent and adaptive research.
🆕 New: Exa Agentic Search Tool (v2.0.0)
Replaces: exa_router_search.py
New File: exa_agentic_search.py
The new Exa Agentic Search Tool is a ground-up rewrite that transforms web search from a passive tool into an intelligent research agent.
Key Features
| Feature | Description |
|---|---|
| Agent-Controlled Parameters | The AI agent now has full control over search type, category, date filters, domain filters, and result count—adapting dynamically based on query complexity |
| Iterative Research | Multi-pass search with intelligent stopping criteria—the agent decides when enough information has been gathered |
| Enhanced Debug System | Completely redesigned debug output with clean, focused logging and comprehensive session summaries |
| Unified API | Single search_and_contents call for efficiency (replaces separate search + crawl pattern) |
| Smart Query Generation | Agent generates optimized search queries based on context and previous findings |
Search Parameter Control
The agent can now dynamically control:
{
"search_type": "auto | neural | fast | deep",
"category": "news | research paper | github | company | tweet | pdf | ...",
"num_results": "1-25",
"start_published_date": "YYYY-MM-DD",
"end_published_date": "YYYY-MM-DD",
"include_domains": ["example.com"],
"exclude_domains": ["spam.com"],
"include_text": "required phrase",
"queries": ["optimized search query"]
}Standardized Output Format
The agent now uses a consistent output structure for all iterations:
EXTRACTED_INFO: → Key facts from current search
EVALUATION: → Brief assessment of findings
DECISION: → STOP or CONTINUE
SEARCH_CONFIG: → JSON parameters for next search
RESEARCH_SUMMARY: → Final synthesis (when stopping)
KEY_POINTS: → Bullet-point highlights (when stopping)
🔧 Improved: Debug System
The debug system has been completely overhauled for clarity and usefulness:
New Debug Methods
| Method | Purpose |
|---|---|
search_config() |
Logs the agent's chosen search parameters |
search_results() |
Shows result counts per iteration |
sources_found() |
Displays top sources with domains and titles |
agent_evaluation() |
Shows the agent's reasoning/evaluation |
agent_decision() |
Logs STOP/CONTINUE decisions with visual indicators |
Cleaner Output
- Silenced noisy logging: Removed redundant
flow,synthesis,warning,errorinline logs - Deferred error reporting: Errors and warnings are collected and shown in the session summary
- Visual hierarchy: Tree-style output with clear iteration boundaries
- Metrics summary: End-of-session report with timing, LLM calls, and source counts
Example Debug Output:
════════════════════════════════════════════════════════════
🔍 AGENTIC SEARCH [1234]
════════════════════════════════════════════════════════════
Query: What are the latest developments in quantum computing?
▶ ITERATION 1/3
├─ Config:
│ Query: quantum computing latest developments 2026...
│ Type: auto | Cat: news | Num: 10
├─ Results: 8 docs
│ • nature.com - Breakthrough in quantum error...
│ • arxiv.org - New approach to quantum coherence...
│ Eval:
│ Found several recent sources covering quantum...
└─ Decision: ✓ STOP
════════════════════════════════════════════════════════════
📊 SESSION SUMMARY
════════════════════════════════════════════════════════════
Iterations:
#1 auto | 8 docs | ✓STOP | 2.3s
└ quantum computing latest developments 2026
Stats: 2.5s total | 2 LLM calls | 8 sources
════════════════════════════════════════════════════════════
🛠️ Improved: Auto Tool Selector (v1.3.0)
- Updated version to 1.3.0 with improved tool integration
- Better error handling for LLM response parsing with JSONResponse support
- Cleaned Up Code & Reduced File Size within codebase
⚠️ Breaking Changes
- Removed:
exa_router_search.pyis no longer included - Tool ID: Update any references from
exa_router_searchtoexa_agentic_search - Settings: Some valve names have changed—review your configuration
📋 Migration Guide
If you're upgrading from the previous version:
- Backup your current
exa_router_searchvalve settings - Remove the old Exa Router Search tool from OpenWebUI
- Install the new
exa_agentic_search.pyas a Tool - Configure valves:
exa_api_key: Your Exa API keyagent_model: LLM for agentic search (default: gpt-4o-mini)max_iterations: Max search iterations (default: 3)debug_enabled: Enable debug logging (default: false)show_sources: Show source citations (default: false)
For support or issues, please visit our GitHub Issues page.