ai-agents-for-beginners

🌍 Wakala wa Safari wa AI na Microsoft Agent Framework (.NET)

📋 Muhtasari wa Mtazamo

Mfano huu unaonyesha jinsi ya kujenga wakala mwenye akili wa kupanga safari kwa kutumia Microsoft Agent Framework kwa .NET. Wakala anaweza kuunda ratiba za ziara za siku moja zilizoandaliwa binafsi kwa maeneo tofauti duniani.

Uwezo Muhimu:

• 🎲 Uchaguzi wa Mahali kwa Bahati Nasibu: Inatumia zana maalum kuchagua maeneo ya likizo
• 🗺️ Upangaji Intelligent wa Safari: Inaunda ratiba za kina siku kwa siku
• 🔄 Utiririshaji wa Muda Halisi: Inasaidia majibu ya haraka na ya mtiririko
• 🛠️ Muunganiko wa Zana Maalum: Inaonyesha jinsi ya kupanua uwezo wa wakala

🔧 Mimarishaji ya Kiufundi

Teknolojia Msingi

• Microsoft Agent Framework: Utekelezaji wa hivi karibuni wa .NET kwa maendeleo ya wakala AI
• Azure OpenAI (API za Majibu): Inatumia API za Majibu za Azure OpenAI kwa utambuzi wa mfano
• Azure Identity: Kuingia salama kwa kutumia AzureCliCredential (az login)
• Usimamizi Salama wa Mipangilio: Usimamizi wa anwani kulingana na mazingira

Vifaa Muhimu

1. AIAgent: Mkurugenzi mkuu wa wakala anayesimamia mtiririko wa mazungumzo
2. Zana Maalum: Kazi GetRandomDestination() inayopatikana kwa wakala
3. Mteja wa Majibu: Kiolesura cha mazungumzo kinachotegemea Azure OpenAI Responses
4. Msaada wa Utiririshaji: Uwezo wa kuzalisha majibu ya muda halisi

Mfano wa Muunganiko

graph LR
    A[Ombi la Mtumiaji] --> B[Wakala wa AI]
    B --> C[Azure OpenAI (API ya Majibu)]
    B --> D[Zana ya GetRandomDestination]
    C --> E[Ratiba ya Safari]
    D --> E

🚀 Kuanzisha

Vitu Vinavyohitajika

• SDK ya .NET 10 au juu zaidi
• Usajili wa Azure na rasilimali ya Azure OpenAI na usambazaji wa mfano
• Azure CLI — ingia kwa kutumia az login

Mabadiliko ya Mazingira Yanayohitajika

# zsh/bash
export AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
export AZURE_OPENAI_DEPLOYMENT=gpt-5-mini
# Kisha jisajili ili AzureCliCredential ipate tokeni
az login

# PowerShell
$env:AZURE_OPENAI_ENDPOINT = "https://<your-resource>.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT = "gpt-5-mini"
# Kisha ingia ili AzureCliCredential ipate tokeni
az login

Mfano wa Msimbo

Ili kuendesha mfano wa msimbo,

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

Au kwa kutumia CLI ya dotnet:

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

Tazama 01-dotnet-agent-framework.cs kwa msimbo kamili.

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

🎓 Mambo Muhimu ya Kumbuka

1. Mimarishaji ya Wakala: Microsoft Agent Framework hutoa njia nzuri na salama ya aina ya kujenga mawakala wa AI kwa .NET
2. Muunganiko wa Zana: Kazi zilizo na sifa za [Description] zinakuwa zana zinazopatikana kwa wakala
3. Usimamizi wa Mipangilio: Mabadiliko ya mazingira na usimamizi salama wa vibali hufuata mbinu bora za .NET
4. API za Majibu za Azure OpenAI: Wakala hutumia API za Majibu za Azure OpenAI kupitia SDK ya Azure.AI.OpenAI

🔗 Rasilimali Zaidi

• Nyaraka za Microsoft Agent Framework
• Azure OpenAI katika Microsoft Foundry
• Microsoft.Extensions.AI
• Programu za Faili Moja za .NET

---

Kionyozo: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake halisi inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatutojibu kwa kuelewa vibaya au tafsiri potofu zinazotokea kutokana na matumizi ya tafsiri hii.

This site is open source. Improve this page.