ai-agents-for-beginners

🌍 AI Туристически Агент с Microsoft Agent Framework (.NET)

📋 Преглед на Сценария

Този пример демонстрира как да се създаде интелигентен туристически агент, използвайки Microsoft Agent Framework за .NET. Агентът може автоматично да генерира персонализирани еднодневни маршрути за произволни дестинации по света.

Основни възможности:

• 🎲 Произволен избор на дестинация: Използва персонализиран инструмент за избор на ваканционни места
• 🗺️ Интелигентно планиране на пътуване: Създава подробни маршрути ден по ден
• 🔄 Поточно предаване в реално време: Поддържа както незабавни, така и потокови отговори
• 🛠️ Интеграция на персонализиран инструмент: Демонстрира как да се разширят възможностите на агента

🔧 Техническа Архитектура

Основни Технологии

• Microsoft Agent Framework: Най-нова .NET имплементация за разработка на AI агенти
• Azure OpenAI (Responses API): Използва Azure OpenAI Responses API за моделиране
• Azure Identity: Сигурно влизане чрез AzureCliCredential (az login)
• Сигурна конфигурация: Управление на крайни точки базирано на околната среда

Основни компоненти

1. AIAgent: Основният агент-оркестратор, който управлява потока на разговора
2. Персонализирани инструменти: Функция GetRandomDestination() налична за агента
3. Responses Клиент: Интерфейс за разговор базиран на Azure OpenAI Responses
4. Поддръжка на поточно предаване: Възможности за генериране на отговори в реално време

Патерн за интеграция

graph LR
    A[Потребителска заявка] --> B[AI агент]
    B --> C[Azure OpenAI (API за отговори)]
    B --> D[Инструмент GetRandomDestination]
    C --> E[План за пътуване]
    D --> E

🚀 Стартиране

Предварителни изисквания

• .NET 10 SDK или по-нова версия
• Абонамент за Azure с ресурс Azure OpenAI и разгръщане на модел
• Azure CLI — влезте с az login

Задължителни променливи на средата

# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-4.1-mini
# Влезте, за да може AzureCliCredential да получи маркер
az login

# PowerShell
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-4.1-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-4.1-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 чрез Azure.AI.OpenAI SDK

🔗 Допълнителни ресурси

• Документация на Microsoft Agent Framework
• Azure OpenAI в Microsoft Foundry
• Microsoft.Extensions.AI
• .NET Single File Apps

---

Отказ от отговорност: Този документ е преведен с помощта на AI преводачески услуга Co-op Translator. Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.

This site is open source. Improve this page.