Bing Grounding Tool
Access real-time web information via Bing Search. Unlike the Web Search tool (which works out of the box), Bing Grounding requires a dedicated Bing resource and a project connection.
⚠️ Warning: Use the Web Search tool 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.
When to Use
- User explicitly asks for "Bing Grounding" or "Grounding with Bing Search"
- User explicitly asks for "Bing Custom Search" or "Grounding with Bing Custom Search"
- User needs to restrict web search to specific domains (Bing Custom Search)
- User has an existing Bing Grounding resource they want to use
Prerequisites
- A Grounding with Bing Search resource in Azure portal
ContributororOwnerrole at subscription/RG level to create Bing resource and get keysAzure AI Project Managerrole on the project to create a connection- A project connection configured with the Bing resource key — see connections
Setup
- Register the Bing provider:
az provider register --namespace 'Microsoft.Bing' - Create a Grounding with Bing Search resource in the Azure portal
- Create a project connection with the Bing resource key — see connections
- Set
BING_PROJECT_CONNECTION_NAMEenvironment variable
Important Disclosures
- Bing data flows outside Azure compliance boundary
- Review Grounding with Bing terms of use
- Not supported with VPN/Private Endpoints
- Usage incurs costs — see pricing
Troubleshooting
| Issue | Cause | Resolution |
|---|---|---|
| Connection not found | Name mismatch or wrong project | Use project_connection_list to find the correct connectionName |
| Unauthorized creating connection | Missing Azure AI Project Manager role | Assign role on the Foundry project |
| Bing resource creation fails | Provider not registered | Run az provider register --namespace 'Microsoft.Bing' |
| No results returned | Connection misconfigured | Verify Bing resource key and connection setup |