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

In deze quickstart maakt u een .NET-console AI-chat-app die verbinding maakt 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.

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 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 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. 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 het AI-model .NET-functies in uw code kan aanroepen.

   IConfigurationRoot config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string endpoint = config["AZURE_OPENAI_ENDPOINT"];
   string deployment = config["AZURE_OPENAI_GPT_NAME"];
   string apiKey = config["AZURE_OPENAI_API_KEY"];
   
   IChatClient client =
       new ChatClientBuilder(
           new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(apiKey))
           .GetChatClient(deployment).AsIChatClient())
       .UseFunctionInvocation()
       .Build();
   

   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 ChatClientBuilder(new OpenAIClient(key).GetChatClient(model ?? "gpt-5").AsIChatClient())
       .UseFunctionInvocation()
       .Build();
   

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",
       "Gets the current weather in a given location")]
   };
   

3. Voeg een systeemprompt toe aan de chatHistory om context en instructies voor het model te bieden. 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()}");
   
   ChatResponse response = await client.GetResponseAsync(chatHistory, chatOptions);
   Console.WriteLine($"Assistant >>> {response.Text}");
   

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

   dotnet run
   

   De app drukt het voltooiingsantwoord van het AI-model af, inclusief gegevens 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.

Volgende stappen

• Ongeldige invoer van hulpprogramma's van AI-modellen verwerken
• Toegang tot gegevens in AI-functies
• quickstart: een AI-chat-app bouwen met .NET
• Tekst en gesprekken genereren met .NET en Azure OpenAI-voltooiingen