共用方式為

使用 .NET 建置 AI 聊天應用程式

  • 發行項

在本快速入門中，您將瞭解如何使用 OpenAI 或 Azure OpenAI 模型建立交談式 .NET 控制台聊天應用程式。 應用程式會使用連結庫， Microsoft.Extensions.AI 因此您可以使用 AI 抽象概念來撰寫程式代碼，而不是特定的 SDK。 AI 抽象概念可讓您使用最少的程式代碼變更來變更基礎 AI 模型。

注意

連結 Microsoft.Extensions.AI 庫目前處於預覽狀態。

必要條件

  • .NET 8.0 SDK - 安裝 .NET 8.0 SDK。
  • OpenAI 中的 API 金鑰，因此您可以執行此範例。
  • 在 Windows 上，需要 PowerShell v7+。 若要驗證您的版本，請在終端機中執行 pwsh。 其應該會傳回目前的版本。 如果傳回錯誤，請執行下列命令：dotnet tool update --global PowerShell。

必要條件

注意

您也可以使用 語意核心 來完成本文中的工作。 語意核心是輕量型開放原始碼 SDK，可讓您建置 AI 代理程式，並將最新的 AI 模型整合到 .NET 應用程式中。

複製範例存放庫

您可以使用先前各節中的步驟建立自己的應用程式，也可以複製包含所有快速入門已完成範例應用程式的 GitHub 存放庫。 如果您打算使用 Azure OpenAI，範例存放庫也會結構化為可為您布建 Azure OpenAI 資源的 Azure 開發人員 CLI 範本。

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

建立應用程式

完成下列步驟以建立 .NET 控制台應用程式以連線到 AI 模型。

  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 .

建立 AI 服務

範例 GitHub 存放庫的結構是 Azure 開發人員 CLI （azd） 範本， azd 可用來為您布建 Azure OpenAI 服務和模型。

  1. 從終端機或命令提示字元中，流覽至 src\quickstarts\azure-openai 範例存放庫的目錄。

  2. azd up執行 命令來布建 Azure OpenAI 資源。 建立 Azure OpenAI 服務並部署模型可能需要幾分鐘的時間。

    azd up

    azd 也會為範例應用程式設定必要的用戶密碼，例如 Azure OpenAI 端點和模型名稱。

設定應用程式

  1. 從終端機或命令提示字元流覽至 .NET 專案的根目錄。

  2. 執行下列命令，將 OpenAI API 金鑰設定為範例應用程式的祕密：

    dotnet user-secrets init
dotnet user-secrets set OpenAIKey <your-openai-key>
dotnet user-secrets set ModelName <your-openai-model-name>

新增應用程式程序代碼

應用程式會 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);

    注意

    DefaultAzureCredential 會從本機工具搜尋驗證認證。 如果您未使用 azd 範本來布建 Azure OpenAI 資源，則必須將角色指派 Azure AI Developer 給您用來登入 Visual Studio 或 Azure CLI 的帳戶。 如需詳細資訊，請參閱 使用 .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

下一步