Web Search

Get real-time information using native web search capabilities

The --web-search flag enables native web search capabilities for supported LLM providers.

Quick Start

praisonai "What are the latest AI news today?" --web-search --llm openai/gpt-4o-search-preview

Usage

Basic Web Search

praisonai "What are the latest AI news today?" --web-search --llm openai/gpt-4o-search-preview

Expected Output:

🌐 Web Search enabled

╭─ Agent Info ─────────────────────────────────────────────────────────────────╮
│  👤 Agent: DirectAgent                                                       │
│  Role: Assistant                                                             │
│  Model: openai/gpt-4o-search-preview                                        │
│  Web Search: Enabled                                                         │
╰──────────────────────────────────────────────────────────────────────────────╯

╭────────────────────────────────── Response ──────────────────────────────────╮
│ Based on today's news (December 2024):                                      │
│                                                                              │
│ 1. **OpenAI announces GPT-5 preview** - New capabilities include...         │
│ 2. **Google releases Gemini 2.0** - Enhanced multimodal features...         │
│ 3. **Anthropic updates Claude** - Improved reasoning and...                 │
│                                                                              │
│ Sources: [1] techcrunch.com [2] theverge.com [3] wired.com                  │
╰──────────────────────────────────────────────────────────────────────────────╯

Combine with Other Flags

# Web search with metrics
praisonai "Latest stock market news" --web-search --metrics --llm openai/gpt-4o-search-preview

# Web search with save
praisonai "Current weather in Tokyo" --web-search --save --llm openai/gpt-4o-search-preview

Supported Providers

Provider	Models	Notes
OpenAI	gpt-4o-search-preview	Native search integration
Gemini	gemini-pro, gemini-ultra	Google Search integration
Anthropic	claude-sonnet-4-20250514, claude-3-opus	Web search tool
xAI	grok-2	Real-time web access
Perplexity	pplx-7b-online, pplx-70b-online	Built-in search

YAML Equivalent

Use web: true on an agent with a web-search enabled model:

agents:
  searcher:
    role: Web Search Agent
    instructions: "Find current information from the web"
    web: true
    llm: openai/gpt-4o-search-preview

How It Works

1. Enable: The --web-search flag activates provider’s native search
2. Query: Your prompt is sent with web search capability
3. Search: Provider searches the web for relevant information
4. Synthesize: Results are synthesized into a coherent response
5. Cite: Sources are included when available

Examples

News Query

praisonai "What happened in tech news this week?" \
  --web-search --llm openai/gpt-4o-search-preview

Research Query

praisonai "Latest research on quantum computing" \
  --web-search --llm openai/gpt-4o-search-preview

Real-time Data

praisonai "Current Bitcoin price and market analysis" \
  --web-search --llm openai/gpt-4o-search-preview

Programmatic Usage

from praisonaiagents import Agent

agent = Agent(
    instructions="You are a research assistant",
    llm="openai/gpt-4o-search-preview",
    web=True
)

result = agent.start("What are the latest AI news today?")
print(result)

Comparison with Other Options

Feature	--web-search	Deep Research	Tools
Speed	Fast	Slow	Medium
Depth	Surface	Deep	Configurable
Sources	Few	Many	Depends
Provider	Limited	OpenAI/Gemini	Any

Best Practices

Use --web-search for quick, real-time information. For in-depth research, use praisonai research instead.

Web search availability depends on the provider and model. Not all models support native web search.

Do	Don’t
Use for current events	Use for historical analysis
Use for quick lookups	Use for deep research
Specify time context	Assume recency
Check provider support	Assume all models work

Related

• Web Fetch CLI
• Deep Research CLI
• Model Capabilities