Local search tool, directly calls web_search, automatically selects Tavily or Exa.
Difference from cloud_agent
| web_search | cloud_agent | |
|---|---|---|
| Run location | Local | Cloud |
| API Key | Requires user configuration | Already available in cloud |
| Suitable scenarios | Quick searches, simple queries | In-depth research, multi-step analysis, long tasks |
| Speed | Fast (200ms-3s) | Slow (1-5 minutes) |
Decision rules: Local has Key → web_search; local has no Key or requires in-depth research → cloud_agent。
Use cases
- User says "help me search..." "look up..." "latest news"
- Quick searches, simple queries (when a Key is available locally)
Invocation method
Parameters only require query, other optionals:
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | Required | Search keywords |
max_results |
integer | 5 | Maximum number of results (upper limit 20) |
search_depth |
string | basic | basic(quick) or advanced(deep) |
time_range |
string | any | day / week / month / any |
Search backend
| Backend | Key | Free quota | Features |
|---|---|---|---|
| Tavily | TAVILY_API_KEY |
1000 times/month | AI optimized, 200ms response |
| Exa | EXA_API_KEY |
1000 times/month | Semantic search, includes full text |
Configure at least one API Key to use it.
Output specifications
- Cite information sources when answering (with links)
- Distinguish between "facts" and "speculation/opinions"
- Inform the user when search results are insufficient
- Mark dates on time-sensitive information