Resumen de texto mediante la aplicación de chat de IA con .NET

  • Artículo

Empiece a trabajar con la inteligencia artificial mediante la creación de una sencilla aplicación de chat de consola de .NET 8.0 para resumir texto. La aplicación se ejecuta localmente y usa el modelo gpt-3.5-turbo de OpenAI. Siga estos pasos para acceder a OpenAI y obtener información sobre cómo usar el kernel semántico.

Requisitos previos

  • SDK de .NET 8.0: Instalación del SDK de .NET 8.0.
  • Una clave de API de OpenAI para poder ejecutar este ejemplo.
  • En Windows, se requiere PowerShell v7+. Para validar la versión, ejecute pwsh en un terminal. Debe devolver la versión actual. Si devuelve un error, ejecute el siguiente comando: dotnet tool update --global PowerShell.

Empiece a trabajar con la inteligencia artificial mediante la creación de una sencilla aplicación de chat de consola de .NET 8.0 para resumir texto. La aplicación se ejecuta localmente y se conecta al modelo gpt-35-turbo de OpenAI implementado en Azure OpenAI. Siga estos pasos para aprovisionar el servicio Azure OpenAI y obtener información sobre cómo usar el Kernel semántico.

Requisitos previos

Obtención del proyecto de ejemplo

Clone el repositorio de GitHub que contiene las aplicaciones de ejemplo para todas las guías de inicio rápido:

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

Creación de Azure OpenAI Service

El repositorio de GitHub de ejemplo se estructura como una plantilla de Azure Developer CLI (azd), que azd puede usar para aprovisionar automáticamente el servicio y el modelo de Azure OpenAI.

  1. Desde un terminal o símbolo del sistema, vaya al directorio src\quickstarts\azure-openai del repositorio de ejemplo.

  2. Ejecute el comando azd up para aprovisionar los recursos de Azure OpenAI. Puede tardar varios minutos en crear el servicio Azure OpenAI e implementar el modelo.

    azd up

    azd también configura los secretos de usuario necesarios para la aplicación de ejemplo, como la clave de acceso de OpenAI.

    Nota:

    Si se produce un error durante la implementación de azd up, visite la sección Solución de problemas.

Muestra Prueba de los beneficios del senderismo

  1. Desde un terminal o símbolo del sistema, vaya al directorio openai\01-HikeBenefitsSummary.

  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>

  3. Use el comando dotnet run para ejecutar la aplicación:

    dotnet run

  1. Desde un terminal o símbolo del sistema, vaya al directorio azure-openai\01-HikeBenefitsSummary.

  2. Use el comando dotnet run para ejecutar la aplicación:

    dotnet run

    Sugerencia

    Si recibe un mensaje de error, es posible que los recursos de Azure OpenAI no hayan terminado de implementarse. Espere un par de minutos e inténtelo de nuevo.

Exploración del código

La aplicación usa el paquete Microsoft.SemanticKernel para enviar y recibir solicitudes al servicio OpenAI.

El archivo Program.cs contiene todo el código de la aplicación. En las primeras líneas del código se establecen valores de configuración y se obtiene la clave de OpenAI que se ha establecido antes mediante el comando dotnet user-secrets.

var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string model = "gpt-3.5-turbo";
string key = config["OpenAIKey"];

La clase Kernel facilita las solicitudes y respuestas, y registra un servicio OpenAIChatCompletion.

// Create a Kernel containing the OpenAI Chat Completion Service
Kernel kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion(model, key)
    .Build();

La aplicación usa el paquete Microsoft.SemanticKernel para enviar y recibir solicitudes al servicio Azure OpenAI.

El archivo Program.cs contiene todo el código de la aplicación. Las primeras líneas de código cargan secretos y valores de configuración establecidos en dotnet user-secrets para usted durante el aprovisionamiento de la aplicación.

// Retrieve the local secrets saved during the Azure deployment
var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string endpoint = config["AZURE_OPENAI_ENDPOINT"];
string deployment = config["AZURE_OPENAI_GPT_NAME"];
string key = config["AZURE_OPENAI_KEY"];

La clase Kernel facilita las solicitudes y respuestas, y registra un servicio OpenAIChatCompletion.

// Create a Kernel containing the Azure OpenAI Chat Completion Service
Kernel kernel = Kernel.CreateBuilder()
    .AddAzureOpenAIChatCompletion(deployment, endpoint, key)
    .Build();

Una vez que se crea la instancia de Kernel, el código de la aplicación lee el contenido del archivo benefits.md y lo usa para crear una instancia de prompt para el modelo. El mensaje indica al modelo que resuma el contenido del texto del archivo.

// Create and print out the prompt
string prompt = $"""
    Please summarize the the following text in 20 words or less:
    {File.ReadAllText("benefits.md")}
    """;
Console.WriteLine($"user >>> {prompt}");

La función InvokePromptAsync envía prompt al modelo para generar una respuesta.

// Submit the prompt and print out the response
string response = await kernel.InvokePromptAsync<string>(
    prompt,
    new(new OpenAIPromptExecutionSettings() 
        { 
            MaxTokens = 400 
        })
    );
Console.WriteLine($"assistant >>> {response}");

Personalice el contenido de texto del archivo o la longitud del resumen para ver las diferencias en las respuestas.

Limpieza de recursos

Cuando ya no necesite la aplicación o los recursos de ejemplo, quite la implementación correspondiente y todos los recursos.

azd down

Solución de problemas

En Windows, es posible que reciba los siguientes mensajes de error después de ejecutar azd up:

postprovision.ps1 no está firmado digitalmente. El script no se ejecutará en el sistema

El script postprovision.ps1 se ejecuta para establecer los secretos de usuario de .NET usados en la aplicación. Para evitar este error, ejecute el siguiente comando de PowerShell:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

A continuación, vuelva a ejecutar el comando azd up.

Otro posible error:

'pwsh' no se reconoce como un comando interno o externo, programa operable o archivo por lotes. ADVERTENCIA: Error en el enlace "postprovision" con código de salida: '1', Ruta de acceso: '.\infra\post-script\postprovision.ps1'. : código de salida: 1 La ejecución continuará desde que ContinueOnError se ha establecido en true.

El script postprovision.ps1 se ejecuta para establecer los secretos de usuario de .NET usados en la aplicación. Para evitar este error, ejecute manualmente el script mediante el siguiente comando de PowerShell:

.\infra\post-script\postprovision.ps1

Las aplicaciones de IA de .NET ahora tiene configurados los secretos de usuario y se pueden probar.

Pasos siguientes