The Deep Search Agent provides powerful web search capabilities with intelligent result synthesis. It searches the web, browses pages, and generates comprehensive answers based on real-time information.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/QuantaAlpha/RepoMaster/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Implemented insrc/services/agents/deep_search_agent.py:103, the AutogenDeepSearchAgent class orchestrates web search operations through two specialized agents:
- Researcher Agent: Plans search strategies and analyzes results
- Executor Agent: Executes web searches and browses content
Key Features
Real-time Search
Access current information beyond the model’s knowledge cutoff
Intelligent Browsing
Automatically browse and extract relevant content from web pages
Result Synthesis
Generate comprehensive answers by synthesizing multiple sources
Context Management
Automatically summarize long search results to maintain context
Usage
Basic Usage
CLI Mode
- Direct Mode
- Via Unified Interface
Methods
deep_search()
Execute a deep web search and return synthesized results.The search query or research question
str - Comprehensive answer based on web search results
Source: src/services/agents/deep_search_agent.py:269
web_agent_answer()
Synchronous wrapper for deep_search.The search query
str - Search results as a string
Source: src/services/agents/deep_search_agent.py:332
run()
Execute search and return both final answer and conversation trajectory.The search query
dict - Dictionary containing final_answer and trajectory
Source: src/services/agents/deep_search_agent.py:344
Configuration
Initialization Parameters
LLM configuration dictionary. If None, uses
get_llm_config(service_type="deepsearch")Code execution configuration. If None, uses
{"work_dir": 'coding', "use_docker": False}Whether to return the full chat history along with results
Whether to save search logs to file
Advanced Configuration
Available Tools
The Deep Search Agent has access to the following tools (registered insrc/services/agents/deep_search_agent.py:154):
searching()
Perform web searches using search engines. Implementation:AgentToolLibrary.searching
browsing()
Browse and extract content from web pages. Implementation:AgentToolLibrary.browsing
Context Management
The agent automatically manages context to handle long search sessions:Automatic Summarization: When search results exceed the token limit (default: 2000 tokens), the agent automatically summarizes them to maintain context while staying within LLM limits.
max_tool_messages_before_summary: Number of tool calls before summarizing (default: 2)token_limit: Token count threshold for triggering summarization (default: 2000)- Uses
tiktokenwithcl100k_baseencoding for accurate token counting
Example Use Cases
- Research
- Current Events
- Data Gathering
Architecture
Error Handling
The agent includes comprehensive error handling:search_error_log.txt (source: src/services/agents/deep_search_agent.py:372)
Limitations
Next Steps
Programming Assistant
Learn about general coding assistance
Repository Agent
Explore repository analysis capabilities