Delen via

.NET-functies aanroepen met behulp van een AI-model

  • Artikel

In deze quickstart maakt u een AI-chat-app voor de .NET-console om verbinding te maken met een AI-model met lokale functieaanroepen ingeschakeld. 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.

Notitie

De Microsoft.Extensions.AI bibliotheek is momenteel beschikbaar als preview-versie.

Vereisten

Vereisten

Notitie

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 voorbeeldopslagplaats klonen

U kunt uw eigen app maken met behulp van de stappen in de volgende secties of u kunt de GitHub-opslagplaats klonen die de voltooide voorbeeld-apps voor alle quickstarts bevat. Als u Azure OpenAI wilt gebruiken, is de voorbeeldopslagplaats ook gestructureerd als een Azure Developer CLI-sjabloon waarmee u een Azure OpenAI-resource kunt inrichten.

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

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 dotnet new opdracht om een nieuwe console-app te maken:

    dotnet new console -o FunctionCallingAI

  2. Wijzig de map in de app-map:

    cd FunctionCallingAI

  3. Installeer de vereiste pakketten:

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

    dotnet add package Microsoft.Extensions.AI
dotnet add package Microsoft.Extensions.AI.OpenAI
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

De GitHub-voorbeeldopslagplaats is gestructureerd als een Azure Developer CLI-sjabloon (azd) die azd kan worden gebruikt om de Azure OpenAI-service en het model voor u in te richten.

  1. Navigeer vanuit een terminal of opdrachtprompt naar de src\quickstarts\azure-openai map van de voorbeeldopslagplaats.

  2. Voer de azd up opdracht uit om de Azure OpenAI-resources in te richten. Het kan enkele minuten duren voordat de Azure OpenAI-service is gemaakt en het model is geïmplementeerd.

    azd up

    azd configureert ook de vereiste gebruikersgeheimen voor de voorbeeld-app, zoals het Azure OpenAI-eindpunt en de modelnaam.

De app configureren

  1. Navigeer vanaf een terminal of opdrachtprompt naar de hoofdmap van uw .NET-projet.

  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 gebruikt het Microsoft.Extensions.AI pakket om aanvragen naar het AI-model te verzenden en te ontvangen.

  1. Voeg in het bestand Program.cs de volgende code toe om verbinding te maken en te verifiëren bij het AI-model. Het ChatClient is ook geconfigureerd voor het gebruik van functie-aanroep, waardoor .NET-functies in uw code kunnen worden aangeroepen door 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 ChatClientBuilder()
        .UseFunctionInvocation()
        .Use(
            new AzureOpenAIClient(new Uri(endpoint),
            new DefaultAzureCredential())
                .AsChatClient(deployment));

    Notitie

    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 .NET voor meer informatie.

    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"];

IChatClient client =
    new ChatClientBuilder()
        .UseFunctionInvocation()
        .Use(
            new OpenAIClient(key)
                .AsChatClient(model));

  2. Maak een nieuw ChatOptions object dat een inlinefunctie bevat die het AI-model kan aanroepen om het huidige weer op te halen. De functiedeclaratie bevat een gemachtigde voor het uitvoeren van logica- en naam- en beschrijvingsparameters om het doel van de functie voor het AI-model te beschrijven.

    // Add a new plugin with a local .NET function that should be available to the AI model
var chatOptions = new ChatOptions
{
    Tools = [AIFunctionFactory.Create((string location, string unit) =>
    {
        // Here you would call a weather API to get the weather for the location
        return "Periods of rain or drizzle, 15 C";
    },
    "get_current_weather",
    "Get the current weather in a given location")]
};

  3. Voeg een systeemprompt toe aan het chatHistory leveren van context en instructies aan het model. Stuur een gebruikersprompt met een vraag waarvoor het AI-model de geregistreerde functie moet aanroepen om de vraag goed te beantwoorden.

    // System prompt to provide context
List<ChatMessage> chatHistory = [new(ChatRole.System, """
    You are a hiking enthusiast who helps people discover fun hikes in their area. You are upbeat and friendly.
    """)];

// Weather conversation relevant to the registered function
chatHistory.Add(new ChatMessage(ChatRole.User,
    "I live in Montreal and I'm looking for a moderate intensity hike. What's the current weather like? "));
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last()}");

var response = await client.CompleteAsync(chatHistory, chatOptions);
chatHistory.Add(new ChatMessage(ChatRole.Assistant, response.Message.Contents));
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last()}");

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

    dotnet run

    De app drukt een voltooid antwoord af van het AI-model dat gegevens bevat die door de .NET-functie worden geleverd. Het AI-model begreep dat de geregistreerde functie beschikbaar was en noemde deze automatisch om een correct antwoord te genereren.

Resources opschonen

Wanneer u de voorbeeldtoepassing of resources niet meer nodig hebt, verwijdert u de bijbehorende implementatie en alle resources.

azd down

Volgende stappen