agent/agent-framework
2
0
Fork 0
mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
e730fc1c2eeceb1b106c1c3fcda94de24ce64150
agent-framework/dotnet/samples/05-end-to-end/HostedAgents/AgentWithHostedMCP
T
Roger Barreto de791fb8a9 .Net: Add additional Hosted Agent Samples (#4325) 
* Add 3 new hosted agent samples: AgentWithTools, AgentWithLocalTools, AgentThreadAndHITL

- AgentWithTools: Foundry tools (MCP + code interpreter) via UseFoundryTools
- AgentWithLocalTools: Local C# function tool (Seattle hotel search) with AIProjectClient
- AgentThreadAndHITL: Human-in-the-loop with ApprovalRequiredAIFunction and thread persistence

All samples follow agent-framework conventions (net10.0, AzureCliCredential, CPM disabled).
AgentWithTools includes comprehensive README with setup guide and troubleshooting.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add root HostedAgents README, replace test_requests.py with .http, update sample READMEs

- Create root README.md with shared prerequisites, Azure AI Foundry setup,
  troubleshooting, and samples index
- Replace test_requests.py with run-requests.http in AgentThreadAndHITL
- Add pointer to root README in all 6 sample READMEs
- Trim AgentWithTools README to concise style

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix dotnet format issues in AgentWithLocalTools/Program.cs

- Add UTF-8 BOM (CHARSET)
- Sort System.ClientModel.Primitives import alphabetically (IMPORTS)
- Use target-typed new for AIProjectClient (IDE0090)
- Add internal accessibility modifier to Hotel record (IDE0040)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review: align model names and package versions

- Change default model from gpt-4.1-mini to gpt-4o-mini in AgentWithLocalTools
  (Program.cs, agent.yaml, README.md) to match existing samples
- Change README example from gpt-5.2 to gpt-4o-mini in AgentWithTools and root README
- Align AgentWithLocalTools package versions with other samples:
  Azure.AI.AgentServer.AgentFramework beta.6 -> beta.8
  Azure.AI.OpenAI 2.8.0-beta.1 -> 2.7.0-beta.2
  Microsoft.Extensions.AI.OpenAI 10.2.0-preview -> 10.1.1-preview

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Upgrade new samples to latest package versions

- Azure.AI.OpenAI: 2.7.0-beta.2 -> 2.8.0-beta.1
- Microsoft.Extensions.AI.OpenAI: 10.1.1-preview -> 10.3.0

Aligns with AgentWithHostedMCP which uses the latest versions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Pin AgentThreadAndHITL to Microsoft.Extensions.AI.OpenAI 10.1.1

Azure.AI.AgentServer.AgentFramework beta.8 was compiled against
Microsoft.Extensions.AI.Abstractions with the single-param
FunctionApprovalRequestContent.CreateResponse(bool). Version 10.3.0
changed the signature to include an optional reason parameter, causing
a binary incompatibility at runtime. Pin to 10.1.1 until the framework
is recompiled against the newer abstractions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
de791fb8a9 · 2026-03-02 10:56:28 +00:00
History
..
agent.yaml
Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
2026-02-26 00:56:10 +00:00
AgentWithHostedMCP.csproj
Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
2026-02-26 00:56:10 +00:00
Dockerfile
Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
2026-02-26 00:56:10 +00:00
Program.cs
Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
2026-02-26 00:56:10 +00:00
README.md
.Net: Add additional Hosted Agent Samples (#4325)
2026-03-02 10:56:28 +00:00
run-requests.http
Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
2026-02-26 00:56:10 +00:00

README.md

What this sample demonstrates

This sample demonstrates how to use a Hosted Model Context Protocol (MCP) server with an AI agent. The agent connects to the Microsoft Learn MCP server to search documentation and answer questions using official Microsoft content.

Key features:

  • Configuring MCP tools with automatic approval (no user confirmation required)
  • Filtering available tools from an MCP server
  • Using Azure OpenAI Responses with MCP tools

For common prerequisites and setup instructions, see the Hosted Agent Samples README.

Prerequisites

Before running this sample, ensure you have:

  1. An Azure OpenAI endpoint configured
  2. A deployment of a chat model (e.g., gpt-4o-mini)
  3. Azure CLI installed and authenticated

Note: This sample uses Azure CLI credentials for authentication. Make sure you're logged in with az login and have access to the Azure OpenAI resource.

Environment Variables

Set the following environment variables:

# Replace with your Azure OpenAI endpoint
$env:AZURE_OPENAI_ENDPOINT="https://your-openai-resource.openai.azure.com/"

# Optional, defaults to gpt-4o-mini
$env:AZURE_OPENAI_DEPLOYMENT_NAME="gpt-4o-mini"

How It Works

The sample connects to the Microsoft Learn MCP server and uses its documentation search capabilities:

  1. The agent is configured with a HostedMcpServerTool pointing to https://learn.microsoft.com/api/mcp
  2. Only the microsoft_docs_search tool is enabled from the available MCP tools
  3. Approval mode is set to NeverRequire, allowing automatic tool execution
  4. When you ask questions, Azure OpenAI Responses automatically invokes the MCP tool to search documentation
  5. The agent returns answers based on the Microsoft Learn content

In this configuration, the OpenAI Responses service manages tool invocation directly - the Agent Framework does not handle MCP tool calls.

Reference in New Issue View Git Blame Copy Permalink