Skip to main content
Web Search provides AI-optimized access to current information across the internet with intelligent result ranking and relevance scoring.

​
Key Features

  • Real-time Results - Access latest information, news, and websites
  • Relevance Scoring - Results ranked by relevance to query
  • Safe Search - Automatic filtering of inappropriate content
  • Multiple Search Modes - General, news, images, academic
  • Source Attribution - Know where results came from

​
How to Enable

​
For Agents

  1. Agents > Select Agent > Settings
  2. Capabilities tab > Attach Capability
  3. Search for Web Search
  4. Click Attach
  5. Save

​
For MCP Gateways

  1. Gateways > Select Gateway
  2. Capabilities tab > Attach Capability
  3. Search for Web Search
  4. Click Attach
  5. Save

​
Configuration

Web Search has no required configuration. Optional settings in specifications: 
{
  "web_search": {
    "safe_search": true,
    "results_limit": 10,
    "language": "en"
  }
}

​
Available Options

OptionDefaultEffect
safe_searchtrueFilter explicit content
results_limit10Max results returned
language”en”Search language
region”US”Region for localized results

​
Usage Examples

"Search for the latest AI research papers"
Returns: 
{
  "results": [
    {
      "title": "...",
      "url": "...",
      "snippet": "...",
      "relevance_score": 0.95,
      "published": "2025-03-20"
    }
  ]
}

"Find recent news about quantum computing"
Focuses on news sources with publishing dates and relevance scores. 
"Search academic papers on neural networks"
Returns peer-reviewed sources and citations.

​
Search Modes

Standard web search across all sources.
"Search for Python tutorial"

​
Resource Limits

LimitValueNotes
Timeout30 secondsPer request
Max Results10Per query
Max Retries3Automatic retry on failure

​
Limitations

  • Cannot search private sites (login required)
  • Rate-limited by search provider
  • Some sources may block automated searches
  • Results vary by region and language

​
Cost

For current pricing details, see Pricing. Monitor in Account > Usage dashboard.

​
Best Practices

​
Be Specific

  • Good: “Latest PyTorch releases 2025”
  • Bad: “Python”

​
Use Multiple Queries

Break complex questions into focused searches: 
Search 1: "Kubernetes deployment best practices"
Search 2: "Kubernetes monitoring tools 2025"
Search 3: "Kubernetes security hardening"

​
Combine with Code Runner

Use search results with Python to:
  • Parse and analyze results
  • Extract structured data
  • Create summaries
  • Generate reports

​
Cache Results

For frequently searched topics, consider caching results in Files to avoid repeated queries.

​
Troubleshooting

​
No Results Found

Check:
  • Query is specific enough
  • Not searching for private/paywalled content
  • Try different keywords

​
Slow Responses

  • Results being processed through AI ranking
  • Network latency
  • Large result set being filtered

​
Missing Recent Results

  • Search index may be 24-48 hours behind
  • Check different search terms
  • Try News mode for very recent information

​
Next Steps