Web Search Tool (Preview)
Enables agents to retrieve and ground responses with real-time public web information before generating output. Returns up-to-date answers with inline URL citations. This is the default tool for web search — no external resource or connection setup required.
⚠️ Warning: For Bing Grounding or Bing Custom Search (which require a separate Bing resource and project connection), see tool-bing-grounding.md. Only use those when explicitly requested.
Important Disclosures
- Web Search (preview) uses Grounding with Bing Search and Grounding with Bing Custom Search, which are First Party Consumption Services governed by Grounding with Bing terms of use and the Microsoft Privacy Statement.
- The Data Protection Addendum does not apply to data sent to Grounding with Bing Search and Grounding with Bing Custom Search.
- Data transfers occur outside compliance and geographic boundaries.
- Usage incurs costs — see pricing.
Prerequisites
- A basic or standard agent environment
- Azure credentials configured (e.g.,
DefaultAzureCredential)
Setup
No external resource or project connection is required. The web search tool works out of the box when added to an agent definition.
Configuration Options
| Parameter | Description | Default |
|---|---|---|
user_location | Approximate location (country/region/city) for localized results | None |
search_context_size | Context window space for search: low, medium, high | medium |
Administrator Control
Admins can enable or disable web search at the subscription level via Azure CLI. Requires Owner or Contributor access.