Sdílet prostřednictvím

Připojení k modelu AI a zobrazení výzvy k jeho zobrazení pomocí .NET

  • Článek

V tomto rychlém startu se dozvíte, jak vytvořit konzolovou chatovací aplikaci .NET pro připojení a zobrazení výzvy k 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

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 ExtensionsAI

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

    cd ExtensionsAI

  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ření aplikace 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 vašeho .NET projetu.

  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 používá Microsoft.Extensions.AI balíček k odesílání a přijímání požadavků na model AI.

  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 client =
    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, budete muset přiřadit Azure AI Developer roli 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.AI;
using Microsoft.Extensions.Configuration;
using OpenAI;

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

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

  2. benefits.md Přečtěte si obsah souboru a použijte ho k vytvoření výzvy k vytvoření modelu. Výzva dává modelu pokyn, aby shrnul textový obsah souboru.

    // Create and print out the prompt
string prompt = $"""
    summarize the the following text in 20 words or less:
    {File.ReadAllText("benefits.md")}
    """;

Console.WriteLine($"user >>> {prompt}");

  3. Voláním InvokePromptAsync funkce odešlete do modelu výzvu k vygenerování odpovědi.

    // Submit the prompt and print out the response
ChatCompletion response = await client.CompleteAsync(prompt, new ChatOptions { MaxOutputTokens = 400 });
Console.WriteLine($"assistant >>> {response}");

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

    dotnet run

    Aplikace vytiskne odpověď na dokončení z modelu AI. Přizpůsobte si textový obsah benefits.md souboru nebo délku souhrnu, abyste viděli rozdíly v odpovědích.

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