1# Web Search Tool (Preview)
2 
3Enables 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.
4 
5> ⚠️ **Warning:** For Bing Grounding or Bing Custom Search (which require a separate Bing resource and project connection), see [tool-bing-grounding.md](tool-bing-grounding.md). Only use those when explicitly requested.
6 
7## Important Disclosures
8 
9- Web Search (preview) uses Grounding with Bing Search and Grounding with Bing Custom Search, which are [First Party Consumption Services](https://www.microsoft.com/licensing/terms/product/Glossary/EAEAS) governed by [Grounding with Bing terms of use](https://www.microsoft.com/bing/apis/grounding-legal-enterprise) and the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409).
10- The [Data Protection Addendum](https://aka.ms/dpa) **does not apply** to data sent to Grounding with Bing Search and Grounding with Bing Custom Search.
11- Data transfers occur **outside compliance and geographic boundaries**.
12- Usage incurs costs — see [pricing](https://www.microsoft.com/bing/apis/grounding-pricing).
13 
14## Prerequisites
15 
16- A [basic or standard agent environment](https://learn.microsoft.com/azure/ai-foundry/agents/environment-setup)
17- Azure credentials configured (e.g., `DefaultAzureCredential`)
18 
19## Setup
20 
21No external resource or project connection is required. The web search tool works out of the box when added to an agent definition.
22 
23## Configuration Options
24 
25| Parameter | Description | Default |
26|-----------|-------------|---------|
27| `user_location` | Approximate location (country/region/city) for localized results | None |
28| `search_context_size` | Context window space for search: `low`, `medium`, `high` | `medium` |
29 
30## Administrator Control
31 
32Admins can enable or disable web search at the subscription level via Azure CLI. Requires Owner or Contributor access.
33 
34- **Disable:** `az feature register --name OpenAI.BlockedTools.web_search --namespace Microsoft.CognitiveServices --subscription "<subscription-id>"`
35- **Enable:** `az feature unregister --name OpenAI.BlockedTools.web_search --namespace Microsoft.CognitiveServices --subscription "<subscription-id>"`
36 
37## Security Considerations
38 
39- Treat web search results as **untrusted input**. Validate before use in downstream systems.
40- Avoid sending secrets or sensitive data in prompts forwarded to external services.
41 
42## Troubleshooting
43 
44| Issue | Cause | Resolution |
45|-------|-------|------------|
46| No citations appear | Model didn't determine web search was needed | Update instructions to explicitly allow web search; ask queries requiring current info |
47| Requests fail after enabling | Web search disabled at subscription level | Ask admin to enable — see Administrator Control above |
48| Authentication errors (REST) | Bearer token missing, expired, or insufficient | Refresh token; confirm project/agent access |
49| Outdated results | Content not recently indexed by Bing | Refine query to request most recent info |
50| No results for specific topics | Query too narrow | Broaden query; niche topics may have limited coverage |
51| Rate limiting (429) | Too many requests | Implement exponential backoff; space out requests |
52 
53## References
54 
55- [Web Search tool documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-search?view=foundry)
56- [Tool Catalog](https://learn.microsoft.com/azure/ai-foundry/agents/concepts/tool-catalog?view=foundry)
57- [Bing Pricing](https://www.microsoft.com/bing/apis/grounding-pricing)
58