Search

Web search via DuckDuckGo, backed by the ddgs package

search runs a real DuckDuckGo query and raises when the backend fails, so missing dependencies and rate limits are visible instead of silent.

Quick Start

1. Search from an Agent

   Give an agent the web search tool for research tasks.

   from praisonaiagents import Agent
   from praisonaiagents.tools import internet_search
   
   agent = Agent(
       name="Researcher",
       instructions="Search the web and summarise findings",
       tools=[internet_search]
   )
   
   agent.start("Find the latest news on the PraisonAI framework")

2. Direct capability call

   Call search directly when you just need raw results.

   from praisonai.capabilities import search
   
   result = search("PraisonAI framework")
   
   for r in result.results:
       print(r["title"], r["url"])

How It Works

search calls internet_search under the hood. Each result is a dict with title, url, and snippet keys.

Configuration Options

SearchResult fields: results (list of dicts), query, total, metadata.

Common Patterns

Handle a missing dependency gracefully:

from praisonai.capabilities import search

try:
    result = search("open source LLM agents")
    print(f"{result.total} results")
except RuntimeError as e:
    print(f"Search unavailable: {e}")
    # e.g. install ddgs: pip install ddgs

Async search delegates to the sync path:

import asyncio
from praisonai.capabilities import asearch

async def main():
    result = await asearch("vector databases")
    for r in result.results:
        print(r["title"])

asyncio.run(main())

Best Practices

Related