Skip to content

Commit 1b438b5

Browse files
Update Bing Search Grounding setup guide
1 parent 8620c03 commit 1b438b5

File tree

1 file changed

+37
-33
lines changed

1 file changed

+37
-33
lines changed
Lines changed: 37 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,47 @@
1-
# Grounding with Bing Search — Quick Setup
21

3-
This guide shows how to **create a Grounding with Bing Search resource** and **connect it to your Azure AI Foundry project through the portal**.
2+
````markdown
3+
# 🌐 Grounding with Bing Search — Quick Setup
4+
5+
This guide explains how to **create a Bing Search Grounding resource** and **connect it to your Azure AI Foundry project**.
46

57
---
68

7-
## Prerequisites
9+
## Prerequisites
810

9-
* An **Azure subscription**
10-
* **Azure CLI** installed and logged in (`az login`)
11-
* A **resource group** already created
12-
* Register the Bing provider:
11+
- An active **Azure subscription**
12+
- **Azure CLI** installed and logged in (`az login`)
13+
- A **resource group** created
14+
- Register the Bing provider (one-time setup):
1315

1416
```bash
1517
az provider register --namespace Microsoft.Bing
16-
```
18+
````
19+
20+
⚠️ **Important:**
21+
Bing Search Grounding only supports **API key authentication**.
22+
Ensure your **Azure AI Foundry account has Local Authentication enabled**.
23+
If local auth is disabled, you will not be able to connect Bing Search.
1724

18-
⚠️ **Important:**
19-
Bing Search grounding only works with **API key authentication**.
20-
Make sure your **Azure AI Foundry account has Local Authentication enabled**.
21-
If local auth is disabled, you will not be able to create a Bing Search connection.
25+
---
2226

27+
## 🚀 Step 1: Create a Bing Search Grounding Resource
2328

24-
## 1) Create the Bing Search Grounding resource
29+
### Option A — Azure Portal
2530

26-
### Option A — Using Azure Portal
31+
1. In the [Azure Portal](https://portal.azure.com), search for **Bing Search (Grounding)**.
32+
2. Click **Create**.
33+
3. Select your **Subscription** and **Resource Group**.
34+
4. Enter a **Resource Name** and choose a **Pricing Tier (SKU)**.
35+
5. At the bottom of the form, tick the required checkbox:
36+
*“I confirm I have read and understood the notice above.”*
37+
(You cannot proceed without this.)
38+
6. Click **Review + Create****Create**.
2739

28-
1. In the [Azure Portal](https://portal.azure.com), search for **Bing Search (Grounding)**.
29-
2. Click **Create**.
30-
3. Select the **Subscription** and **Resource Group**.
31-
4. Enter the **Resource Name** and select a **Pricing Tier (SKU)**.
32-
5. ⚠️ At the bottom of the creation form, you will see a required checkbox:
33-
- You must enable: ✅ *“I confirm I have read and understood the notice above.”*
34-
- Without checking this, you cannot proceed.
35-
6. Click **Review + Create****Create**.
40+
---
3641

37-
### Option B — Using Azure CLI
42+
### Option B — Azure CLI
3843

39-
Set the variables (replace values with your own):
44+
Set your variables (replace with your own values):
4045

4146
```bash
4247
RESOURCE_GROUP="<your-resource-group>"
@@ -62,18 +67,18 @@ az rest --method put \
6267
}'
6368
```
6469

65-
Verify:
70+
Verify creation:
6671

6772
```bash
6873
az resource show --ids "$RESOURCE_ID" --api-version 2020-06-10 -o table
6974
```
7075

7176
---
7277

73-
## 2) Connect the Bing resource to your Azure AI Foundry project (Portal)
78+
## 🔗 Step 2: Connect Bing Search to Azure AI Foundry
7479

75-
1. Go to your **Azure AI Foundry project** in the portal.
76-
2. Open **Management center****Connected resources**.
80+
1. Open your **Azure AI Foundry project** in the [AI Studio portal](https://ai.azure.com).
81+
2. Go to **Management center****Connected resources**.
7782
3. Click **+ Add connection**.
7883
4. Select **Grounding with Bing Search**.
7984
5. Choose the Bing resource you created and click **Create**.
@@ -83,15 +88,14 @@ az resource show --ids "$RESOURCE_ID" --api-version 2020-06-10 -o table
8388
## 💡 Why Use Bing Search Grounding?
8489

8590
* Provides **real-time information** to enrich AI responses.
86-
* Helps LLMs answer with **up-to-date knowledge** beyond training data.
87-
* Useful for scenarios like **news, research, or dynamic data queries**.
91+
* Helps LLMs give answers with **up-to-date knowledge** beyond training data.
92+
* Useful for scenarios like **news, research, or dynamic queries**.
8893

8994
---
9095

9196
## 📚 Additional Resources
9297

93-
* [Use Bing Search grounding with Azure AI Foundry (official docs)](https://learn.microsoft.com/en-us/azure/ai-foundry/agents/how-to/tools/bing-code-samples?source=recommendations&pivots=portal)
94-
95-
```
98+
* [Grounding with Bing Search (overview)](https://learn.microsoft.com/en-us/azure/ai-foundry/agents/how-to/tools/bing-grounding) — Learn how the tool works, pricing, privacy notes, and how real-time search is integrated. ([Microsoft Learn][1])
99+
* [Grounding with Bing Search code samples](https://learn.microsoft.com/en-us/azure/ai-foundry/agents/how-to/tools/bing-code-samples?source=recommendations&pivots=portal) — SDK and REST examples for using Bing grounding. ([Microsoft Learn][2])
96100

97101
---

0 commit comments

Comments
 (0)