Вызов функций .NET с помощью модели ИИ

В этом кратком руководстве вы создадите консольное приложение чата ИИ .NET для подключения к модели ИИ с включенным локальным вызовом функций. Приложение использует библиотеку Microsoft.Extensions.AI, чтобы можно было писать код с помощью абстракций ИИ, а не конкретного пакета SDK. Абстракции искусственного интеллекта позволяют изменять базовую модель ИИ с минимальными изменениями кода.

Клонирование примера репозитория

Вы можете создать собственное приложение, выполнив действия, описанные в разделах, или клонировать репозиторий GitHub, содержащий готовые примеры приложений для всех быстрых стартов. Если вы планируете использовать Azure OpenAI, пример репозитория также структурирован как шаблон интерфейса командной строки разработчика Azure, который может подготовить ресурс Azure OpenAI для вас.

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

Создание приложения

Выполните следующие действия, чтобы создать консольное приложение .NET для подключения к модели ИИ.

1. В пустом каталоге на компьютере используйте команду dotnet new для создания нового консольного приложения:

   dotnet new console -o FunctionCallingAI
   

2. Измените каталог в папку приложения:

   cd FunctionCallingAI
   

3. Установите необходимые пакеты:

   dotnet add package Azure.Identity
   dotnet add package Azure.AI.OpenAI
   dotnet add package Microsoft.Extensions.AI --prerelease
   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 --prerelease
   dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
   dotnet add package Microsoft.Extensions.Configuration
   dotnet add package Microsoft.Extensions.Configuration.UserSecrets
   

4. Откройте приложение в Коде Visual Studio или в выбранном редакторе

   code .
   

Добавление кода приложения

Приложение использует пакет Microsoft.Extensions.AI для отправки и получения запросов в модель ИИ.

1. В файле Program.cs добавьте следующий код для подключения и аутентификации к модели ИИ. Элемент ChatClient также настроен для использования вызова функции, что позволяет ИИ-модели вызывать функции .NET в вашем коде.

   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(
           new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
           .GetChatClient(deployment).AsIChatClient())
       .UseFunctionInvocation()
       .Build();
   

   Заметка

   DefaultAzureCredential выполняет поиск учетных данных аутентификации из вашей локальной системы. Если вы не используете шаблон azd для подготовки ресурса Azure OpenAI, вам потребуется назначить роль Azure AI Developer учетной записи, которую вы использовали для входа в Visual Studio или Azure CLI. Дополнительные сведения см. в статье Аутентификация в службах ИИ Azure с помощью.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 ChatClientBuilder(new OpenAIClient(key).GetChatClient(model ?? "gpt-4o").AsIChatClient())
       .UseFunctionInvocation()
       .Build();
   
   // Add a new plugin with a local .NET function
   

2. Создайте новый объект ChatOptions, содержащий встроенную функцию, которую модель искусственного интеллекта может вызывать для получения информации о текущей погоде. Объявление функции включает делегат для выполнения логики, а также параметры имени и описания, описывающие назначение функции модели ИИ.

   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. Добавьте системный запрос в chatHistory, чтобы предоставить модели контекст и инструкции. Отправьте пользователю запрос с вопросом, который требует от модели ИИ вызвать зарегистрированную функцию, чтобы правильно ответить на этот вопрос.

   // 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. Используйте команду dotnet run для запуска приложения:

   dotnet run
   

   Приложение выводит ответ завершения из модели ИИ, которая включает данные, предоставляемые функцией .NET. Модель искусственного интеллекта поняла, что зарегистрированная функция доступна и автоматически вызывает ее для создания правильного ответа.

azd down

Дальнейшие действия

• краткое руководство по созданию приложения чата ИИ с помощью .NET
• Генерация текста и бесед с использованием .NET и генераций Azure OpenAI