ai-agents-for-beginners

🌍 Πράκτορας Ταξιδιών AI με το Microsoft Agent Framework (.NET)

📋 Επισκόπηση Σεναρίου

Αυτό το παράδειγμα δείχνει πώς να δημιουργήσετε έναν ευφυή πράκτορα προγραμματισμού ταξιδιών χρησιμοποιώντας το Microsoft Agent Framework για .NET. Ο πράκτορας μπορεί να δημιουργήσει αυτόματα εξατομικευμένα δρομολόγια ημερήσιων εκδρομών για τυχαίους προορισμούς ανά τον κόσμο.

Κύριες Δυνατότητες:

🔧 Τεχνική Αρχιτεκτονική

Βασικές Τεχνολογίες

Κύρια Συστατικά

  1. AIAgent: Ο κύριος διαχειριστής του διαλόγου του πράκτορα
  2. Προσαρμοσμένα Εργαλεία: Συνάρτηση GetRandomDestination() διαθέσιμη στον πράκτορα
  3. Πελάτης Responses: Διάλογος βασισμένος στο Azure OpenAI Responses
  4. Υποστήριξη Streaming: Δυνατότητες παραγωγής απαντήσεων σε πραγματικό χρόνο

Πρότυπο Ενσωμάτωσης

graph LR
    A[Αίτημα χρήστη] --> B[Πράκτορας ΤΝ]
    B --> C[Azure 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 να μπορέσει να πάρει ένα token
az login
# PowerShell
$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 OpenAI Responses API μέσω του SDK Azure.AI.OpenAI

🔗 Πρόσθετοι Πόροι


Αποποίηση ευθυνών: Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης με τεχνητή νοημοσύνη Co-op Translator. Ενώ επιδιώκουμε την ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.