Connectez-vous à un modèle IA et invitez-y à l’aide de .NET

Dans ce guide de démarrage rapide, vous allez apprendre à créer une application de conversation console .NET pour vous connecter et inviter un modèle OpenAI ou Azure OpenAI. 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 ExtensionsAI
   

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

   cd ExtensionsAI
   

3. Installez les packages nécessaires :

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

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

   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())
           .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"];
   
   // Create the IChatClient
   IChatClient client =
       new OpenAIClient(key).AsChatClient(model);
   

2. Lisez le contenu du benefits.md fichier et utilisez-le pour créer une invite pour le modèle. Le prompt demande au modèle de résumer le contenu du texte du fichier.

   // Create and print out the prompt
   string prompt = $"""
       summarize the the following text in 20 words or less:
       {File.ReadAllText("benefits.md")}
       """;
   
   Console.WriteLine($"user >>> {prompt}");
   

3. Appelez la InvokePromptAsync fonction pour envoyer l’invite au modèle pour générer une réponse.

   // Submit the prompt and print out the response
   ChatCompletion response = await client.CompleteAsync(prompt, new ChatOptions { MaxOutputTokens = 400 });
   Console.WriteLine($"assistant >>> {response}");
   

4. Utilisez la commande dotnet run pour exécuter l’application :

   dotnet run
   

   L’application imprime la réponse d’achèvement du modèle IA. Personnalisez le contenu texte du benefits.md fichier ou la longueur du résumé pour afficher les différences dans les réponses.

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