1# Bing Grounding Tool
2 
3Access real-time web information via Bing Search. Unlike the [Web Search tool](tool-web-search.md) (which works out of the box), Bing Grounding requires a dedicated Bing resource and a project connection.
4 
5> ⚠️ **Warning:** Use the [Web Search tool](tool-web-search.md) as the default for web search. Only use Bing Grounding when the user **explicitly** requests Grounding with Bing Search or Grounding with Bing Custom Search.
6 
7## When to Use
8 
9- User explicitly asks for "Bing Grounding" or "Grounding with Bing Search"
10- User explicitly asks for "Bing Custom Search" or "Grounding with Bing Custom Search"
11- User needs to restrict web search to specific domains (Bing Custom Search)
12- User has an existing Bing Grounding resource they want to use
13 
14## Prerequisites
15 
16- A [Grounding with Bing Search resource](https://portal.azure.com/#create/Microsoft.BingGroundingSearch) in Azure portal
17- `Contributor` or `Owner` role at subscription/RG level to create Bing resource and get keys
18- `Azure AI Project Manager` role on the project to create a connection
19- A project connection configured with the Bing resource key — see [connections](../../../project/connections.md)
20 
21## Setup
22 
231. Register the Bing provider: `az provider register --namespace 'Microsoft.Bing'`
242. Create a Grounding with Bing Search resource in the Azure portal
253. Create a project connection with the Bing resource key — see [connections](../../../project/connections.md)
264. Set `BING_PROJECT_CONNECTION_NAME` environment variable
27 
28## Important Disclosures
29 
30- Bing data flows **outside Azure compliance boundary**
31- Review [Grounding with Bing terms of use](https://www.microsoft.com/bing/apis/grounding-legal-enterprise)
32- Not supported with VPN/Private Endpoints
33- Usage incurs costs — see [pricing](https://www.microsoft.com/bing/apis/grounding-pricing)
34 
35## Troubleshooting
36 
37| Issue | Cause | Resolution |
38|-------|-------|------------|
39| Connection not found | Name mismatch or wrong project | Use `project_connection_list` to find the correct `connectionName` |
40| Unauthorized creating connection | Missing Azure AI Project Manager role | Assign role on the Foundry project |
41| Bing resource creation fails | Provider not registered | Run `az provider register --namespace 'Microsoft.Bing'` |
42| No results returned | Connection misconfigured | Verify Bing resource key and connection setup |
43 
44## References
45 
46- [Bing Grounding tool documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/bing-grounding?view=foundry)
47- [Tool Catalog](https://learn.microsoft.com/azure/ai-foundry/agents/concepts/tool-catalog?view=foundry)
48- [Grounding with Bing Terms](https://www.microsoft.com/bing/apis/grounding-legal-enterprise)
49- [Connections Guide](../../../project/connections.md)
50- [Web Search Tool (default)](tool-web-search.md)
51