AgentFrameworkToolkit 1.0.0-preview.251222.1

AgentFramework Toolkit

An opinionated C# Toolkit for Microsoft Agent Framework that makes life easier

NuGet

OpenAI | Azure OpenAI | Google (Gemini) | Anthropic (Claude) | XAI (Grok) | Mistral | OpenRouter | GitHub

Examples of use

All agents have AIAgent as base, fully work the rest of Microsoft Agent Framework)

OpenAI

OpenAIAgentFactory factory = new OpenAIAgentFactory(new OpenAIConnection
{
    ApiKey = configuration.OpenAiApiKey,
    NetworkTimeout = TimeSpan.FromMinutes(5)
});

OpenAIAgent agent = factory.CreateAgent(new AgentOptions
{
    Model = "gpt-5",
    ReasoningEffort = OpenAIReasoningEffort.High,
    ReasoningSummaryVerbosity = OpenAIReasoningSummaryVerbosity.Concise,    
});

Google

GoogleAgentFactory factory = new(new GoogleConnection
{
    ApiKey = configuration.GoogleGeminiApiKey
});

GoogleAgent agent = factory.CreateAgent(new GoogleAgentOptions
{
    Model = GenerativeAI.GoogleAIModels.Gemini25Pro,
    Tools = [AIFunctionFactory.Create(GetWeather)]
});

Anthropic

AnthropicAgentFactory factory = new AnthropicAgentFactory("<AnthropicApiKey">);

factory.CreateAgent(new AnthropicAgentOptions
{
    Model = "claude-sonnet-4-5",
    MaxOutputTokens = 10000, // <-- Force the MaxToken property I always forget
    BudgetTokens = 5000
});

X AI

XAIAgentFactory factory = new(new XAIConnection
{
    ApiKey = configuration.XAiGrokApiKey
});

XAIAgent agent = factory.CreateAgent(new AgentOptions
{
    Model = "grok-4-fast-non-reasoning",
    Tools = [AIFunctionFactory.Create(GetWeather)]
});

Mistral

MistralAgentFactory mistralAgentFactory = new MistralAgentFactory("<MistralApiKey>");
MistralAgent mistralAgent = mistralAgentFactory.CreateAgent(new MistralAgentOptions
{
    Model = Mistral.SDK.ModelDefinitions.MistralSmall
});

Azure AI (with every optional setting added for demonstration)

AzureOpenAIAgent fullBlownAgent = azureOpenAIAgentFactory.CreateAgent(new AgentOptions
{
    Id = "1234",
    Name = "MyAgent",
    Description = "The description of my agent",
    Instructions = "Speak like a pirate",
    Model = "gpt-5-mini",
    ReasoningEffort = OpenAIReasoningEffort.High,
    ReasoningSummaryVerbosity = OpenAIReasoningSummaryVerbosity.Concise,  
    Tools = [AIFunctionFactory.Create(GetWeather)],
    RawToolCallDetails = details => { Console.WriteLine(details.ToString()); },
    RawHttpCallDetails = details =>
    {
        Console.WriteLine($"URL: {details.RequestUrl}");
        Console.WriteLine($"Request: {details.RequestJson}");
        Console.WriteLine($"Response: {details.ResponseJson}");
    }
});

Repository layout

• src/ – Core libraries and tests (packages live under src/*, tests in src/AgentFrameworkToolkit.Tests).
• examples/Samples – Console sample app with per-provider examples.
• tools/AppHost – Aspire host to orchestrate DevUI and service defaults in dev.
• tools/DevUI – Web UI to try all agents with your own keys.
• tools/ServiceDefaults – Shared dev infra (health checks, telemetry defaults).

Contributing: See CONTRIBUTING.md for build instructions and development guidelines.