Search Providers

Pick a web-search backend (DuckDuckGo, Tavily, Serper) for your agent — or plug in your own

Pick a web-search backend (DuckDuckGo, Tavily, Serper) for your agent — or plug in your own.

from praisonaiagents import Agent

agent = Agent(
    name="Researcher",
    instructions="Search the web and summarise findings.",
    web=True,
)
agent.start("Latest news on renewable energy")

The user enables web=True; PraisonAI routes searches through DuckDuckGo, Tavily, Serper, or a custom provider.

How It Works

Quick Start

1. Simple Usage

   Give your agent web search with the default DuckDuckGo provider:

   from praisonaiagents import Agent
   
   agent = Agent(
       name="Researcher",
       instructions="Search the web and summarise findings.",
       web=True,
   )
   agent.start("Latest news on renewable energy")

2. Switch providers via config

   Select Tavily or Serper from the CLI or bot config:

   praisonai bot run telegram --web-search --web-provider tavily

   from praisonaiagents import Agent
   
   agent = Agent(
       name="Researcher",
       instructions="Use Tavily for deep web search.",
       web=True,
   )
   # Set WEB_SEARCH_PROVIDER=tavily in the environment, or pass via bot YAML

3. Register a custom search provider

   Distribute a custom provider as a pip plugin:

   # pyproject.toml
   [project.entry-points."praisonai.tools.search"]
   my-search = "my_pkg.tools:MySearchTool"

   from praisonai.cli.features._search_registry import SearchProviderRegistry
   
   registry = SearchProviderRegistry.default()
   tool_cls = registry.resolve("my-search")
   tool = tool_cls()

Built-in Providers

Entry-point group: praisonai.tools.search

Which Provider Should I Pick?

Best Practices

export TAVILY_API_KEY=tvly-...
praisonai bot run telegram --web-search --web-provider tavily

Related