Compartir a través de

Conexión y solicitud de un modelo de IA

En esta guía de inicio rápido, aprenderá a crear una aplicación de chat de consola de .NET para conectarse e interactuar con un modelo de 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 ExtensionsAI

  2. Cambia el directorio a la carpeta app:

    cd ExtensionsAI

  3. Instale los paquetes necesarios:

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

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>

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

La aplicación usa el paquete de Microsoft.Extensions.AI para enviar y recibir solicitudes al modelo de IA.

  1. Copie el archivo benefits.md en el directorio del proyecto. Configure el proyecto para copiar este archivo en el directorio de salida. Si usa Visual Studio, haga clic con el botón derecho en el archivo en el Explorador de soluciones, seleccione Propiedades y, a continuación, establezca Copiar en directorio de salida en Copiar si es más reciente.

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

    using Microsoft.Extensions.AI;
using Microsoft.Extensions.Configuration;
using OpenAI;

IConfigurationRoot config = new ConfigurationBuilder()
    .AddUserSecrets<Program>()
    .Build();
string? model = config["ModelName"];
string? key = config["OpenAIKey"];

IChatClient client =
    new OpenAIClient(key).GetChatClient(model).AsIChatClient();

  3. Agregue código para leer el contenido del benefits.md archivo y, a continuación, cree una solicitud para el modelo. El mensaje indica al modelo que resuma el contenido de texto del archivo en 20 palabras o menos.

    string text = File.ReadAllText("benefits.md");
string prompt = $"""
    Summarize the the following text in 20 words or less:
    {text}
    """;

  4. Llame al GetResponseAsync método para enviar el mensaje al modelo para generar una respuesta.

    // Submit the prompt and print out the response.
ChatResponse response = await client.GetResponseAsync(
    prompt,
    new ChatOptions { MaxOutputTokens = 400 });
Console.WriteLine(response);

  5. Ejecute la aplicación:

    dotnet run

    La aplicación imprime la respuesta de finalización del modelo de IA. Personalice el contenido de texto del benefits.md archivo o la longitud del resumen para ver las diferencias en las respuestas.

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