Compartir a través de


Creación de una aplicación de chat de IA con .NET

En esta guía rápida, aprenderás a crear una aplicación de chat de consola .NET conversacional mediante un modelo OpenAI o Azure OpenAI. La aplicación usa la biblioteca de Microsoft.Extensions.AI para que pueda escribir código mediante abstracciones de IA en lugar de un SDK específico. Las abstracciones de IA permiten cambiar el modelo de IA subyacente con cambios mínimos de código.

Prerrequisitos

Prerrequisitos

Nota:

También puede usar Kernel Semántico para cumplir con las tareas mencionadas en este artículo. Semantic Kernel es un SDK ligero y de código abierto que te permite crear agentes de IA e integrar los últimos modelos de IA en tus aplicaciones .NET.

Creación de la aplicación

Siga los siguientes pasos para crear una aplicación de consola .NET que se conecte a un modelo de IA.

  1. En un directorio vacío de su ordenador, utilice el comando dotnet new para crear una nueva aplicación de consola:

    dotnet new console -o ChatAppAI
    
  2. Cambia el directorio a la carpeta app:

    cd ChatAppAI
    
  3. Instale los paquetes necesarios:

    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 la aplicación en Visual Studio Code (o en el editor que prefiera).

    code .
    

Crear el servicio de IA

  1. Para aprovisionar un servicio y un modelo de Azure OpenAI, complete los pasos descritos en el artículo Creación e implementación de un recurso de azure OpenAI Service .

  2. Desde un terminal o línea de comandos, dirígete a la raíz del directorio de tu proyecto.

  3. Ejecute los siguientes comandos para configurar su punto de conexión Azure OpenAI y el nombre del modelo para la aplicación de ejemplo:

    dotnet user-secrets init
    dotnet user-secrets set AZURE_OPENAI_ENDPOINT <your-Azure-OpenAI-endpoint>
    dotnet user-secrets set AZURE_OPENAI_GPT_NAME <your-Azure-OpenAI-model-name>
    dotnet user-secrets set AZURE_OPENAI_API_KEY <your-Azure-OpenAI-key>
    

Configuración de la aplicación

  1. Vaya a la raíz de su proyecto de .NET desde una terminal o línea de comandos.

  2. Ejecute los siguientes comandos para configurar la clave de API de OpenAI como un secreto para la aplicación de ejemplo:

    dotnet user-secrets init
    dotnet user-secrets set OpenAIKey <your-OpenAI-key>
    dotnet user-secrets set ModelName <your-OpenAI-model-name>
    

Adición del código de la aplicación

Esta aplicación usa el Microsoft.Extensions.AI paquete para enviar y recibir solicitudes al modelo de IA. La aplicación proporciona a los usuarios información sobre las rutas de senderismo.

  1. En el Program.cs archivo, agregue el código siguiente para conectarse y autenticarse en el 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();
    

    Nota:

    DefaultAzureCredential busca las credenciales de autenticación de sus herramientas locales. Si no usa la plantilla de azd para aprovisionar el recurso de Azure OpenAI, deberá asignar el rol de Azure AI Developer a la cuenta que usó para iniciar sesión en Visual Studio o en la CLI de Azure. Para obtener más información, consulte Autenticación de Servicios de Azure AI con .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. Cree una solicitud del sistema para proporcionar el modelo de IA con el contexto de rol inicial e instrucciones sobre las recomendaciones de senderismo:

    // 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. Cree un bucle conversacional que acepte un mensaje de entrada del usuario, envíe el mensaje al modelo e imprima la finalización de la respuesta:

    // 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 el comando dotnet run para ejecutar la aplicación:

    dotnet run
    

    La aplicación imprime la respuesta de finalización del modelo de IA. Envíe avisos de seguimiento adicionales y realice otras preguntas para experimentar con la funcionalidad de chat de IA.

Limpieza de recursos

Si ya no los necesita, elimine el recurso de Azure OpenAI y la implementación del modelo GPT-4.

  1. En Azure Portal, vaya al recurso de Azure OpenAI.
  2. Seleccione el recurso Azure OpenAI y, a continuación, seleccione Eliminar.

Pasos siguientes