Skip to content

Commit 5ddeba6

Browse files
lindazqliCopilot
andauthored
Add warning for Web Search tool usage (#45270)
* Add warning for Web Search tool usage Added warning about costs and terms for Web Search tool usage. * Include warning for Bing Custom Search tool usage Added a warning about costs and data flow for Bing Custom Search. * Add warning for Bing Search tool grounding Added warning about costs and terms for Bing Search tool usage. * Add warning for Web Search usage and compliance Added a warning about costs and data flow for Web Search. * Include warning for Web Search tool usage Added warning about costs and compliance for Web Search. * Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Refactor warning message in sample_agent_bing_custom_search.py Updated warning message formatting and links for clarity. * Update warning message in sample_agent_bing_grounding.py Reformatted warning message for clarity and added links. * Improve formatting of Web Search warning message Reformatted warning message for clarity and readability. * Improve formatting of Web Search warning message Reformatted warning message for clarity and readability. * Update README.md * Fix Bing tools documentation link Updated the Bing tools documentation link to remove the version view parameter. * Update Bing tools documentation link * Fix web search documentation link Updated the web search documentation link to the correct format. * Fix documentation link in sample_agent_web_search_preview.py Updated the URL for the web search documentation. * Update warnings for Web Search and Bing tools --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent b966840 commit 5ddeba6

6 files changed

Lines changed: 56 additions & 0 deletions

File tree

sdk/ai/azure-ai-projects/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -312,6 +312,9 @@ See the full sample in file `\agents\tools\sample_agent_image_generation.py` in
312312

313313
Discover up-to-date web content with the GA Web Search tool or try the Web Search Preview tool for the latest enhancements. Guidance on when to use each option is in the documentation: https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-overview?view=foundry#determine-the-best-tool-for-your-use-cases.
314314

315+
Warning:
316+
Web Search tool uses Grounding with Bing, which has additional costs and terms: [terms of use](https://www.microsoft.com/bing/apis/grounding-legal-enterprise) and [privacy statement](https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409). Customer data will flow outside the Azure compliance boundary. Learn more [here](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-search).
317+
315318
<!-- SNIPPET:sample_agent_web_search.tool_declaration -->
316319

317320
```python
@@ -535,6 +538,8 @@ See the full sample in file `\agents\tools\sample_agent_ai_search.py` in the [Sa
535538

536539
**Bing Grounding**
537540

541+
Warning: Grounding with Bing Search tool uses Grounding with Bing, which has additional costs and terms: [terms of use](https://www.microsoft.com/bing/apis/grounding-legal-enterprise) and [privacy statement](https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409). Customer data will flow outside the Azure compliance boundary. Learn more [here](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/bing-tools).
542+
538543
Ground agent responses with real-time web search results from Bing to provide up-to-date information:
539544

540545
<!-- SNIPPET:sample_agent_bing_grounding.tool_declaration -->
@@ -554,6 +559,7 @@ tool = BingGroundingTool(
554559
See the full sample in file `\agents\tools\sample_agent_bing_grounding.py` in the [Samples][samples] folder.
555560

556561
**Bing Custom Search**
562+
Warning: Grounding with Bing Custom Search tool uses Grounding with Bing, which has additional costs and terms: [terms of use](https://www.microsoft.com/bing/apis/grounding-legal-enterprise) and [privacy statement](https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409). Customer data will flow outside the Azure compliance boundary. Learn more [here](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-search).
557563

558564
Use custom-configured Bing search instances for domain-specific or filtered web search results:
559565

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_bing_custom_search.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@
44
# ------------------------------------
55

66
"""
7+
WARNING:
8+
Grounding with Bing Custom Search tool uses Grounding with Bing, which has additional costs and terms.
9+
Terms of use:
10+
https://www.microsoft.com/bing/apis/grounding-legal-enterprise
11+
Privacy statement:
12+
https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409
13+
Customer data will flow outside the Azure compliance boundary.
14+
Learn more:
15+
https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/bing-tools
16+
717
DESCRIPTION:
818
This sample demonstrates how to create an AI agent with Bing Custom Search capabilities
919
using the BingCustomSearchPreviewTool and synchronous Azure AI Projects client. The agent can search

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_bing_grounding.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,16 @@
55
# ------------------------------------
66

77
"""
8+
WARNING:
9+
Grounding with Bing Search tool uses Grounding with Bing, which has additional costs and terms.
10+
Terms of use:
11+
https://www.microsoft.com/bing/apis/grounding-legal-enterprise
12+
Privacy statement:
13+
https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409
14+
Customer data will flow outside the Azure compliance boundary.
15+
Learn more:
16+
https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/bing-tools
17+
818
DESCRIPTION:
919
This sample demonstrates how to create an AI agent with Bing grounding capabilities
1020
using the BingGroundingTool and synchronous Azure AI Projects client. The agent can search

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_web_search.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@
44
# ------------------------------------
55

66
"""
7+
WARNING:
8+
Web Search uses Grounding with Bing, which has additional costs and terms.
9+
Terms of use:
10+
https://www.microsoft.com/bing/apis/grounding-legal-enterprise
11+
Privacy statement:
12+
https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409
13+
Customer data will flow outside the Azure compliance boundary.
14+
Learn more:
15+
https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-search
16+
717
DESCRIPTION:
818
This sample demonstrates how to run Prompt Agent operations
919
using the Web Search Tool and a synchronous client.

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_web_search_preview.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@
44
# ------------------------------------
55

66
"""
7+
WARNING:
8+
Web Search uses Grounding with Bing, which has additional costs and terms.
9+
Terms of use:
10+
https://www.microsoft.com/bing/apis/grounding-legal-enterprise
11+
Privacy statement:
12+
https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409
13+
Customer data will flow outside the Azure compliance boundary.
14+
Learn more:
15+
https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/web-search
16+
717
DESCRIPTION:
818
This sample demonstrates how to run Prompt Agent operations
919
using the Web Search Preview Tool and a synchronous client.

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_web_search_with_custom_search.py

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@
44
# ------------------------------------
55

66
"""
7+
WARNING:
8+
Web Search uses Grounding with Bing, which has additional costs and terms.
9+
Terms of use:
10+
https://www.microsoft.com/bing/apis/grounding-legal-enterprise
11+
Privacy statement:
12+
https://go.microsoft.com/fwlink/?LinkId=521839&clcid=0x409
13+
Customer data will flow outside the Azure compliance boundary.
14+
Learn more:
15+
https://learn.microsoft.com/en-us/azure/ai-foundry/agents/how-to/tools/web-search?view=foundry
16+
717
DESCRIPTION:
818
Demonstrates Prompt Agent operations that use the Web Search Tool configured
919
with a Bing Custom Search connection. The agent runs synchronously and

0 commit comments

Comments
 (0)