Delen via

Een AI-chat-app bouwen met .NET

In deze snelstartgids leert u hoe u een gespreksapp maakt voor een .NET-console door gebruik te maken van een OpenAI- of Azure OpenAI-model. 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 ChatAppAI

  2. Wijzig de map in de app-map:

    cd ChatAppAI

  3. Installeer de vereiste pakketten:

    dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
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 editor naar keuze).

    code .

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

Deze app maakt gebruik van het pakket voor het Microsoft.Extensions.AI verzenden en ontvangen van aanvragen naar het AI-model. De app biedt gebruikers informatie over wandelpaden.

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

    IConfigurationRoot 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())
    .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 waarmee u zich hebt aangemeld bij Visual Studio of de Azure CLI. Zie Verifiëren bij Azure AI-services met .NETvoor meer informatie.

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

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

  2. Maak een systeemprompt om het AI-model te voorzien van de eerste rolcontext en instructies over aanbevelingen voor wandelen:

    // Start the conversation with context for the AI model
List<ChatMessage> chatHistory =
    [
        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. Maak een gesprekslus die een invoerprompt van de gebruiker accepteert, de prompt naar het model verzendt en de voltooiing van het antwoord afdrukt:

    // Loop to get user input and stream AI response
while (true)
{
    // Get user prompt and add to chat history
    Console.WriteLine("Your prompt:");
    string? userPrompt = Console.ReadLine();
    chatHistory.Add(new ChatMessage(ChatRole.User, userPrompt));

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

  4. Gebruik de opdracht dotnet run om de app uit te voeren:

    dotnet run

    De app drukt het voltooiingsantwoord van het AI-model af. Stuur aanvullende vervolgprompts en stel andere vragen om te experimenteren met de AI-chatfunctionaliteit.

Het opschonen van bronnen

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