Visitar URL original
.NET: Add Foundry Agents Tool Sample - Web Search by rogerbarreto · Pull Request #4040 · microsoft/agent-framework · GitHub
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

@rogerbarreto Roger 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 sample microsoft#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>
Copilot AI review requested due to automatic review settings February 18, 2026 17:28
@rogerbarreto Roger 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
Copilot AI reviewed Feb 18, 2026
View reviewed changes

Copilot AI 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.

File Description
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/README.md Documents purpose, prerequisites, env vars, and execution steps for the web search sample.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs Implements agent creation (web search enabled), execution, citation extraction, and cleanup.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/FoundryAgents_Step25_WebSearch.csproj New sample project definition and dependencies.

Comment thread dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs Resolved
Comment thread dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs Resolved
Comment thread ...ngStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/FoundryAgents_Step25_WebSearch.csproj Resolved
Comment thread dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/README.md Resolved
@rogerbarreto
Fix README to align DefaultAzureCredential docs with code
e800d8a 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
westey-m
westey (westey-m) reviewed Feb 18, 2026
View reviewed changes
Comment thread ...ngStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/FoundryAgents_Step25_WebSearch.csproj Resolved
westey-m
westey (westey-m) reviewed Feb 18, 2026
View reviewed changes
Comment thread dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step25_WebSearch/Program.cs Resolved
@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>
@rogerbarreto
Roger Barreto (rogerbarreto) added this pull request to the merge queue Feb 23, 2026
@dependabot dependabot Bot 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
@dependabot dependabot Bot mentioned this pull request Jun 24, 2026
Closed
@dependabot dependabot Bot mentioned this pull request Jul 15, 2026
Open

This branch was previously deployed

1 inactive deployment
integration — cc544a0e Deployed Feb 23, 2026 by rogerbarreto via dotnet-build-and-test (net472, windows-latest, Release, true, integration) #12763
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

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

Assignees

No one assigned

Labels

documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs .NET Usage: [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