Creare un'app di chat IA con .NET

Questa guida introduttiva illustra come creare un'app di chat console .NET conversazionale usando un modello OpenAI o Azure OpenAI. L'app usa la Microsoft.Extensions.AI libreria in modo da poter scrivere codice usando astrazioni di intelligenza artificiale anziché un SDK specifico. Le astrazioni di intelligenza artificiale consentono di modificare il modello di intelligenza artificiale sottostante con modifiche minime al codice.

Clonare il repository di esempio:

È possibile creare un'app personalizzata seguendo la procedura descritta nelle sezioni in anticipo oppure clonare il repository GitHub che contiene le app di esempio completate per tutte le guide introduttive. Se si prevede di usare Azure OpenAI, il repository di esempio è strutturato anche come modello dell'interfaccia della riga di comando per sviluppatori di Azure in grado di effettuare automaticamente il provisioning di una risorsa OpenAI di Azure.

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

Creare l'app

Completare i passaggi seguenti per creare un'app console .NET per connettersi a un modello di intelligenza artificiale.

1. In una directory vuota nel computer usare il dotnet new comando per creare una nuova app console:

   dotnet new console -o ChatAppAI
   

2. Modificare la directory nella cartella dell'app:

   cd ChatAppAI
   

3. Installare i pacchetti necessari:

   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. Aprire l'app in Visual Studio Code (o nell'editor preferito).

   code .
   

Aggiungere il codice dell'app

L'app usa il Microsoft.Extensions.AI pacchetto per inviare e ricevere richieste al modello di intelligenza artificiale ed è progettato per fornire agli utenti informazioni sui sentieri per escursioni.

1. Nel file Program.cs aggiungere il codice seguente per connettersi ed eseguire l'autenticazione al modello di intelligenza artificiale.

   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 chatClient =
       new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
           .AsChatClient(deployment);
   

   Nota

   DefaultAzureCredential cerca le credenziali di autenticazione dagli strumenti locali. Se non si usa il modello per effettuare il azd provisioning della risorsa OpenAI di Azure, è necessario assegnare il Azure AI Developer ruolo all'account usato per accedere a Visual Studio o all'interfaccia della riga di comando di Azure. Per altre informazioni, vedere Eseguire l'autenticazione ai servizi di intelligenza artificiale di Azure con .NET.

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.AI;
   using OpenAI;
   
   var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string model = config["ModelName"];
   string key = config["OpenAIKey"];
   
   // Create the IChatClient
   IChatClient chatClient =
       new OpenAIClient(key).AsChatClient(model);
   

2. Creare una richiesta di sistema per fornire al modello di intelligenza artificiale il contesto iniziale del ruolo e istruzioni sulle raccomandazioni per le escursioni:

   // Start the conversation with context for the AI model
   List<ChatMessage> chatHistory = new()
       {
           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. Creare un ciclo di conversazione che accetta una richiesta di input dall'utente, invia il prompt al modello e stampa il completamento della risposta:

   while (true)
   {
       // Get user prompt and add to chat history
       Console.WriteLine("Your prompt:");
       var userPrompt = Console.ReadLine();
       chatHistory.Add(new ChatMessage(ChatRole.User, userPrompt));
   
       // Stream the AI response and add to chat history
       Console.WriteLine("AI Response:");
       var response = "";
       await foreach (var item in
           chatClient.CompleteStreamingAsync(chatHistory))
       {
           Console.Write(item.Text);
           response += item.Text;
       }
       chatHistory.Add(new ChatMessage(ChatRole.Assistant, response));
       Console.WriteLine();
   }
   

4. Usare il comando dotnet run per eseguire l'app:

   dotnet run
   

   L'app stampa la risposta di completamento dal modello di intelligenza artificiale. Inviare richieste di completamento aggiuntive e porre altre domande per sperimentare la funzionalità di chat di intelligenza artificiale.

azd down

Passaggi successivi

• Guida introduttiva - Chat con un modello di intelligenza artificiale locale
• Generare immagini con intelligenza artificiale con .NET