Udostępnij przez

Nawiązywanie połączenia z modelem sztucznej inteligencji i monitowania o nie

W tym szybkim przewodniku dowiesz się, jak utworzyć konsolową aplikację czatu w .NET, aby połączyć się z modelem OpenAI lub Azure OpenAI i wyświetlić mu komunikat. Aplikacja używa biblioteki Microsoft.Extensions.AI, aby można było napisać kod przy użyciu abstrakcji sztucznej inteligencji, a nie określonego zestawu SDK. Abstrakcje sztucznej inteligencji umożliwiają zmianę bazowego modelu sztucznej inteligencji przy minimalnych zmianach kodu.

Wymagania wstępne

Wymagania wstępne

Uwaga

Do wykonania zadań w tym artykule można również użyć Semantic Kernel. Semantyczne jądro to lekki zestaw SDK typu open source, który umożliwia tworzenie agentów sztucznej inteligencji i integrowanie najnowszych modeli sztucznej inteligencji z aplikacjami platformy .NET.

Tworzenie aplikacji

Wykonaj poniższe kroki, aby utworzyć aplikację konsolową platformy .NET w celu nawiązania połączenia z modelem sztucznej inteligencji.

  1. W pustym katalogu na komputerze użyj polecenia dotnet new, aby utworzyć nową aplikację konsolową:

    dotnet new console -o ExtensionsAI

  2. Zmień katalog na folder aplikacji:

    cd ExtensionsAI

  3. Zainstaluj wymagane pakiety:

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

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

  4. Otwórz aplikację w programie Visual Studio Code lub wybranym edytorze.

Tworzenie usługi sztucznej inteligencji

  1. Aby aprowizować usługę Azure OpenAI i model, wykonaj kroki opisane w artykule Tworzenie i wdrażanie zasobu usługi Azure OpenAI Service .

  2. W terminalu lub wierszu polecenia przejdź do głównego katalogu projektu.

  3. Uruchom następujące polecenia, aby skonfigurować punkt końcowy i nazwę modelu usługi Azure OpenAI dla przykładowej aplikacji:

    dotnet user-secrets init
dotnet user-secrets set AZURE_OPENAI_ENDPOINT <your-Azure-OpenAI-endpoint>
dotnet user-secrets set AZURE_OPENAI_GPT_NAME <your-Azure-OpenAI-model-name>
dotnet user-secrets set AZURE_OPENAI_API_KEY <your-Azure-OpenAI-key>

Konfigurowanie aplikacji

  1. Przejdź do katalogu głównego projektu platformy .NET z poziomu terminalu lub wiersza polecenia.

  2. Uruchom następujące polecenia, aby skonfigurować klucz API OpenAI jako sekret dla przykładowej aplikacji.

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

Dodawanie kodu aplikacji

Aplikacja używa Microsoft.Extensions.AI pakietu do wysyłania i odbierania żądań do modelu AI.

  1. Skopiuj plik benefits.md do katalogu projektu. Skonfiguruj projekt, aby skopiować ten plik do katalogu wyjściowego. Jeśli używasz programu Visual Studio, kliknij prawym przyciskiem myszy plik w Eksploratorze rozwiązań, wybierz pozycję Właściwości, a następnie ustaw Kopiuj do katalogu wyjściowego na Kopiuj, jeśli nowszy.

  2. Program.cs W pliku dodaj następujący kod, aby nawiązać połączenie i uwierzytelnić się w 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())
        .GetChatClient(deployment)
        .AsIChatClient();

    Uwaga

    DefaultAzureCredential wyszukuje poświadczenia uwierzytelniające z lokalnych narzędzi. Jeśli nie używasz szablonu azd do aprowizowania zasobu usługi Azure OpenAI, musisz przypisać rolę Azure AI Developer do konta użytego do logowania się do programu Visual Studio lub interfejsu wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie usług Azure AI za pomocą .NET.

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

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

IChatClient client =
    new OpenAIClient(key).GetChatClient(model).AsIChatClient();

  3. Dodaj kod, aby odczytać zawartość pliku benefits.md, a następnie utworzyć wpis do modelu. Monit nakazuje modelowi podsumowanie zawartości tekstowej pliku w 20 wyrazach lub mniej.

    string text = File.ReadAllText("benefits.md");
string prompt = $"""
    Summarize the the following text in 20 words or less:
    {text}
    """;

  4. Wywołaj metodę , GetResponseAsync aby wysłać monit do modelu, aby wygenerować odpowiedź.

    // Submit the prompt and print out the response.
ChatResponse response = await client.GetResponseAsync(
    prompt,
    new ChatOptions { MaxOutputTokens = 400 });
Console.WriteLine(response);

  5. Uruchom aplikację:

    dotnet run

    Aplikacja wyświetla odpowiedź ukończenia z modelu sztucznej inteligencji. Dostosuj zawartość tekstowa benefits.md pliku lub długość podsumowania, aby zobaczyć różnice w odpowiedziach.

Czyszczenie zasobów

Jeśli już ich nie potrzebujesz, usuń zasób usługi Azure OpenAI oraz wdrożenie modelu GPT-4.

  1. W witrynie Azure Portalprzejdź do zasobu Azure OpenAI.
  2. Wybierz zasób Azure OpenAI, a następnie wybierz pozycję Usuń.

Następne kroki

  • Last updated on