ai-agents-for-beginners

๐ŸŒ Microsoft Agent Framework (.NET) เด‰เดชเดฏเต‹เด—เดฟเดšเตเดšเต AI เดŸเตเดŸเตเดฐเดพเดตเตฝ เดเดœเดจเตเดฑเต

๐Ÿ“‹ เดธเดฟเดจเดพเดฑเดฟเดฏเต‹ เด…เดตเดฒเต‹เด•เดจเด‚

.NET เดฏเดฟเดฒเต† Microsoft Agent Framework เด‰เดชเดฏเต‹เด—เดฟเดšเตเดšเต เดฌเตเดฆเตเดงเดฟเดฎเตเดŸเตเดŸเตเดณเตเดณ เดŸเตเดฐเดพเดตเตฝ เดชเตเดฒเดพเดจเดฟเด‚เด—เต เดเดœเดจเตเดฑเต เดŽเด™เตเด™เดจเต† เดจเดฟเตผเดฎเตเดฎเดฟเด•เตเด•เดพเดฎเต†เดจเตเดจเต เดˆ เด‰เดฆเดพเดนเดฐเดฃเด‚ เด•เดพเดŸเตเดŸเตเดจเตเดจเต. เดเดœเดจเตเดฑเต เดฒเต‹เด•เดฎเต†เดฎเตเดชเดพเดŸเตเดฎเตเดณเตเดณ เดฏเดพเดฆเตƒเดšเตเด›เดฟเด• เดฒเด•เตเดทเตเดฏเดธเตเดฅเดพเดจเด™เตเด™เตพเด•เตเด•เดพเดฏเดฟ เดตเตเดฏเด•เตเดคเดฟเด—เดค เดฆเดฟเดจเดธเดžเตเดšเดพเดฐ เดฏเดพเดคเตเดฐเดพเดชเตเดฐเดตเตƒเดคเตเดคเดฟ เดธเตเดตเดฏเด‚ เดธเตƒเดทเตเดŸเดฟเด•เตเด•เดพเด‚.

เดฎเตเด–เตเดฏ เด•เดดเดฟเดตเตเด•เตพ:

๐Ÿ”ง เดธเดพเด™เตเด•เต‡เดคเดฟเด• เดถเดฟเดฒเตเดชเดถเดพเดฒ

เดฎเตเด–เตเดฏ เดธเดพเด™เตเด•เต‡เดคเดฟเด•เดตเดฟเดฆเตเดฏเด•เตพ

เดฎเตเด–เตเดฏ เด˜เดŸเด•เด™เตเด™เตพ

  1. AIAgent: เดธเด‚เดตเดพเดฆ เดชเตเดฐเดตเดพเดนเด‚ เด•เตˆเด•เดพเดฐเตเดฏเด‚ เดšเต†เดฏเตเดฏเตเดจเตเดจ เดชเตเดฐเดงเดพเดจ เดเดœเดจเตเดฑเต เด“เตผเด•เตเด•เดธเตโ€ŒเดŸเตเดฐเต‡เดฑเตเดฑเตผ
  2. เดฐเต‚เดชเด•เตฝเดชเดจ เด‰เดชเด•เดฐเดฃเด™เตเด™เตพ: เดเดœเดจเตเดฑเดฟเดจเต เดฒเดญเตเดฏเดฎเดพเดฏ GetRandomDestination() เดซเด™เตเดทเตป
  3. เดฑเดธเตเดชเต‹เตบเดธเดธเต เด•เตเดฒเดฏเดจเตเดฑเต: Azure OpenAI Responses เด…เดŸเดฟเดธเตเดฅเดพเดจเดคเตเดคเดฟเดฒเตเดณเตเดณ เดธเด‚เดตเดพเดฆ เด‡เดจเตเดฑเตผเดซเต‡เดธเต
  4. เดธเตเดŸเตเดฐเต€เดฎเดฟเด‚เด—เต เดชเดฟเดจเตเดคเตเดฃ: เดตเดพเดธเตเดคเดตเด•เดพเดฒ เดชเตเดฐเดคเดฟเด•เดฐเดฃ เดธเตƒเดทเตเดŸเดฟ เด•เดดเดฟเดตเตเด•เตพ

เดธเด‚เดฏเต‹เดœเดจเด‚ เดฎเดพเดคเตƒเด•

graph LR
    A[เด‰เดชเดญเต‹เด•เตเดคเตƒ เด…เดญเตเดฏเตผเดคเตเดฅเดจ] --> B[AI เดเดœเดจเตเดฑเต]
    B --> C[เด…เดธเตเดฏเต‚เตผ เด“เดชเตเดชเตบเดŽเด (เดชเตเดฐเดคเตเดฏเตเดคเตเดคเดฐเด™เตเด™เตพ 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 AI เดเดœเดจเตเดฑเตเด•เตพ .NET เตฝ เดจเดฟเตผเดฎเตเดฎเดฟเด•เตเด•เดพเตป เดถเตเดฆเตเดงเดตเตเด‚ เดŸเตˆเดชเตเดชเต-เดธเต‡เดซเตเด‚ เด†เดฏ เดธเดฎเต€เดชเดจเด‚ เดจเตฝเด•เตเดจเตเดจเต
  2. เด‰เดชเด•เดฐเดฃ เดธเด‚เดฏเต‹เดœเดจเด‚: [Description] เด—เตเดฃเดญเดพเด—เด™เตเด™เตพ เด…เดฒเด™เตเด•เดฐเดฟเดšเตเดš เดซเด™เตเด•เตเดทเดจเตเด•เตพ เดเดœเดจเตเดฑเดฟเดจเตเดณเตเดณ เด‰เดชเด•เดฐเดฃเด™เตเด™เดณเดพเดฏเดฟ เดฎเดพเดฑเตเดจเตเดจเต
  3. เด•เต‹เตบเดซเดฟเด—เดฑเต‡เดทเตป เดฎเดพเดจเต‡เดœเตเดฎเต†เดจเตเดฑเต: เดชเดฐเดฟเดธเตเดฅเดฟเดคเดฟ เดšเดพเดฐเด™เตเด™เดณเตเด‚ เดธเตเดฐเด•เตเดทเคฟเคค เด•เตเดฐเต†เดกเตปเดทเตเดฏเตฝ เด•เตˆเด•เดพเดฐเตเดฏเด‚ เดšเต†เดฏเตเดฏเดฒเตเด‚ .NET เดฎเดฟเด•เดšเตเดš เดฎเดพเตผเด—เตเด—เดจเดฟเตผเดฆเตเดฆเต‡เดถเด™เตเด™เตพ เดชเดพเดฒเดฟเด•เตเด•เตเดจเตเดจเต
  4. Azure OpenAI Responses API: เดเดœเดจเตเดฑเต Azure.AI.OpenAI SDK เดตเดดเดฟ Azure OpenAI Responses API เด‰เดชเดฏเต‹เด—เดฟเด•เตเด•เตเดจเตเดจเต

๐Ÿ”— เด…เดงเดฟเด• เด‰เดฑเดตเดฟเดŸเด™เตเด™เตพ


เด…เดฑเดฟเดฏเดฟเดชเตเดชเต: เดˆ เดฐเต‡เด– AI เดชเดฐเดฟเดญเดพเดทเดพ เดธเต‡เดตเดจเด‚ Co-op Translator เด‰เดชเดฏเต‹เด—เดฟเดšเตเดšเต เดชเดฐเดฟเดญเดพเดทเดชเตเดชเต†เดŸเตเดคเตเดคเดฟเดฏเดคเดพเดฃเต. เดžเด™เตเด™เตพ เด•เตƒเดคเตเดฏเดคเดฏเตเด•เตเด•เดพเดฏเดฟ เดถเตเดฐเดฎเดฟเด•เตเด•เตเดจเตเดจเตเดตเต†เด™เตเด•เดฟเดฒเตเด‚, เด“เดŸเตเดŸเต‹เดฎเต‡เดฑเตเดฑเดกเต เดชเดฐเดฟเดญเดพเดทเด•เดณเดฟเตฝ เดชเดฟเดดเดตเตเด•เตพ เด…เดฒเตเดฒเต†เด™เตเด•เดฟเตฝ เดคเต†เดฑเตเดฑเดพเดฏ เดตเดฟเดตเดฐเด™เตเด™เตพ เด‰เดฃเตเดŸเดพเด•เดพเตป เดธเดพเดงเตเดฏเดคเดฏเตเดฃเตเดŸเต. เด…เดคเดฟเดจเตเดฑเต† เดธเตเดตเดพเดญเดพเดตเดฟเด• เดญเดพเดทเดฏเดฟเดฒเตเดณเตเดณ เด…เดธเตฝ เดฐเต‡เด–เดฏเดพเดฃเต เดชเตเดฐเดพเดฎเดพเดฃเดฟเด•เดฎเดพเดฏ เด‰เดฑเดตเดฟเดŸเดฎเดพเดฏเดฟ เดชเดฐเดฟเด—เดฃเดฟเด•เตเด•เต‡เดฃเตเดŸเดคเต. เดจเดฟเตผเดฃเดพเดฏเด•เดฎเดพเดฏ เดตเดฟเดตเดฐเด™เตเด™เตพเด•เตเด•เต, เดชเตเดฐเตŠเดซเดทเดฃเตฝ เดฎเดจเตเดทเตเดฏ เดชเดฐเดฟเดญเดพเดท เดถเตเดชเดพเตผเดถ เดšเต†เดฏเตเดฏเตเดจเตเดจเต. เดˆ เดชเดฐเดฟเดญเดพเดท เด‰เดชเดฏเต‹เด—เดฟเดšเตเดšเต เด‰เดฃเตเดŸเดพเด•เตเดจเตเดจ เดคเต†เดฑเตเดฑเดฟเดฆเตเดงเดพเดฐเดฃเด•เตพ เด…เดฒเตเดฒเต†เด™เตเด•เดฟเตฝ เดคเต†เดฑเตเดฑเดพเดฏ เดตเตเดฏเดพเด–เตเดฏเดพเดจเด™เตเด™เตพเด•เตเด•เดพเดฏเดฟ เดžเด™เตเด™เตพ เด‰เดคเตเดคเดฐเดตเดพเดฆเดฟเด•เดณเดฒเตเดฒ.