Enable web search by setting
"tools_enabled": ["auto_search"] in your request to access current information and real-time data.Quick Start
- Python
- JavaScript
- cURL
Search Integration
Whentools_enabled includes "auto_search", the agent can:
- Access real-time web information
- Search for current news and developments
- Verify facts with up-to-date sources
- Provide contextually relevant information
- Cite sources for transparency
Use Cases
Current Events Research
Market Research
Technical Research
Product Research
Search Quality Control
Source Verification
Recent Information Priority
Advanced Search Configuration
Combined with Conversation History
Best Practices
- Specific Queries: Ask specific questions for better search results
- Time Sensitivity: Specify time frames for time-sensitive topics
- Source Quality: Request verification from reliable sources when needed
- Context Preservation: Use conversation history for follow-up questions
- Cost Awareness: Search-enabled agents use additional tokens
Cost Considerations
- Search Operations: Additional costs for web search access
- Token Usage: Increased token consumption for search results processing
- Quality Trade-off: Balance search quality with cost efficiency
Error Handling
Search Result Format
Search-enabled agents return the standard/v1/agent/completions response shape. The agent’s answer (with any web-sourced facts woven into the text) appears in outputs, and the search tool’s cost is deducted from your credits and reflected in total_cost:
Rate Limiting
Search operations may have additional rate limits:- Per Minute: 10 search requests
- Per Hour: 100 search requests
- Per Day: 500 search requests