Delen via

Verbinding maken met en vragen om een AI-model

In deze quickstart leert u hoe u een .NET-consolechat-app maakt om verbinding te maken met en een OpenAI- of Azure OpenAI-model te vragen. De app maakt gebruik van de Microsoft.Extensions.AI-bibliotheek, zodat u code kunt schrijven met behulp van AI-abstracties in plaats van een specifieke SDK. Met AI-abstracties kunt u het onderliggende AI-model wijzigen met minimale codewijzigingen.

Vereiste voorwaarden

Vereiste voorwaarden

Opmerking

U kunt ook Semantische kernel gebruiken om de taken in dit artikel uit te voeren. Semantische kernel is een lichtgewicht opensource-SDK waarmee u AI-agents kunt bouwen en de nieuwste AI-modellen kunt integreren in uw .NET-apps.

De app maken

Voer de volgende stappen uit om een .NET-console-app te maken om verbinding te maken met een AI-model.

  1. Gebruik in een lege map op uw computer de opdracht dotnet new om een nieuwe console-app te maken:

    dotnet new console -o ExtensionsAI

  2. Wijzig de map in de app-map:

    cd ExtensionsAI

  3. Installeer de vereiste pakketten:

    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. Open de app in Visual Studio Code of uw gewenste editor.

De AI-service maken

  1. Als u een Azure OpenAI-service en -model wilt inrichten, voert u de stappen in het artikel Een Azure OpenAI-serviceresource maken en implementeren uit.

  2. Navigeer vanuit een terminal of opdrachtprompt naar de hoofdmap van uw projectmap.

  3. Voer de volgende opdrachten uit om uw Azure OpenAI-eindpunt en modelnaam voor de voorbeeld-app te configureren:

    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>

De app configureren

  1. Navigeer vanuit een terminal of opdrachtprompt naar de hoofdmap van uw .NET-project.

  2. Voer de volgende opdrachten uit om uw OpenAI API-sleutel als geheim te configureren voor de voorbeeld-app:

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

De app-code toevoegen

De app maakt gebruik van het Microsoft.Extensions.AI-pakket voor het verzenden en ontvangen van aanvragen naar het AI-model.

  1. Kopieer het benefits.md bestand naar de projectmap. Configureer het project om dit bestand naar de uitvoermap te kopiëren. Als u Visual Studio gebruikt, klikt u met de rechtermuisknop op het bestand in Solution Explorer, selecteert u Eigenschappen en stelt u Kopiëren naar uitvoermap in op Kopiëren indien nieuwer.

  2. Voeg in het Program.cs bestand de volgende code toe om verbinding te maken en te verifiëren met het AI-model.

    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();

    Opmerking

    DefaultAzureCredential zoekt naar verificatiereferenties vanuit uw lokale hulpprogramma's. Als u de azd-sjabloon niet gebruikt om de Azure OpenAI-resource in te richten, moet u de Azure AI Developer rol toewijzen aan het account dat u hebt gebruikt om u aan te melden bij Visual Studio of de Azure CLI. Zie Verifiëren bij Azure AI-services met .NETvoor meer informatie.

    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. Voeg code toe om de benefits.md bestandsinhoud te lezen en maak vervolgens een prompt voor het model. Met de prompt wordt het model geïnstrueerd om de tekstinhoud van het bestand in 20 woorden of minder samen te vatten.

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

  4. Roep de GetResponseAsync methode aan om de prompt naar het model te verzenden om een antwoord te genereren.

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

  5. Voer de app uit:

    dotnet run

    De app drukt het voltooiingsantwoord van het AI-model af. Pas de tekstinhoud van het benefits.md bestand of de lengte van het overzicht aan om de verschillen in de antwoorden te zien.

Hulpmiddelen opruimen

Als u deze niet meer nodig hebt, verwijdert u de Azure OpenAI-resource en GPT-4-modelimplementatie.

  1. Navigeer in de Azure Portalnaar de Azure OpenAI-resource.
  2. Selecteer de Azure OpenAI-resource en selecteer vervolgens verwijderen.

Volgende stappen