microsoft--agent-framework/dotnet/samples/02-agents/AgentProviders/foundry/README.md

Getting started with Foundry Agents

These samples demonstrate how to use Microsoft Foundry with Agent Framework.

Quick start

You can create a Foundry agent directly with the FoundryAgent type:

FoundryAgent agent = new(
    new Uri(endpoint),
    new DefaultAzureCredential(),
    model: "gpt-5.4-mini",
    instructions: "You are good at telling jokes.",
    name: "JokerAgent");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

Or using the AIProjectClient.AsAIAgent(...) extensions:

AIProjectClient aiProjectClient = new(new Uri(endpoint), new DefaultAzureCredential());

FoundryAgent agent = aiProjectClient.AsAIAgent(
    model: deploymentName,
    instructions: "You are good at telling jokes.",
    name: "JokerAgent");

Prerequisites

• .NET 10 SDK or later
• Foundry project endpoint
• An authenticated Azure identity (for example, sign in with az login)

Set:

$env:FOUNDRY_PROJECT_ENDPOINT="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project"
$env:FOUNDRY_MODEL="gpt-5.4-mini"

Some samples require extra tool-specific environment variables. See each sample for details.

Samples

Sample	Description
FoundryAgent lifecycle	Create a FoundryAgent directly with endpoint and credentials
Basics (Responses API)	Create and run an agent using AsAIAgent extensions
Multi-turn conversation	Multi-turn using sessions and response ID chaining
Multi-turn with server conversations	Server-side conversations visible in Foundry UI
Using function tools	Function tools
Function tools with approvals	Human-in-the-loop approval
Structured output	Structured output with JSON schema
Persisted conversations	Persisting and resuming conversations
Observability	OpenTelemetry observability
Dependency injection	DI with a hosted service
Using MCP client as tools	MCP client tools
Using images	Image multi-modality
Agent as function tool	Agent as a function tool for another
Middleware	Multiple middleware layers
Plugins	Plugins with dependency injection
Code interpreter	Code interpreter tool
Computer use	Computer use tool
File search	File search tool
OpenAPI tools	OpenAPI tools
Bing custom search	Bing Custom Search tool
SharePoint	SharePoint grounding tool
Microsoft Fabric	Microsoft Fabric tool
Web search	Web search tool
Memory search	Memory search tool
Local MCP	Local MCP client with HTTP transport
Code interpreter file download	Download container files generated by code interpreter
Foundry toolbox via MCP	Use a Foundry Toolbox from a non-hosted agent via its MCP endpoint
Foundry toolbox MCP skills	Use a Foundry Toolbox with MCP-based skills discovery (SEP-2640) via AIContextProviders

Running the samples

Use the basics sample for a quick smoke test:

cd dotnet/samples/02-agents/AgentProviders/foundry
dotnet run --project .\Agent_Step01_Basics

If you want to exercise the full create-run-delete lifecycle, run Agent_Step00_FoundryAgentLifecycle.