Skip to content

.NET: Add Foundry Agents Tool Sample - Web Search - #4040

Merged
Roger Barreto (rogerbarreto) merged 7 commits into
microsoft:mainfrom
rogerbarreto:feature/3674-web-search
Feb 23, 2026
Merged

.NET: Add Foundry Agents Tool Sample - Web Search#4040
Roger Barreto (rogerbarreto) merged 7 commits into
microsoft:mainfrom
rogerbarreto:feature/3674-web-search

Conversation

@rogerbarreto

@rogerbarretoRoger Barreto (rogerbarreto) commented Feb 18, 2026

Copy link
Copy Markdown
Member

Motivation and Context

Adds a new FoundryAgents_Step25_WebSearch sample demonstrating how to use the Responses API built-in web search tool with AI Agents.

Description

  • Create agents with web search capabilities using two approaches:
    • Option 1: HostedWebSearchTool (MEAI + AgentFramework abstraction)
    • Option 2: ResponseTool.CreateWebSearchTool() (Native SDK / Responses API)
  • Extract text responses and URL citations from agent responses
  • Manage agent lifecycle (create and cleanup)

Note: The web search tool uses the built-in Responses API web search capability. No Bing Grounding connection is required.

Changes

  • New sample: FoundryAgents_Step25_WebSearch with Program.cs and README.md

Contribution Checklist

  • The code builds clean without any errors or warnings
  • The PR follows the Contribution Guidelines
  • All unit tests pass, and I have added new tests where possible
  • Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

@rogerbarreto
.NET: Add Web Search samplemicrosoft#3674
4949bc6
@rogerbarreto
.NET: Fix WebSearch sample to use Responses API built-in web search
ab64a21
Remove incorrect Bing Grounding connection ID requirement from the
WebSearch sample. The web search tool uses the OpenAI Responses API
built-in capability and does not need a connection ID.
- Remove AZURE_FOUNDRY_BING_CONNECTION_ID env var requirement
- Use HostedWebSearchTool() without connectionId properties
- Refactor creation options into local functions (MEAI + NativeSDK)
- Switch from AzureCliCredential to DefaultAzureCredential
- Update README to reflect correct prerequisites
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
CopilotAI review requested due to automatic review settings February 18, 2026 17:28
@rogerbarretoRoger Barreto (rogerbarreto) added documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs .NET Usage: [Issues, PRs], Target: .Net labels Feb 18, 2026
CopilotAI reviewed Feb 18, 2026
View reviewed changes

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new .NET GettingStarted FoundryAgents_Step25_WebSearch sample demonstrating how to enable the Responses API built-in web search tool on Foundry Agents, run a query, and extract text + URL citation annotations.

Changes:

  • New console sample project (net10.0) that creates a Foundry agent with web search tooling (MEAI hosted tool, with a native SDK option shown).
  • Adds output processing to print text responses and URL citation annotations.
  • Adds a README with prerequisites and run instructions for the new step.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

FileDescription
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/README.mdDocuments purpose, prerequisites, env vars, and execution steps for the web search sample.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.csImplements agent creation (web search enabled), execution, citation extraction, and cleanup.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/FoundryAgents_Step25_WebSearch.csprojNew sample project definition and dependencies.

Comment threaddotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs
Comment threaddotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs
Comment thread...ngStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/FoundryAgents_Step25_WebSearch.csproj
Comment threaddotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/README.md Outdated
@rogerbarreto
Fix README to align DefaultAzureCredential docs with code
e800d8a
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@rogerbarreto
Address review: add project to solution, README, simplify response text
984b92e
- Add FoundryAgents_Step25_WebSearch to agent-framework-dotnet.slnx
- Add web search sample entry to parent FoundryAgents README.md
- Simplify text response extraction to use response.Text directly
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@rogerbarreto
Merge branch 'main' into feature/3674-web-search
6ba0736
@rogerbarreto
Fix merge conflict in slnx solution file
cc544a0
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@dependabotdependabotBot mentioned this pull request Apr 6, 2026
Closed
This was referenced Apr 13, 2026
Closed
Closed
Closed
This was referenced Apr 20, 2026
Closed
Closed
Merged
This was referenced Apr 28, 2026
Closed
Closed
This was referenced May 6, 2026
Closed
Closed
Closed
Closed
Closed
Closed
Closed
Closed
This was referenced May 15, 2026
Closed
Closed
Closed
Closed
This was referenced May 22, 2026
Closed
Open
This was referenced May 29, 2026
Closed
Closed
This was referenced Jun 6, 2026
Closed
Closed
Closed
@dependabotdependabotBot mentioned this pull request Jun 24, 2026
Closed
@dependabotdependabotBot mentioned this pull request Jul 15, 2026
Open
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code reviewCopilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@SergeyMenshykhSergeyMenshykhSergeyMenshykh approved these changes
@westey-mwestey (westey-m)westey-m approved these changes

Assignees

No one assigned

Labels

documentationUsage: [Issues, PRs], Target: documentation in the code base and learn docs.NETUsage: [Issues, PRs], Target: .Net

Projects

Agent Framework
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@rogerbarreto@SergeyMenshykh@westey-m