Compartir vía

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

En este inicio rápido, creará una aplicación de chat de IA de consola de .NET que se conecta a un modelo de IA con llamadas a funciones locales habilitadas. 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

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 comando dotnet new 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 --prerelease
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 --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 .

Creación del 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 el punto de conexión y el nombre del modelo de Azure OpenAI 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 del proyecto 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 paquete de Microsoft.Extensions.AI 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 está configurado para usar la invocación de funciones, lo que permite al modelo de IA llamar a funciones de .NET en el código.

    IConfigurationRoot config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string endpoint = config["AZURE_OPENAI_ENDPOINT"];
string deployment = config["AZURE_OPENAI_GPT_NAME"];
string apiKey = config["AZURE_OPENAI_API_KEY"];

IChatClient client =
    new ChatClientBuilder(
        new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(apiKey))
        .GetChatClient(deployment).AsIChatClient())
    .UseFunctionInvocation()
    .Build();

    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 ChatClientBuilder(new OpenAIClient(key).GetChatClient(model ?? "gpt-4o").AsIChatClient())
    .UseFunctionInvocation()
    .Build();

  2. Cree un nuevo objeto ChatOptions 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 lógica y parámetros de 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",
    "Gets the current weather in a given location")]
};

  3. Agregue un mensaje del sistema al chatHistory para proporcionar contexto e instrucciones para el 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()}");

ChatResponse response = await client.GetResponseAsync(chatHistory, chatOptions);
Console.WriteLine($"Assistant >>> {response.Text}");

  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, 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

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

  • Last updated on