web_search
Searches the web to retrieve real-time information, returning summarized content and source count. Supports planning sessions for gated multi-step searches or one-shot mode for direct lookups.
Instructions
Performs a web search through the configured search mode and caches the source list.
PLANNING GATE: when `plan_session_id` is provided, this tool refuses to run until the
plan is complete (all required phases done, unverified_terms covered). If you intend to
skip planning (one-shot factual lookup), call this tool with an empty `plan_session_id`.
Returns:
- session_id string pass to get_sources to retrieve full source list
- content string answer from API-search summarization or online model search
- sources_count int
- cached bool true if response was served from in-memory result cache
- budget object (when plan_session_id set) actual vs estimated tool calls
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional model ID for this request only. This value is used ONLY when user explicitly provided. | |
| query | Yes | Clear, self-contained natural-language search query. | |
| platform | No | Target platform to focus on (e.g., 'Twitter', 'GitHub', 'Reddit'). Leave empty for general web search. | |
| plan_session_id | No | Planning session ID. When set, the tool enforces plan completion before running. Empty = no gating (one-shot mode). |