web_search - Web Search

Search the internet for real-time information, news, research, and more. Supports nine backends: Bocha, ERNIE, GLM, LinkAI, AnySearch, Serply, Tavily, SearXNG, and Keenable. Keenable also has a keyless anonymous mode that you turn on explicitly; each backend is used once its credentials (or that opt-in) are configured.

It is recommended to configure providers and routing strategy visually from the “Model Management → Search” panel in the Web console, without manually editing the configuration file.

Providers

Provider	Credential	Apply
Bocha	`tools.web_search.bocha_api_key`	Bocha Open Platform
ERNIE	Reuses `qianfan_api_key`	Qianfan Console
Zhipu	Reuses `zhipu_ai_api_key`	Zhipu Open Platform
LinkAI	Reuses `linkai_api_key`	LinkAI Console
AnySearch	Optional `tools.web_search.anysearch_api_key`, or `anysearch_anonymous: true` for keyless use	AnySearch Console
Serply	`tools.web_search.serply_api_key`	Serply (docs)
Tavily	`tools.web_search.tavily_api_key`	Tavily
SearXNG	`tools.web_search.searxng_url` (self-hosted instance URL, no API key needed)	SearXNG
Keenable	Optional `tools.web_search.keenable_api_key`, or `keenable_anonymous: true` for keyless use	Keenable

Bocha, Serply, and Tavily require dedicated keys; Zhipu, ERNIE, and LinkAI reuse the corresponding model’s API key — configuring the model automatically grants search capability. SearXNG is self-hosted and only requires an instance URL. AnySearch is opt-in for keyless use: set tools.web_search.anysearch_anonymous to true (or save it with an empty key in the console’s Search panel) to call it anonymously; configuring tools.web_search.anysearch_api_key (falling back to the ANYSEARCH_API_KEY environment variable when unset) needs no opt-in, and quota and permissions follow the AnySearch server. Keenable is opt-in: set tools.web_search.keenable_anonymous to true (or save it with an empty key in the console’s Search panel) and it calls a public endpoint with per-IP rate limits (10 requests/s, 1000/hour); an optional keenable_api_key (or KEENABLE_API_KEY) lifts them and needs no opt-in.

Routing Strategy

{
  "tools": {
    "web_search": {
      "strategy": "auto",
      "provider": ""
    }
  }
}

auto (default): the Agent intelligently picks among configured providers and may call multiple providers in a single task to gather more comprehensive results; when none is specified, falls back through bocha → qianfan → zhipu → linkai → anysearch → serply → tavily → searxng → keenable.
fixed: always use the provider specified in provider; falls back to the auto order if that provider’s credentials are missing.

Tool Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search keywords
`count`	integer	No	Number of results (1–50, default 10)
`freshness`	string	No	Time range: `noLimit` (default), `oneDay`, `oneWeek`, `oneMonth`, `oneYear`, or date range like `2025-01-01..2025-02-01`
`summary`	boolean	No	Whether to return page summaries (default false)
`provider`	string	No	Available when multiple providers are configured under the `auto` strategy; used to switch provider for a single call

If none of the nine providers is configured (no key, no instance URL, and no anonymous opt-in), this tool is not registered with the Agent.

Tools System

Built-in Tools

Optional Tools

MCP Tools

web_search - Web Search

Providers

Routing Strategy

Tool Parameters

​Providers

​Routing Strategy

​Tool Parameters

Providers

Routing Strategy

Tool Parameters