.NET を使用して AI チャット アプリを構築する

このクイック スタートでは、OpenAI または Azure OpenAI モデルを使用して会話型の .NET コンソール チャット アプリを作成する方法について説明します。 アプリは Microsoft.Extensions.AI ライブラリを使用するため、特定の SDK ではなく AI 抽象化を使用してコードを記述できます。 AI 抽象化を使用すると、最小限のコード変更で基になる AI モデルを変更できます。

サンプル リポジトリをクローンする

前のセクションの手順を使用して独自のアプリを作成することも、すべてのクイックスタートの完成したサンプル アプリを含む GitHub リポジトリを複製することもできます。 Azure OpenAI を使用する予定の場合、サンプル リポジトリは、Azure OpenAI リソースをプロビジョニングできる Azure Developer CLI テンプレートとしても構成されます。

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

アプリを作成する

AI モデルに接続する .NET コンソール アプリを作成するには、次の手順を実行します。

1. コンピューター上の空のディレクトリで、 dotnet new コマンドを使用して新しいコンソール アプリを作成します。

   dotnet new console -o ChatAppAI
   

2. ディレクトリをアプリ フォルダーに変更します。

   cd ChatAppAI
   

3. 必要なパッケージをインストールします。

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

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

4. Visual Studio Code (または任意のエディター) でアプリを開きます。

   code .
   

アプリ コードを追加する

アプリは、 Microsoft.Extensions.AI パッケージを使用して AI モデルへの要求を送受信し、ハイキング コースに関する情報をユーザーに提供するように設計されています。

1. Program.cs ファイルで、次のコードを追加して、AI モデルに接続して認証します。

   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 chatClient =
       new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
           .AsChatClient(deployment);
   

   Note

   DefaultAzureCredential は、ローカル ツールから認証資格情報を検索します。 azd テンプレートを使用して Azure OpenAI リソースをプロビジョニングしていない場合は、Visual Studio または Azure CLI へのサインインに使用したアカウントにAzure AI Developer ロールを割り当てる必要があります。 詳細については、「 .NET を使用した Azure AI サービスへの認証を参照してください。

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.AI;
   using OpenAI;
   
   var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string model = config["ModelName"];
   string key = config["OpenAIKey"];
   
   // Create the IChatClient
   IChatClient chatClient =
       new OpenAIClient(key).AsChatClient(model);
   

2. 最初のロール コンテキストとハイキングの推奨事項に関する手順を AI モデルに提供するシステム プロンプトを作成します。

   // Start the conversation with context for the AI model
   List<ChatMessage> chatHistory = new()
       {
           new ChatMessage(ChatRole.System, """
               You are a friendly hiking enthusiast who helps people discover fun hikes in their area.
               You introduce yourself when first saying hello.
               When helping people out, you always ask them for this information
               to inform the hiking recommendation you provide:
   
               1. The location where they would like to hike
               2. What hiking intensity they are looking for
   
               You will then provide three suggestions for nearby hikes that vary in length
               after you get that information. You will also share an interesting fact about
               the local nature on the hikes when making a recommendation. At the end of your
               response, ask if there is anything else you can help with.
           """)
       };
   

3. ユーザーからの入力プロンプトを受け入れ、プロンプトをモデルに送信し、応答の完了を出力する会話ループを作成します。

   while (true)
   {
       // Get user prompt and add to chat history
       Console.WriteLine("Your prompt:");
       var userPrompt = Console.ReadLine();
       chatHistory.Add(new ChatMessage(ChatRole.User, userPrompt));
   
       // Stream the AI response and add to chat history
       Console.WriteLine("AI Response:");
       var response = "";
       await foreach (var item in
           chatClient.CompleteStreamingAsync(chatHistory))
       {
           Console.Write(item.Text);
           response += item.Text;
       }
       chatHistory.Add(new ChatMessage(ChatRole.Assistant, response));
       Console.WriteLine();
   }
   

4. dotnet run コマンドを使用してアプリを実行します。

   dotnet run
   

   アプリは、AI モデルから完了応答を出力します。 追加のフォローアップ プロンプトを送信し、AI チャット機能を試すために他の質問をします。

azd down

次のステップ

• クイック スタート - ローカル AI モデルとのチャット
• .NET で AI を使用して画像を生成する