Sdílet prostřednictvím

Vytvoření chatovací aplikace AI pomocí .NET

  • Článek

V tomto rychlém startu se dozvíte, jak vytvořit konverzační konzolovou aplikaci .NET pomocí modelu OpenAI nebo Azure OpenAI. Aplikace používá knihovnu Microsoft.Extensions.AI , abyste mohli psát kód pomocí abstrakcí AI místo konkrétní sady SDK. Abstrakce AI umožňují změnit základní model AI s minimálními změnami kódu.

Poznámka:

Knihovna Microsoft.Extensions.AI je aktuálně ve verzi Preview.

Požadavky

  • .NET 8.0 SDK – Nainstalujte sadu .NET 8.0 SDK.
  • Klíč rozhraní API z OpenAI , abyste mohli tuto ukázku spustit.
  • Ve Windows se vyžaduje PowerShell v7+ . Pokud chcete ověřit svou verzi, spusťte pwsh v terminálu. Měla by vrátit aktuální verzi. Pokud vrátí chybu, spusťte následující příkaz: dotnet tool update --global PowerShell.

Požadavky

Poznámka:

K provádění úloh v tomto článku můžete použít také sémantické jádro . Sémantické jádro je jednoduchá opensourcová sada SDK, která umožňuje vytvářet agenty AI a integrovat nejnovější modely AI do vašich aplikací .NET.

Klonování ukázkového úložiště

Vlastní aplikaci můžete vytvořit pomocí kroků v dalších částech nebo můžete naklonovat úložiště GitHub, které obsahuje dokončené ukázkové aplikace pro všechny rychlé starty. Pokud plánujete používat Azure OpenAI, ukázkové úložiště je také strukturované jako šablona Azure Developer CLI, která vám může zřídit prostředek Azure OpenAI.

git clone https://github.com/dotnet/ai-samples.git

Vytvoření aplikace

Provedením následujících kroků vytvořte konzolovou aplikaci .NET pro připojení k modelu AI.

  1. V prázdném adresáři v počítači pomocí dotnet new příkazu vytvořte novou konzolovou aplikaci:

    dotnet new console -o ChatAppAI

  2. Změňte adresář do složky aplikace:

    cd ChatAppAI

  3. Nainstalujte požadované balíčky:

    dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets

    dotnet add package OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets

  4. Otevřete aplikaci v editoru Visual Studio Code (nebo v libovolném editoru).

    code .

Vytvoření služby AI

Ukázkové úložiště GitHubu je strukturované jako šablona Azure Developer CLI (azd), která azd umožňuje zřídit službu Azure OpenAI a model za vás.

  1. Z terminálu nebo příkazového řádku přejděte do src\quickstarts\azure-openai adresáře ukázkového úložiště.

  2. Spuštěním azd up příkazu zřiďte prostředky Azure OpenAI. Vytvoření služby Azure OpenAI a nasazení modelu může trvat několik minut.

    azd up

    azd nakonfiguruje také požadované tajné kódy uživatelů pro ukázkovou aplikaci, jako je koncový bod Azure OpenAI a název modelu.

Konfigurace aplikace

  1. V terminálu nebo příkazovém řádku přejděte do kořenového adresáře projektu .NET.

  2. Spuštěním následujících příkazů nakonfigurujte klíč rozhraní API OpenAI jako tajný klíč pro ukázkovou aplikaci:

    dotnet user-secrets init
dotnet user-secrets set OpenAIKey <your-openai-key>
dotnet user-secrets set ModelName <your-openai-model-name>

Přidání kódu aplikace

Aplikace tento balíček používá Microsoft.Extensions.AI k odesílání a přijímání požadavků na model AI a je navržená tak, aby uživatelům poskytovala informace o turistických trasách.

  1. Do souboru Program.cs přidejte následující kód pro připojení a ověření modelu AI.

    using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.AI;
using Azure.AI.OpenAI;
using Azure.Identity;

var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string endpoint = config["AZURE_OPENAI_ENDPOINT"];
string deployment = config["AZURE_OPENAI_GPT_NAME"];

IChatClient chatClient =
    new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
        .AsChatClient(deployment);

    Poznámka:

    DefaultAzureCredential vyhledá přihlašovací údaje pro ověřování z místního nástroje. Pokud k zřízení prostředku Azure OpenAI nepoužíváte azd šablonu, musíte roli přiřadit Azure AI Developer k účtu, který jste použili k přihlášení k sadě Visual Studio nebo Azure CLI. Další informace najdete v tématu Ověřování ve službách Azure AI pomocí .NET.

    using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.AI;
using OpenAI;

var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string model = config["ModelName"];
string key = config["OpenAIKey"];

// Create the IChatClient
IChatClient chatClient =
    new OpenAIClient(key).AsChatClient(model);

  2. Vytvořte systémovou výzvu k poskytnutí modelu AI s počátečním kontextem role a pokyny k doporučením pro pěší turistiku:

    // Start the conversation with context for the AI model
List<ChatMessage> chatHistory = new()
    {
        new ChatMessage(ChatRole.System, """
            You are a friendly hiking enthusiast who helps people discover fun hikes in their area.
            You introduce yourself when first saying hello.
            When helping people out, you always ask them for this information
            to inform the hiking recommendation you provide:

            1. The location where they would like to hike
            2. What hiking intensity they are looking for

            You will then provide three suggestions for nearby hikes that vary in length
            after you get that information. You will also share an interesting fact about
            the local nature on the hikes when making a recommendation. At the end of your
            response, ask if there is anything else you can help with.
        """)
    };

  3. Vytvořte konverzační smyčku, která přijímá vstupní výzvu od uživatele, odešle do modelu výzvu a vytiskne dokončení odpovědi:

    while (true)
{
    // Get user prompt and add to chat history
    Console.WriteLine("Your prompt:");
    var userPrompt = Console.ReadLine();
    chatHistory.Add(new ChatMessage(ChatRole.User, userPrompt));

    // Stream the AI response and add to chat history
    Console.WriteLine("AI Response:");
    var response = "";
    await foreach (var item in
        chatClient.CompleteStreamingAsync(chatHistory))
    {
        Console.Write(item.Text);
        response += item.Text;
    }
    chatHistory.Add(new ChatMessage(ChatRole.Assistant, response));
    Console.WriteLine();
}

  4. dotnet run Spuštění aplikace pomocí příkazu:

    dotnet run

    Aplikace vytiskne odpověď na dokončení z modelu AI. Pošlete další následné výzvy a položte další otázky, abyste mohli experimentovat s funkcemi chatu AI.

Vyčištění prostředků

Pokud už ukázkovou aplikaci nebo prostředky nepotřebujete, odeberte odpovídající nasazení a všechny prostředky.

azd down

Další kroky