Brave Search

Search the web with BraveSearchTools using the Brave Search API.

BraveSearch enables an Agent to search the web for information using the Brave search engine.

Prerequisites

The following example requires the brave-search and openai libraries.

uv pip install -U agno brave-search openai
export BRAVE_API_KEY=***

Example

cookbook/91_tools/bravesearch_tools.py
from agno.agent import Agent
from agno.tools.bravesearch import BraveSearchTools

agent = Agent(
    tools=[BraveSearchTools()],
    description="You are a news agent that helps users find the latest news.",
    instructions=[
        "Given a topic by the user, respond with 4 latest news items about that topic."
    ],
)

agent.print_response("AI Agents", markdown=True)

Toolkit Params

ParameterTypeDefaultDescription
api_keyOptional[str]NoneBrave API key. If not provided, will use BRAVE_API_KEY environment variable.
fixed_max_resultsOptional[int]NoneA fixed number of maximum results.
fixed_languageOptional[str]NoneA fixed language for the search results.
enable_brave_searchboolTrueEnable or disable the brave_search function.
allboolFalseEnable all available functions in the toolkit.

Toolkit Functions

FunctionDescription
brave_searchSearches Brave for a specified query. Parameters include query (str) for the search term, max_results (int, default=5) for the maximum number of results, country (str, default="US") for the country code for search results, and search_lang (str, default="en") for the language of the search results. Returns a JSON formatted string containing the search results.

Developer Resources