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!Web Search Finds Current Information
Usage
Basic Web Search
praisonai "What are the latest AI news today?" --web-search --llm openai/gpt-4o-search-previewExpected 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-previewSupported 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-previewHow It Works
- Enable: The
--web-searchflag 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-previewResearch Query
praisonai "Latest research on quantum computing" \
--web-search --llm openai/gpt-4o-search-previewReal-time Data
praisonai "Current Bitcoin price and market analysis" \
--web-search --llm openai/gpt-4o-search-previewProgrammatic 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
| 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 |