ai-agents-for-beginners

ЁЯМН Microsoft Agent Framework (.NET) роЙроЯройрпН AI рокропрог роорпБроХро╡ро░рпН

ЁЯУЛ роХро╛роЯрпНроЪро┐ ро╡ро┤ро┐роХро╛роЯрпНроЯро┐

роЗроирпНрод роЙродро╛ро░рогроорпН Microsoft Agent Framework роР рокропройрпНрокроЯрпБродрпНродро┐ рокрпБродрпНродро┐роЪро╛ро▓ро┐ рокропрогродрпН родро┐роЯрпНроЯ роорпБроХро╡ро░рпИ .NET роЗро▓рпН роОрокрпНрокроЯро┐ роЙро░рпБро╡ро╛роХрпНроХрпБро╡родрпБ роОройрпНрокродрпИ роХро╛роЯрпНроЯрпБроХро┐ро▒родрпБ. роорпБроХро╡ройрпН роЙро▓роХроорпЖроЩрпНроХрпБроорпН рокрпБро▒рокрпНрокроЯроХрпНроХрпВроЯро┐роп роЗроЯроЩрпНроХро│рпБроХрпНроХрпБ родройро┐рокрпНрокроЯрпНроЯ роиро╛ро│рпН-рокропрогроорпН родро┐роЯрпНроЯроЩрпНроХро│рпИ родро╛ройро╛роХ роЙро░рпБро╡ро╛роХрпНроХ роорпБроЯро┐ропрпБроорпН.

роорпБроХрпНроХро┐роп родро┐ро▒ройрпНроХро│рпН:

ЁЯФз родрпКро┤ро┐ро▓рпНроирпБроЯрпНрок роХроЯрпНроЯроорпИрокрпНрокрпБ

роорпИроп родрпКро┤ро┐ро▓рпНроирпБроЯрпНрокроЩрпНроХро│рпН

роорпБроХрпНроХро┐роп роХрпВро▒рпБроХро│рпН

  1. AIAgent: роЙро░рпИропро╛роЯро▓рпН роУроЯрпНроЯродрпНродрпИ роХрпИропро╛ро│рпБроорпН рокро┐ро░родро╛рой роорпБроХро╡ро░рпН роТро░рпБроЩрпНроХро┐рогрпИрокрпНрокро╛ро│ро░рпН
  2. родройро┐рокрпНрокропройрпН роХро░рпБро╡ро┐роХро│рпН: роорпБроХро╡ро░рпБроХрпНроХрпБ роХро┐роЯрпИроХрпНроХроХрпНроХрпВроЯро┐роп GetRandomDestination() роЪрпЖропро▓рпНрокро╛роЯрпБ
  3. рокродро┐ро▓ро│ро┐рокрпНрокрпБ роХро┐ро│рпИропрогрпНроЯрпН: Azure OpenAI Responses роЕроЯро┐рокрпНрокроЯрпИропро┐ро▓ро╛рой роЙро░рпИропро╛роЯро▓рпН роЗроЯрпИроорпБроХроорпН
  4. ро╕рпНроЯрпНро░рпАрооро┐роЩрпН роЖродро░ро╡рпБ: роирпЗро░роЯро┐ рокродро┐ро▓ро│ро┐рокрпНрокрпБ роЙро░рпБро╡ро╛роХрпНроХроХрпН роХрпБро▒рпИроирпНрод

роЗрогрпИрокрпНрокрпБ рооро╛родро┐ро░ро┐

graph LR
    A[рокропройро░рпН роХрпЛро░ро┐роХрпНроХрпИ] --> B[AI роорпБроХро╡ро░рпН]
    B --> C[роЖроЬрпВро░рпН OpenAI (рокродро┐ро▓рпН API)]
    B --> D[GetRandomDestination роХро░рпБро╡ро┐]
    C --> E[рокропрог родро┐роЯрпНроЯроорпН]
    D --> E

ЁЯЪА родрпКроЯроХрпНроХ ро╡ро┤ро┐роХро╛роЯрпНроЯро┐

родрпЗро╡рпИропро╛рой роорпБройрпН роиро┐рокроирпНродройрпИроХро│рпН

родрпЗро╡рпИропро╛рой роЪрпВро┤ро▓рпН рооро╛ро▒ро┐роХро│рпН

# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-5-mini
# рокро┐ро▒роХрпБ роЙро│рпНроирпБро┤рпИропро╡рпБроорпН рддрд╛рдХрд┐ AzureCliCredential роТро░рпБ роЯрпЛроХрпНроХройрпИрокрпН рокрпЖро▒ роорпБроЯро┐ропрпБроорпН
az login

# рокро╡ро░рпН ро╖рпЖро▓рпН
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-5-mini"
# рокро┐ройрпНройро░рпН AzureCliCredential роЯрпЛроХрпНроХройрпН рокрпЖро▒ роЪрпИройрпН роЗройрпН роЪрпЖропрпНропро╡рпБроорпН
az login

рооро╛родро┐ро░ро┐ роХрпЛроЯрпБ

роХрпЛроЯрпБ роЙродро╛ро░рогродрпНродрпИ роЗропроХрпНроХ,

# zsh/bash
chmod +x ./01-dotnet-agent-framework.cs
./01-dotnet-agent-framework.cs

роЕро▓рпНро▓родрпБ dotnet CLI роРрокрпН рокропройрпНрокроЯрпБродрпНродро┐:

dotnet run ./01-dotnet-agent-framework.cs

роорпБро┤рпБ роХрпЛрокрпНрокрпБроХрпНроХро╛рой роХрпБро▒ро┐ропрпАроЯрпБ 01-dotnet-agent-framework.cs роР рокро╛ро░рпБроЩрпНроХро│рпН.

#!/usr/bin/dotnet run

#:package Microsoft.Extensions.AI@10.4.1
#:package Microsoft.Agents.AI.OpenAI@1.1.0
#:package Azure.AI.OpenAI@2.1.0
#:package Azure.Identity@1.13.1

using System.ComponentModel;

using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

using Azure.AI.OpenAI;
using Azure.Identity;

// Tool Function: Random Destination Generator
// This static method will be available to the agent as a callable tool
// The [Description] attribute helps the AI understand when to use this function
// This demonstrates how to create custom tools for AI agents
[Description("Provides a random vacation destination.")]
static string GetRandomDestination()
{
    // List of popular vacation destinations around the world
    // The agent will randomly select from these options
    var destinations = new List<string>
    {
        "Paris, France",
        "Tokyo, Japan",
        "New York City, USA",
        "Sydney, Australia",
        "Rome, Italy",
        "Barcelona, Spain",
        "Cape Town, South Africa",
        "Rio de Janeiro, Brazil",
        "Bangkok, Thailand",
        "Vancouver, Canada"
    };

    // Generate random index and return selected destination
    // Uses System.Random for simple random selection
    var random = new Random();
    int index = random.Next(destinations.Count);
    return destinations[index];
}

// Azure OpenAI with the Responses API (stable v1 endpoint). Sign in with `az login`.
var azureEndpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
var deployment = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT") ?? "gpt-5-mini";

var azureClient = new AzureOpenAIClient(new Uri(azureEndpoint), new AzureCliCredential());

// Create AI Agent with Travel Planning Capabilities
// Get the Responses client for the specified deployment and create the AI agent
// Configure agent with travel planning instructions and random destination tool
// The agent can now plan trips using the GetRandomDestination function
AIAgent agent = azureClient
    .GetChatClient(deployment)
    .AsAIAgent(
        instructions: "You are a helpful AI Agent that can help plan vacations for customers at random destinations",
        tools: [AIFunctionFactory.Create(GetRandomDestination)]
    );

// Execute Agent: Plan a Day Trip
// Run the agent with streaming enabled for real-time response display
// Shows the agent's thinking and response as it generates the content
// Provides better user experience with immediate feedback
await foreach (var update in agent.RunStreamingAsync("Plan me a day trip"))
{
    await Task.Delay(10);
    Console.Write(update);
}

ЁЯОУ роорпБроХрпНроХро┐роп роОроЯрпБродрпНродрпБроХрпНроХро╛роЯрпНроЯрпБроХрпНроХро│рпН

  1. роорпБроХро╡ро░рпН роХроЯрпНроЯроорпИрокрпНрокрпБ: Microsoft Agent Framework .NET роЗро▓рпН AI роорпБроХро╡ро░рпНроХро│рпИ роЙро░рпБро╡ро╛роХрпНроХ роЪрпБродрпНродрооро╛рой, ро╡роХрпИ-рокро╛родрпБроХро╛рокрпНрокро╛рой роЕрогрпБроХрпБроорпБро▒рпИропрпИ ро╡ро┤роЩрпНроХрпБроХро┐ро▒родрпБ
  2. роХро░рпБро╡ро┐ роЗрогрпИро╡рпБ: [Description] рокрогрпНрокрпБ роХрпКрогрпНроЯ роЪрпЖропро▓рпНрокро╛роЯрпБроХро│рпН роорпБроХро╡ро░рпБроХрпНроХрпБ роХро┐роЯрпИроХрпНроХрпБроорпН роХро░рпБро╡ро┐роХро│ро╛роХ рооро╛ро▒рпБроХро┐ройрпНро▒рой
  3. роХроЯрпНроЯроорпИрокрпНрокрпБ роорпЗро▓ро╛рогрпНроорпИ: роЪрпВро┤ро▓рпН рооро╛ро▒ро┐роХро│рпН рооро▒рпНро▒рпБроорпН рокро╛родрпБроХро╛рокрпНрокро╛рой роХроЯро╡рпБроЪрпНроЪрпКро▓рпН роХрпИропро╛ро│рпБродро▓рпН .NET роЪро┐ро▒роирпНрод роироЯрпИроорпБро▒рпИроХро│рпИ рокро┐ройрпНрокро▒рпНро▒рпБроХро┐ро▒родрпБ
  4. Azure OpenAI Responses API: роорпБроХро╡ро░рпН Azure.AI.OpenAI SDK роорпВро▓рооро╛роХ Azure OpenAI Responses API роР рокропройрпНрокроЯрпБродрпНродрпБроХро┐ро▒родрпБ

ЁЯФЧ роХрпВроЯрпБродро▓рпН ро╡ро│роЩрпНроХро│рпН

рооро▒рпБрокрпНрокрпБ: роЗроирпНрод роЖро╡рогроорпН AI роорпКро┤ро┐рокрпЖропро░рпНрокрпНрокрпБ роЪрпЗро╡рпИ Co-op Translator рокропройрпНрокроЯрпБродрпНродро┐ роорпКро┤ро┐рокрпЖропро░рпНроХрпНроХрокрпНрокроЯрпНроЯрпБро│рпНро│родрпБ. роиро╛роЩрпНроХро│рпН родрпБро▓рпНро▓ро┐ропродрпНродро┐ро▒рпНроХро╛роХ роорпБропро▒рпНроЪро┐ роЪрпЖропрпНродрпБро│рпНро│рпЛроорпН, роЖройро╛ро▓рпН родро╛ройро╛роХ роЪрпЖропрпНропрокрпНрокроЯрпБроорпН роорпКро┤ро┐рокрпЖропро░рпНрокрпНрокрпБроХро│ро┐ро▓рпН рокро┐ро┤рпИроХро│рпН роЕро▓рпНро▓родрпБ родро╡ро▒рпБроХро│рпН роЗро░рпБроХрпНроХро▓ро╛роорпН роОройрпНрокродрпИ роХро╡ройродрпНродро┐ро▓рпН роХрпКро│рпНро│ро╡рпБроорпН. роЕроЪро▓рпН роЖро╡рогроорпН роЕродройрпН родро╛ропрпНроорпКро┤ро┐ропро┐ро▓рпН роЕродро┐роХро╛ро░рокрпНрокрпВро░рпНро╡ роЖродро╛ро░рооро╛роХ роХро░рпБродрокрпНрокроЯ ро╡рпЗрогрпНроЯрпБроорпН. роорпБроХрпНроХро┐ропрооро╛рой родроХро╡ро▓рпНроХро│рпБроХрпНроХрпБ, родрпКро┤ро┐ро▓рпНроирпБроЯрпНрокрооро╛рой рооройро┐род роорпКро┤ро┐рокрпЖропро░рпНрокрпНрокрпБ рокро░ро┐роирпНродрпБро░рпИроХрпНроХрокрпНрокроЯрпБроХро┐ро▒родрпБ. роЗроирпНрод роорпКро┤ро┐рокрпЖропро░рпНрокрпНрокрпИрокрпН рокропройрпНрокроЯрпБродрпНродрпБро╡родро╛ро▓рпН роПро▒рпНрокроЯрпБроорпН роОроирпНрод родро╡ро▒ро╛рой рокрпБро░ро┐родро▓рпНроХро│рпН роЕро▓рпНро▓родрпБ родро╡ро▒ро╛рой ро╡ро┐ро│роХрпНроХродрпНродро┐ро▒рпНроХрпБроорпН роиро╛роЩрпНроХро│рпН рокрпКро▒рпБрокрпНрокро┐ро▓рпНро╡ро┐ро▓рпНро▓рпИ.

This site is open source. Improve this page.