Skip to content

v2.0.0

Choose a tag to compare

@ShaoRou459 ShaoRou459 released this 04 Jan 04:56
· 7 commits to main since this release

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, error inline 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

  1. Removed: exa_router_search.py is no longer included
  2. Tool ID: Update any references from exa_router_search to exa_agentic_search
  3. Settings: Some valve names have changed—review your configuration

📋 Migration Guide

If you're upgrading from the previous version:

  1. Backup your current exa_router_search valve settings
  2. Remove the old Exa Router Search tool from OpenWebUI
  3. Install the new exa_agentic_search.py as a Tool
  4. Configure valves:
    • exa_api_key: Your Exa API key
    • agent_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.