Web Search

Agents can search the web using the built-in WebSearch tool. Native WebSearch() runs on the model provider with Anthropic and OpenAI/xAI Responses, and through the Timbal platform on every other tool-capable model (timbal/auto included). Select an executable search provider to use your own search credentials instead. Domain-filtered searches also use the platform fallback when the model can’t apply the filters natively (openai/gpt-4.1-mini, openai/gpt-4o-mini, or xAI with both lists or more than 5 domains). This requires a platform subject; unfiltered searches stay native.

See the Model Reference to check which specific models support web search.

from timbal import Agent
from timbal.tools import WebSearch

# Works with OpenAI or Anthropic models
agent = Agent(
    name="SearchAgent",
    model="openai/gpt-5-mini",
    tools=[WebSearch()],
    system_prompt="Search the web for current information."
)

# Agent will automatically use search when needed
result = await agent(
    prompt="When was the last match of Liverpool?"
).collect()

Search with another model provider

Set TAVILY_API_KEY and use an executable search tool:

agent = Agent(
    name="search_assistant",
    model="google/gemini-3.5-flash",
    tools=[WebSearch(provider="tavily")],
    system_prompt="Search for current information and cite the sources you use.",
)

Other executable selectors are scraperapi, cala, firecrawl, and google. See Tools for credential resolution and native search constraints.

Key Features

Real-time Information: Access current web data and news
Automatic Tool Selection: Agent decides when to search
Citation Support: Includes source links in responses

Examples

Guides

Agents

Workflows

Search with another model provider

Key Features

​Search with another model provider

​Key Features

Search with another model provider

Key Features