ai-agents-for-beginners

🌍 AI Reisagent met Microsoft Agent Framework (.NET)

📋 Scenario Overzicht

Dit voorbeeld laat zien hoe je een intelligente reisplanningsagent kunt bouwen met het Microsoft Agent Framework voor .NET. De agent kan automatisch gepersonaliseerde dagtripschema’s genereren voor willekeurige bestemmingen over de hele wereld.

Belangrijkste Mogelijkheden:

🔧 Technische Architectuur

Kerntechnologieën

Belangrijke Componenten

  1. AIAgent: De hoofdagent die het gesprek beheert
  2. Aangepaste Tools: GetRandomDestination()-functie beschikbaar voor de agent
  3. Responses Client: Conversatie-interface gebaseerd op Azure OpenAI Responses
  4. Streaming Ondersteuning: Mogelijkheden voor het genereren van realtime reacties

Integratiepatroon

graph LR
    A[Gebruikersverzoek] --> B[AI Agent]
    B --> C[Azure OpenAI (Responses API)]
    B --> D[GetRandomDestination Hulpmiddel]
    C --> E[Reisroute]
    D --> E

🚀 Aan de Slag

Vereisten

Vereiste Omgevingsvariabelen

# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-5-mini
# Meld u vervolgens aan zodat AzureCliCredential een token kan krijgen
az login
# PowerShell
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-5-mini"
# Log dan in zodat AzureCliCredential een token kan verkrijgen
az login

Voorbeeldcode

Om het codevoorbeeld uit te voeren,

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

Of met de dotnet CLI:

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

Zie 01-dotnet-agent-framework.cs voor de volledige code.

#!/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);
}

🎓 Belangrijkste Leerpunten

  1. Agent Architectuur: Het Microsoft Agent Framework biedt een nette, type-veilige aanpak voor het bouwen van AI-agents in .NET
  2. Tool Integratie: Functies met [Description] attributen worden beschikbare tools voor de agent
  3. Configuratiebeheer: Omgevingsvariabelen en veilige credentialafhandeling volgen de beste .NET-praktijken
  4. Azure OpenAI Responses API: De agent gebruikt de Azure OpenAI Responses API via de Azure.AI.OpenAI SDK

🔗 Aanvullende Bronnen


Disclaimer: Dit document is vertaald met behulp van de AI vertaaldienst Co-op Translator. Hoewel we streven naar nauwkeurigheid, dient u er rekening mee te houden dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het originele document in de oorspronkelijke taal moet worden beschouwd als de gezaghebbende bron. Voor kritieke informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling.