Compartir a través de

Invocación de funciones de .NET mediante un modelo de IA

  • Artículo

En este inicio rápido, creará una aplicación de chat de IA de consola de .NET para conectarse a un modelo de IA con llamadas a funciones locales habilitadas. La aplicación usa la Microsoft.Extensions.AI biblioteca 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.

Nota:

La Microsoft.Extensions.AI biblioteca está actualmente en versión preliminar.

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.

Requisitos previos

Nota:

También puede usar kernel semántico para realizar las tareas de este artículo. El kernel semántico es un SDK ligero y de código abierto que permite crear agentes de inteligencia artificial e integrar los modelos de IA más recientes en las aplicaciones .NET.

Clonación del repositorio de ejemplo

Puede crear su propia aplicación siguiendo los pasos descritos en las secciones siguientes, o bien puede clonar el repositorio de GitHub que contiene las aplicaciones de ejemplo completadas para todas las guías de inicio rápido. Si planea usar Azure OpenAI, el repositorio de ejemplo también se estructura como una plantilla de la CLI para desarrolladores de Azure que puede aprovisionar un recurso de Azure OpenAI automáticamente.

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

Creación de la aplicación

Complete los pasos siguientes para crear una aplicación de consola de .NET para conectarse a un modelo de IA.

  1. En un directorio vacío del equipo, use el dotnet new comando para crear una nueva aplicación de consola:

    dotnet new console -o FunctionCallingAI

  2. Cambie el directorio a la carpeta de la aplicación:

    cd FunctionCallingAI

  3. Instale los paquetes necesarios:

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

    dotnet add package Microsoft.Extensions.AI
dotnet add package Microsoft.Extensions.AI.OpenAI
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 .

Creación del servicio de IA

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 src\quickstarts\azure-openai directorio 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 el punto de conexión de Azure OpenAI y el nombre del modelo.

Configuración de la aplicación

  1. Vaya a la raíz del projet de .NET desde un terminal o símbolo del sistema.

  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 Microsoft.Extensions.AI paquete para enviar y recibir solicitudes al modelo de IA.

  1. En el archivo Program.cs , agregue el código siguiente para conectarse y autenticarse en el modelo de IA. ChatClient También se configura para usar la invocación de funciones, lo que permite llamar a las funciones de .NET en el código mediante 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 ChatClientBuilder()
        .UseFunctionInvocation()
        .Use(
            new AzureOpenAIClient(new Uri(endpoint),
            new DefaultAzureCredential())
                .AsChatClient(deployment));

    Nota:

    DefaultAzureCredential busca credenciales de autenticación desde las herramientas locales. Si no usa la azd plantilla para aprovisionar el recurso de Azure OpenAI, deberá asignar el Azure AI Developer rol a la cuenta que usó para iniciar sesión en Visual Studio o en la CLI de Azure. Para más información, consulte Autenticación en servicios de Azure AI con .NET.

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

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

IChatClient client =
    new ChatClientBuilder()
        .UseFunctionInvocation()
        .Use(
            new OpenAIClient(key)
                .AsChatClient(model));

  2. Cree un nuevo ChatOptions objeto que contenga una función insertada a la que puede llamar el modelo de IA para obtener el tiempo actual. La declaración de función incluye un delegado para ejecutar parámetros de lógica y nombre y descripción para describir el propósito de la función al modelo de IA.

    // Add a new plugin with a local .NET function that should be available to the AI model
var chatOptions = new ChatOptions
{
    Tools = [AIFunctionFactory.Create((string location, string unit) =>
    {
        // Here you would call a weather API to get the weather for the location
        return "Periods of rain or drizzle, 15 C";
    },
    "get_current_weather",
    "Get the current weather in a given location")]
};

  3. Agregue un símbolo del chatHistory sistema al para proporcionar contexto e instrucciones al modelo. Envíe una solicitud de usuario con una pregunta que requiera que el modelo de IA llame a la función registrada para responder correctamente a la pregunta.

    // System prompt to provide context
List<ChatMessage> chatHistory = [new(ChatRole.System, """
    You are a hiking enthusiast who helps people discover fun hikes in their area. You are upbeat and friendly.
    """)];

// Weather conversation relevant to the registered function
chatHistory.Add(new ChatMessage(ChatRole.User,
    "I live in Montreal and I'm looking for a moderate intensity hike. What's the current weather like? "));
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last()}");

var response = await client.CompleteAsync(chatHistory, chatOptions);
chatHistory.Add(new ChatMessage(ChatRole.Assistant, response.Message.Contents));
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last()}");

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

    dotnet run

    La aplicación imprime una respuesta de finalización del modelo de IA que incluye los datos proporcionados por la función .NET. El modelo de IA entendió que la función registrada estaba disponible y la llamó automáticamente para generar una respuesta adecuada.

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

Pasos siguientes