ai-agents-for-beginners

🌍 Dirbtinio intelekto kelionių agentas su Microsoft agentų sistema (.NET)

📋 Scenarijaus apžvalga

Šis pavyzdys demonstruoja, kaip sukurti intelektualų kelionių planavimo agentą naudojant Microsoft agentų sistemą .NET aplinkoje. Agentas automatiškai generuoja suasmenintas dienos kelionių maršrutų programas atsitiktinėms pasaulio vietoms.

Pagrindinės galimybės:

🔧 Techninė architektūra

Pagrindinės technologijos

Pagrindiniai komponentai

  1. AIAgent: Pagrindinis agentas, valdo pokalbio eigą
  2. Pasirinktiniai įrankiai: GetRandomDestination() funkcija agentui
  3. Responses klientas: Pokalbių sąsaja paremta Azure OpenAI Responses
  4. Srautinio perdavimo palaikymas: Galimybės generuoti atsakymus realiu laiku

Integracijos šablonas

graph LR
    A[Vartotojo užklausa] --> B[DI agentas]
    B --> C[Azure OpenAI (Atsakymų API)]
    B --> D[Įrankis GetRandomDestination]
    C --> E[Kelionės maršrutas]
    D --> E

🚀 Pradžia

Reikalavimai

Būtini aplinkos kintamieji

# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-5-mini
# Tada prisijunkite, kad AzureCliCredential galėtų gauti žetoną
az login
# PowerShell
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-5-mini"
# Tada prisijunkite, kad AzureCliCredential galėtų gauti žetoną
az login

Pavyzdinis kodas

Norėdami paleisti pavyzdį,

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

Arba naudodami dotnet CLI:

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

Išsamų kodą rasite faile 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);
}

🎓 Pagrindinės išvados

  1. Agento architektūra: Microsoft agentų sistema suteikia tvarkingą, tipų saugomą požiūrį AI agentų kūrimui .NET
  2. Įrankių integracija: Funkcijos, pažymėtos [Description] atributais, tampa prieinamais agento įrankiais
  3. Konfigūracijos valdymas: Aplinkos kintamieji ir saugus kredencialų valdymas atitinka .NET gerąsias praktikas
  4. Azure OpenAI Responses API: Agentas naudoja Azure OpenAI Responses API per Azure.AI.OpenAI SDK

🔗 Papildomi ištekliai


Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama naudoti profesionalų žmogiškąjį vertimą. Mes neatsakome už jokius nesusipratimus ar neteisingą interpretaciją, kilusią naudojantis šiuo vertimu.