Search

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

search needs the ddgs package at runtime. Install it with pip install ddgs.

Quick Start

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")

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"])

If ddgs is missing or the provider rate-limits, search raises RuntimeError instead of returning an empty result. Earlier releases silently returned total=0 — that behaviour is gone.

How It Works

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

Configuration Options

Parameter	Type	Default	Description
`query`	`str`	Required	Search query
`sources`	`List[str]`	`None`	Optional list of sources to search
`max_results`	`int`	`10`	Maximum number of results
`timeout`	`float`	`600.0`	Request timeout in seconds
`metadata`	`Dict`	`None`	Optional metadata for tracing

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

Capabilities SDK Reference

Auto-generated reference for the capabilities module

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

Install ddgs before using search

Run pip install ddgs. Without it, search raises RuntimeError.

Catch RuntimeError

Rate limits and missing dependencies surface as RuntimeError. Wrap calls so your app degrades gracefully instead of crashing.

Tune max_results

Lower max_results for faster, cheaper queries; raise it when you need broader coverage.

Web Search Tools

Search tools for agents

Capabilities Overview

All LiteLLM parity capabilities

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

Quick Start

How It Works

Configuration Options

Capabilities SDK Reference

Common Patterns

Best Practices

Web Search Tools

Capabilities Overview

​Quick Start

​How It Works

​Configuration Options

Capabilities SDK Reference

​Common Patterns

​Best Practices

​Related

Web Search Tools

Capabilities Overview

Quick Start

How It Works

Configuration Options

Common Patterns

Best Practices

Related