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
🌐 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 |
How It Works
- Enable: The
--web-search flag activates provider’s native search
- Query: Your prompt is sent with web search capability
- Search: Provider searches the web for relevant information
- Synthesize: Results are synthesized into a coherent response
- 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_search=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 |
