ai-agents-for-beginners

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

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

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

เดชเตเดฐเดงเดพเดจ เด•เดดเดฟเดตเตเด•เตพ:

๐Ÿ”ง เดธเดพเด™เตเด•เต‡เดคเดฟเด• เด†เตผเด•เตเด•เดฟเดŸเต†เด•เตเดšเตผ

เดชเตเดฐเดงเดพเดจ เดธเดพเด™เตเด•เต‡เดคเดฟเด•เดตเดฟเดฆเตเดฏเด•เตพ

เดชเตเดฐเดงเดพเดจ เด˜เดŸเด•เด™เตเด™เตพ

  1. AIAgent: เดธเด‚เดญเดพเดทเดฃ เดชเตเดฐเดตเดพเดนเด‚ เด•เตˆเด•เดพเดฐเตเดฏเด‚ เดšเต†เดฏเตเดฏเตเดจเตเดจ เดชเตเดฐเดงเดพเดจ เดเดœเดจเตเดฑเต เด“เตผเด•เตเด•เดธเตเดŸเตเดฐเต‡เดฑเตเดฑเตผ
  2. Custom Tools: เดเดœเดจเตเดฑเดฟเดจเต เดฒเดญเตเดฏเดฎเดพเดฏ GetRandomDestination() เดซเด‚เด—เตเดทเตป
  3. Chat Client: GitHub Models เดชเดฟเดจเตเดคเตเดฃเดฏเตเดณเตเดณ เดธเด‚เดญเดพเดทเดฃ เด‡เดจเตเดฑเตผเดซเต‡เดธเต
  4. Streaming Support: เดคเดคเตเดธเดฎเดฏ เดชเตเดฐเดคเดฟเด•เดฐเดฃ เดธเตƒเดทเตเดŸเดฟ เด•เดดเดฟเดตเตเด•เตพ

เด‡เดจเตเดฑเด—เตเดฐเต‡เดทเตป เดชเดพเดฑเตเดฑเต‡เตบ

graph LR
    A[เด‰เดชเดฏเต‹เด•เตเดคเตƒ เด…เดญเตเดฏเตผเดคเตเดฅเดจ] --> B[AI เดเดœเดจเตเดฑเต]
    B --> C[GitHub เดฎเต‹เดกเดฒเตเด•เตพ API]
    B --> D[GetRandomDestination เด‰เดชเด•เดฐเดฃเด‚]
    C --> E[เดฏเดพเดคเตเดฐเดพ เดชเดฆเตเดงเดคเดฟ]
    D --> E

๐Ÿš€ เด†เดฐเด‚เดญเดฟเด•เตเด•เตเด•

เด†เดตเดถเตเดฏเดฎเดพเดฏเดต

เด†เดตเดถเตเดฏเดฎเดพเดฏ เดชเดฐเดฟเดธเตเดฅเดฟเดคเดฟ เดตเต‡เดฐเดฟเดฏเดฌเดฟเดณเตเด•เตพ

# zsh/bash
export GH_TOKEN=<your_github_token>
export GH_ENDPOINT=https://models.github.ai/inference
export GH_MODEL_ID=openai/gpt-5-mini
# เดชเดตเตผเดทเต†เตฝ
$env:GH_TOKEN = "<your_github_token>"
$env:GH_ENDPOINT = "https://models.github.ai/inference"
$env:GH_MODEL_ID = "openai/gpt-5-mini"

เดธเดพเดฎเตเดชเดฟเตพ เด•เต‹เดกเต

เด•เต‹เดกเต เด‰เดฆเดพเดนเดฐเดฃเด‚ เดชเตเดฐเดตเตผเดคเตเดคเดฟเดชเตเดชเดฟเด•เตเด•เดพเตป,

# 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@9.*
#:package Microsoft.Agents.AI.OpenAI@1.*-*

using System.ClientModel;
using System.ComponentModel;

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

using OpenAI;

// 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];
}

// Extract configuration from environment variables
// Retrieve the GitHub Models API endpoint, defaults to https://models.github.ai/inference if not specified
// Retrieve the model ID, defaults to openai/gpt-5-mini if not specified
// Retrieve the GitHub token for authentication, throws exception if not specified
var github_endpoint = Environment.GetEnvironmentVariable("GH_ENDPOINT") ?? "https://models.github.ai/inference";
var github_model_id = Environment.GetEnvironmentVariable("GH_MODEL_ID") ?? "openai/gpt-5-mini";
var github_token = Environment.GetEnvironmentVariable("GH_TOKEN") ?? throw new InvalidOperationException("GH_TOKEN is not set.");

// Configure OpenAI Client Options
// Create configuration options to point to GitHub Models endpoint
// This redirects OpenAI client calls to GitHub's model inference service
var openAIOptions = new OpenAIClientOptions()
{
    Endpoint = new Uri(github_endpoint)
};

// Initialize OpenAI Client with GitHub Models Configuration
// Create OpenAI client using GitHub token for authentication
// Configure it to use GitHub Models endpoint instead of OpenAI directly
var openAIClient = new OpenAIClient(new ApiKeyCredential(github_token), openAIOptions);

// Create AI Agent with Travel Planning Capabilities
// Initialize OpenAI client, get chat client for specified model, and create AI agent
// Configure agent with travel planning instructions and random destination tool
// The agent can now plan trips using the GetRandomDestination function
AIAgent agent = openAIClient
    .GetChatClient(github_model_id)
    .CreateAIAgent(
        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. OpenAI เด…เดจเตเดฏเต‹เดœเตเดฏเดค: GitHub Models เด‡เดจเตเดฑเด—เตเดฐเต‡เดทเตป OpenAI- เด…เดจเตเดฏเต‹เดœเตเดฏเดฎเดพเดฏ APIเด•เดณเดฟเดฒเต‚เดŸเต† เดธเตเดคเดพเดฐเตเดฏเดฎเดพเดฏเดฟ เดชเตเดฐเดตเตผเดคเตเดคเดฟเด•เตเด•เตเดจเตเดจเต

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


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