Get Started with Microsoft Agent Framework for C# Developers

Quickstart

Basic Agent - .NET

using System.ClientModel.Primitives;
using Azure.Identity;
using Microsoft.Agents.AI;
using OpenAI;
using OpenAI.Responses;

// Use the Azure OpenAI v1 route with the OpenAI SDK (resource root + /openai/v1).
var endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")!; // e.g. https://YOUR.openai.azure.com/openai/v1/
var deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")!;

var agent = new OpenAIClient(
        new BearerTokenPolicy(new AzureCliCredential(), "https://ai.azure.com/.default"),
        new OpenAIClientOptions { Endpoint = new Uri(endpoint) })
    .GetResponsesClient()
    .AsAIAgent(model: deploymentName, name: "HaikuBot", instructions: "You are an upbeat assistant that writes beautifully.");

Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Framework."));

Examples & Samples

• Getting Started with Agents: basic agent creation and tool usage
• Agent Provider Samples: samples showing different agent providers
• Workflow Samples: advanced multi-agent patterns and workflow orchestration

Agent Framework Documentation

• Documentation
• Agent Framework Repository
• Design Documents
• Architectural Decision Records
• MSFT Learn Docs