Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
- SDK de .NET 8.0 o superior: Instale el SDK de .NET 8.0.
- Una clave de API de de OpenAI para poder ejecutar este ejemplo.
Prerrequisitos
- SDK de .NET 8.0 o superior: Instale el SDK de .NET 8.
- Una suscripción a Azure (cree una cuenta gratuita).
- CLI para desarrolladores de Azure (opcional): Instalar o actualizar la CLI para desarrolladores de Azure.
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.
En un directorio vacío de su ordenador, utilice el comando
dotnet newpara crear una nueva aplicación de consola:dotnet new console -o ChatAppAICambia el directorio a la carpeta app:
cd ChatAppAIInstale 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.UserSecretsdotnet add package OpenAI dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease dotnet add package Microsoft.Extensions.Configuration dotnet add package Microsoft.Extensions.Configuration.UserSecretsAbra la aplicación en Visual Studio Code (o en el editor que prefiera).
code .
Crear el servicio de IA
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 .
Desde un terminal o línea de comandos, dirígete a la raíz del directorio de tu proyecto.
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
Vaya a la raíz de su proyecto de .NET desde una terminal o línea de comandos.
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.
En el
Program.csarchivo, 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
azdpara aprovisionar el recurso de Azure OpenAI, deberá asignar el rol deAzure AI Developera 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();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. """) ];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(); }Use el comando
dotnet runpara ejecutar la aplicación:dotnet runLa 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.
- En Azure Portal, vaya al recurso de Azure OpenAI.
- Seleccione el recurso Azure OpenAI y, a continuación, seleccione Eliminar.