Criar um aplicativo de chat de IA com o .NET

Neste guia rápido, você aprenderá como criar um aplicativo de chat de console conversacional .NET usando um modelo OpenAI ou Azure OpenAI. O aplicativo usa a biblioteca de Microsoft.Extensions.AI para que você possa escrever código usando abstrações de IA em vez de um SDK específico. As abstrações de IA permitem que você altere o modelo de IA subjacente com alterações mínimas de código.

Criar o aplicativo

Para criar um aplicativo de console do .NET para se conectar a um modelo de IA, execute as etapas a seguir.

1. Em um diretório vazio no computador, use o comando dotnet new para criar um novo aplicativo de console:

   dotnet new console -o ChatAppAI
   

2. Altere o diretório para a pasta do aplicativo:

   cd ChatAppAI
   

3. Instale os pacotes necessários:

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

   dotnet add package OpenAI
   dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
   dotnet add package Microsoft.Extensions.Configuration
   dotnet add package Microsoft.Extensions.Configuration.UserSecrets
   

4. Abra o aplicativo no Visual Studio Code (ou no editor de sua escolha).

   code .
   

Adicionar o código do aplicativo

Esse aplicativo usa o Microsoft.Extensions.AI pacote para enviar e receber solicitações para o modelo de IA. O aplicativo fornece aos usuários informações sobre trilhas de caminhada.

1. Program.cs No arquivo, adicione o código a seguir para se conectar e autenticar ao modelo de IA.

   IConfigurationRoot 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())
       .GetChatClient(deployment)
       .AsIChatClient();
   

   Observação

   DefaultAzureCredential pesquisa credenciais de autenticação de suas ferramentas locais. Se você não estiver usando o modelo de azd para provisionar o recurso do Azure OpenAI, precisará atribuir a função Azure AI Developer à conta usada para entrar no Visual Studio ou na CLI do Azure. Para obter mais informações, consulte Autenticar-se nos serviços de IA do Azure com .NET.

   var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string model = config["ModelName"];
   string key = config["OpenAIKey"];
   
   // Create the IChatClient
   IChatClient chatClient =
       new OpenAIClient(key).GetChatClient(model).AsIChatClient();
   

2. Crie um prompt do sistema para fornecer ao modelo de IA o contexto da função inicial e instruções sobre recomendações de caminhadas:

   // Start the conversation with context for the AI model
   List<ChatMessage> chatHistory =
       [
           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. Crie um loop de conversação que aceite um prompt de entrada do usuário, envie o prompt ao modelo e imprima a conclusão da resposta:

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

4. Use o comando dotnet run para executar o aplicativo:

   dotnet run
   

   O aplicativo imprime a resposta de conclusão do modelo de IA. Envie prompts de acompanhamento adicionais e faça outras perguntas para experimentar a funcionalidade de bate-papo da IA.

Próximas etapas

• Início Rápido – Conversar com um modelo de IA local
• Gerar imagens de texto usando IA