ai-agents-for-beginners

๐ŸŒ เจฎเจพเจˆเจ•เจฐเฉ‹เจธเจพเจซเจŸ เจเจœเฉฐเจŸ เจซเจฐเฉ‡เจฎเจตเจฐเจ• (.NET) เจจเจพเจฒ AI เจฏเจพเจคเจฐเจพ เจเจœเฉฐเจŸ

๐Ÿ“‹ เจธเจจเจฐเฉ€เจ“ เจเจฒเจ•

เจ‡เจน เจ‰เจฆเจพเจนเจฐเจจ เจฆเจฟเจ–เจพเจ‰เจ‚เจฆเฉ€ เจนเฉˆ เจ•เจฟ เจฎเจพเจˆเจ•เจฐเฉ‹เจธเจพเจซเจŸ เจเจœเฉฐเจŸ เจซเจฐเฉ‡เจฎเจตเจฐเจ• เจฒเจˆ .NET เจฆเฉ€ เจตเจฐเจคเฉ‹เจ‚ เจ•เจฐเจ•เฉ‡ เจ‡เฉฑเจ• เจฌเฉเฉฑเจงเฉ€เจฎเจพเจจ เจฏเจพเจคเจฐเจพ เจฏเฉ‹เจœเจจเจพ เจเจœเฉฐเจŸ เจ•เจฟเจตเฉ‡เจ‚ เจฌเจฃเจพเจ‡เจ† เจœเจพ เจธเจ•เจฆเจพ เจนเฉˆเฅค เจ‡เจน เจเจœเฉฐเจŸ เจฆเฉเจจเฉ€เจ† เจญเจฐ เจตเจฟเฉฑเจš เจ•เจฆเฉ‡ เจตเฉ€ เจ—เจฎเจจ เจธเจฅเจพเจจเจพเจ‚ เจฒเจˆ เจจเจฟเฉฑเจœเฉ€ เจฆเจฟเจจ-เจฏเจพเจคเจฐเจพ เจฏเฉ‹เจœเจจเจพเจตเจพเจ‚ เจธเจตเฉˆเจšเจพเจฒเจฟเจค เจคเฉŒเจฐ โ€˜เจคเฉ‡ เจคเจฟเจ†เจฐ เจ•เจฐ เจธเจ•เจฆเจพ เจนเฉˆเฅค

เจฎเฉเฉฑเจ– เจธเจฎเจฐเฉฑเจฅเจพเจตเจพเจ‚:

๐Ÿ”ง เจคเจ•เจจเฉ€เจ•เฉ€ เจ†เจฐเจ•เฉ€เจŸเฉˆเจ•เจšเจฐ

เจ•เฉ‹เจฐ เจคเจ•เจจเฉ€เจ•เจพเจ‚

เจฎเฉเฉฑเจ– เจนเจฟเฉฑเจธเฉ‡

  1. AIAgent: เจฎเฉเฉฑเจ– เจเจœเฉฐเจŸ เจ†เจฐเจ•เฉˆเจธเจŸเจฐเฉ‡เจŸเจฐ เจœเฉ‹ เจ—เฉฑเจฒเจฌเจพเจค เจฆเฉ‡ เจชเฉเจฐเจตเจพเจน เจจเฉ‚เฉฐ เจธเฉฐเจญเจพเจฒเจฆเจพ เจนเฉˆ
  2. เจ•เจธเจŸเจฎ เจŸเฉ‚เจฒ: GetRandomDestination() เจซเฉฐเจ•เจธเจผเจจ เจœเฉ‹ เจเจœเฉฐเจŸ เจฒเจˆ เจ‰เจชเจฒเจฌเจง เจนเฉˆ
  3. เจšเฉˆเจŸ เจ•เจฒเจพเจ‡เฉฐเจŸ: GitHub เจฎเจพเจกเจฒ-เจธเจนเจพเจ‡เจ• เจ—เฉฑเจฒเจฌเจพเจค เจ‡เฉฐเจŸเจฐเจซเฉ‡เจธ
  4. เจธเจŸเฉเจฐเฉ€เจฎเจฟเฉฐเจ— เจธเจฎเจฐเจฅเจจ: เจฐเจฟเจ…เจฒ-เจŸเจพเจˆเจฎ เจœเจตเจพเจฌ เจคเจฟเจ†เจฐ เจ•เจฐเจจ เจฆเฉ€ เจธเจฎเจฐเฉฑเจฅเจพ

เจ‡เฉฐเจŸเฉ€เจ—เฉเจฐเฉ‡เจธเจผเจจ เจชเฉˆเจŸเจฐเจจ

graph LR
    A[User Request] --> B[AI Agent]
    B --> C[GitHub Models API]
    B --> D[GetRandomDestination Tool]
    C --> E[Travel Itinerary]
    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
# PowerShell
$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. เจเจœเฉฐเจŸ เจ†เจฐเจ•เฉ€เจŸเฉˆเจ•เจšเจฐ: เจฎเจพเจˆเจ•เจฐเฉ‹เจธเจพเจซเจŸ เจเจœเฉฐเจŸ เจซเจฐเฉ‡เจฎเจตเจฐเจ• .NET เจตเจฟเฉฑเจš AI เจเจœเฉฐเจŸ เจฌเจฃเจพเจ‰เจฃ เจฒเจˆ เจ‡เฉฑเจ• เจธเจพเจซเจผ, เจŸเจพเจˆเจช-เจธเฉ‡เจซเจผ เจชเจนเฉเฉฐเจš เจชเฉเจฐเจฆเจพเจจ เจ•เจฐเจฆเจพ เจนเฉˆ
  2. เจŸเฉ‚เจฒ เจ‡เฉฐเจŸเฉ€เจ—เฉเจฐเฉ‡เจธเจผเจจ: [Description] เจเจŸเฉเจฐเจฟเจฌเจฟเจŠเจŸ เจจเจพเจฒ เจธเจœเจพเจ เจซเฉฐเจ•เจธเจผเจจ เจเจœเฉฐเจŸ เจฒเจˆ เจ‰เจชเจฒเจฌเจง เจŸเฉ‚เจฒ เจฌเจฃ เจœเจพเจ‚เจฆเฉ‡ เจนเจจ
  3. เจธเฉฐเจฐเจšเจจเจพ เจชเฉเจฐเจฌเฉฐเจงเจจ: เจตเจพเจคเจพเจตเจฐเจฃ เจตเฉˆเจฐเฉ€เจเจฌเจฒ เจ…เจคเฉ‡ เจธเฉเจฐเฉฑเจ–เจฟเจ…เจค เจชเฉเจฐเจฎเจพเจฃ เจชเฉฑเจคเจฐ เจธเฉฐเจญเจพเจฒ .NET เจฆเฉ‡ เจธเจฐเจตเฉ‹เจคเจฎ เจ…เจญเจฟเจ†เจธเจพเจ‚ เจฆเจพ เจชเจพเจฒเจฃ เจ•เจฐเจฆเฉ‡ เจนเจจ
  4. OpenAI เจ…เจจเฉเจ•เฉ‚เจฒเจคเจพ: GitHub เจฎเจพเจกเจฒ เจ‡เฉฐเจŸเฉ€เจ—เฉเจฐเฉ‡เจธเจผเจจ OpenAI-เจ…เจจเฉเจ•เฉ‚เจฒ API เจฆเฉ‡ เจœเจผเจฐเฉ€เจ เจฌเฉ‡เจฐเฉเจ•เจพเจตเจŸ เจ•เฉฐเจฎ เจ•เจฐเจฆเจพ เจนเฉˆ

๐Ÿ”— เจตเจพเจงเฉ‚ เจธเจฐเฉ‹เจค


เจ…เจธเจตเฉ€เจ•เจฐเจคเฉ€:
เจ‡เจน เจฆเจธเจคเจพเจตเฉ‡เจœเจผ AI เจ…เจจเฉเจตเจพเจฆ เจธเฉ‡เจตเจพ Co-op Translator เจฆเฉ€ เจตเจฐเจคเฉ‹เจ‚ เจ•เจฐเจ•เฉ‡ เจ…เจจเฉเจตเจพเจฆ เจ•เฉ€เจคเจพ เจ—เจฟเจ† เจนเฉˆเฅค เจœเจฆเฉ‹เจ‚ เจ•เจฟ เจ…เจธเฉ€เจ‚ เจธเจนเฉ€ เจนเฉ‹เจฃ เจฆเจพ เจฏเจคเจจ เจ•เจฐเจฆเฉ‡ เจนเจพเจ‚, เจ•เจฟเจฐเจชเจพ เจ•เจฐเจ•เฉ‡ เจงเจฟเจ†เจจ เจฆเจฟเจ“ เจ•เจฟ เจธเจตเฉˆเจšเจพเจฒเจฟเจค เจ…เจจเฉเจตเจพเจฆเจพเจ‚ เจตเจฟเฉฑเจš เจ—เจฒเจคเฉ€เจ†เจ‚ เจœเจพเจ‚ เจ…เจธเฉเจšเจจเจพเจตเจพเจ‚ เจนเฉ‹ เจธเจ•เจฆเฉ€เจ†เจ‚ เจนเจจเฅค เจ‡เจธ เจฆเฉ€ เจฎเฉ‚เจฒ เจญเจพเจธเจผเจพ เจตเจฟเฉฑเจš เจฎเฉŒเจœเฉ‚เจฆ เจฎเฉ‚เจฒ เจฆเจธเจคเจพเจตเฉ‡เจœเจผ เจจเฉ‚เฉฐ เจ…เจงเจฟเจ•เจพเจฐเจ• เจธเจฐเฉ‹เจค เจฎเฉฐเจจเจฟเจ† เจœเจพเจฃเจพ เจšเจพเจนเฉ€เจฆเจพ เจนเฉˆเฅค เจฎเจนเฉฑเจคเจตเจชเฉ‚เจฐเจจ เจœเจพเจฃเจ•เจพเจฐเฉ€ เจฒเจˆ, เจชเฉ‡เจธเจผเฉ‡เจตเจฐ เจฎเจจเฉเฉฑเจ–เฉ€ เจ…เจจเฉเจตเจพเจฆ เจฆเฉ€ เจธเจฟเจซเจพเจฐเจธเจผ เจ•เฉ€เจคเฉ€ เจœเจพเจ‚เจฆเฉ€ เจนเฉˆเฅค เจ…เจธเฉ€เจ‚ เจ‡เจธ เจ…เจจเฉเจตเจพเจฆ เจฆเฉ€ เจตเจฐเจคเฉ‹เจ‚ เจคเฉ‹เจ‚ เจชเฉˆเจฆเจพ เจนเฉ‹เจฃ เจตเจพเจฒเฉ€เจ†เจ‚ เจ•เจฟเจธเฉ‡ เจตเฉ€ เจ—เจฒเจคเจซเจนเจฎเฉ€เจ†เจ‚ เจœเจพเจ‚ เจ—เจฒเจค เจตเจฟเจ†เจ–เจฟเจ†เจตเจพเจ‚ เจฒเจˆ เจœเจผเจฟเฉฐเจฎเฉ‡เจตเจพเจฐ เจจเจนเฉ€เจ‚ เจนเจพเจ‚เฅค