Anthropic Web Search

Use Anthropic’s native web_search tool and inspect search metrics on the run output.

web_search.py

"""
Anthropic Web Search
====================

Cookbook example for `anthropic/web_search.py`.
"""

from pprint import pprint

from agno.agent import Agent
from agno.db.in_memory import InMemoryDb
from agno.models.anthropic import Claude

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    model=Claude(
        id="claude-sonnet-4-20250514",
    ),
    db=InMemoryDb(),
    tools=[
        {
            "type": "web_search_20250305",
            "name": "web_search",
            "max_uses": 5,
        }
    ],
    markdown=True,
)

agent.print_response("What's the latest with Anthropic?", stream=True)

# Show the web search metrics
run_output = agent.get_last_run_output()
print("---" * 5, "Web Search Metrics", "---" * 5)
pprint(run_output.metrics)
print("---" * 20)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    pass

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno anthropic
   
3. Export your Anthropic API key

   Mac/Linux

   export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
   

   $Env:ANTHROPIC_API_KEY="your_anthropic_api_key_here"
   
4. Run the example

   Save the code above as web_search.py, then run:

   python web_search.py
   

Full source: cookbook/90_models/anthropic/web_search.py