Appeler des fonctions .NET à l’aide d’un modèle IA

Dans ce guide de démarrage rapide, vous allez créer une application de conversation AI console .NET pour vous connecter à un modèle IA avec l’appel de fonction locale activé. L’application utilise la bibliothèque pour vous permettre d’écrire du Microsoft.Extensions.AI code à l’aide d’abstractions IA plutôt que d’un KIT de développement logiciel (SDK) spécifique. Les abstractions IA vous permettent de modifier le modèle IA sous-jacent avec des modifications de code minimales.

Clonez l’exemple de dépôt

Vous pouvez créer votre propre application à l’aide des étapes décrites dans les sections à l’avance, ou vous pouvez cloner le dépôt GitHub qui contient les exemples d’applications terminés pour tous les guides de démarrage rapide. Si vous envisagez d’utiliser Azure OpenAI, l’exemple de dépôt est également structuré en tant que modèle Azure Developer CLI qui peut approvisionner une ressource Azure OpenAI pour vous.

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

Créer l’application

Effectuez les étapes suivantes pour créer une application console .NET pour vous connecter à un modèle IA.

1. Dans un répertoire vide sur votre ordinateur, utilisez la dotnet new commande pour créer une application console :

   dotnet new console -o FunctionCallingAI
   

2. Modifiez le répertoire dans le dossier de l’application :

   cd FunctionCallingAI
   

3. Installez les packages nécessaires :

   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. Ouvrez l’application dans Visual Studio Code ou votre éditeur de votre choix

   code .
   

Ajouter le code de l’application

L’application utilise le Microsoft.Extensions.AI package pour envoyer et recevoir des demandes au modèle IA.

1. Dans le fichier Program.cs , ajoutez le code suivant pour vous connecter et vous authentifier auprès du modèle IA. Il ChatClient est également configuré pour utiliser l’appel de fonction, ce qui permet aux fonctions .NET dans votre code d’être appelées par le modèle IA.

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

   Remarque

   DefaultAzureCredential recherche les informations d’identification d’authentification à partir de vos outils locaux. Si vous n’utilisez pas le azd modèle pour approvisionner la ressource Azure OpenAI, vous devez attribuer le Azure AI Developer rôle au compte que vous avez utilisé pour vous connecter à Visual Studio ou à Azure CLI. Pour plus d’informations, consultez S’authentifier auprès des services Azure AI avec .NET.

   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. Créez un ChatOptions objet qui contient une fonction inline que le modèle IA peut appeler pour obtenir le temps actuel. La déclaration de fonction inclut un délégué pour exécuter des paramètres de logique et de nom et de description pour décrire l’objectif de la fonction au modèle IA.

   // 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. Ajoutez une invite système pour chatHistory fournir un contexte et des instructions au modèle. Envoyez une invite utilisateur avec une question qui nécessite que le modèle IA appelle la fonction inscrite pour répondre correctement à la question.

   // 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. Utilisez la commande dotnet run pour exécuter l’application :

   dotnet run
   

   L’application imprime une réponse d’achèvement du modèle IA qui inclut les données fournies par la fonction .NET. Le modèle IA a compris que la fonction inscrite était disponible et l’appelait automatiquement pour générer une réponse appropriée.

azd down

Étapes suivantes

• Démarrage rapide – Créer une application de conversation IA avec .NET
• Générer du texte et des conversations avec les saisies automatiques .NET et Azure OpenAI