事件
使用 .NET 連線並提示 AI 模型
在本快速入門中,您將瞭解如何建立 .NET 控制台聊天應用程式,以連線並提示 OpenAI 或 Azure OpenAI 模型。 應用程式會使用連結庫, Microsoft.Extensions.AI 因此您可以使用 AI 抽象概念來撰寫程式代碼,而不是特定的 SDK。 AI 抽象概念可讓您使用最少的程式代碼變更來變更基礎 AI 模型。
注意
連結 Microsoft.Extensions.AI
庫目前處於預覽狀態。
- .NET 8.0 SDK 或更高版本 - 安裝 .NET 8.0 SDK。
- OpenAI 中的 API 金鑰,因此您可以執行此範例。
- .NET 8.0 SDK 或更高版本 - 安裝 .NET 8 SDK。
- Azure 訂用帳戶 - 建立免費帳戶。
- 存取 Azure OpenAI 服務。
- Azure 開發人員 CLI (選擇用) - 安裝或更新 Azure 開發人員 CLI。
注意
您也可以使用 語意核心 來完成本文中的工作。 語意核心是輕量型開放原始碼 SDK,可讓您建置 AI 代理程式,並將最新的 AI 模型整合到 .NET 應用程式中。
您可以使用先前各節中的步驟建立自己的應用程式,也可以複製包含所有快速入門已完成範例應用程式的 GitHub 存放庫。 如果您打算使用 Azure OpenAI,範例存放庫也會結構化為可為您布建 Azure OpenAI 資源的 Azure 開發人員 CLI 範本。
git clone https://github.com/dotnet/ai-samples.git
完成下列步驟以建立 .NET 控制台應用程式以連線到 AI 模型。
在您的電腦上的空白目錄中,使用
dotnet new
命令來建立新的控制台應用程式:.NET CLIdotnet new console -o ExtensionsAI
將目錄變更為應用程式資料夾:
.NET CLIcd ExtensionsAI
安裝必要的套件:
Bashdotnet 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
Bashdotnet add package OpenAI dotnet add package Microsoft.Extensions.AI.OpenAI dotnet add package Microsoft.Extensions.Configuration dotnet add package Microsoft.Extensions.Configuration.UserSecrets
在 Visual Studio 程式代碼或您選擇的編輯器中開啟應用程式
Bashcode .
範例 GitHub 存放庫的結構是 Azure 開發人員 CLI (azd
) 範本, azd
可用來為您布建 Azure OpenAI 服務和模型。
從終端機或命令提示字元中,流覽至
src\quickstarts\azure-openai
範例存放庫的目錄。azd up
執行 命令來布建 Azure OpenAI 資源。 建立 Azure OpenAI 服務並部署模型可能需要幾分鐘的時間。Azure 開發人員 CLIazd up
azd
也會為範例應用程式設定必要的用戶密碼,例如 Azure OpenAI 端點和模型名稱。
請從終端機或命令提示字元導航至您的 .NET 專案根目錄。
執行下列命令,將 OpenAI API 金鑰設定為範例應用程式的祕密:
Bashdotnet user-secrets init dotnet user-secrets set OpenAIKey <your-openai-key> dotnet user-secrets set ModelName <your-openai-model-name>
應用程式會 Microsoft.Extensions.AI
使用套件來傳送和接收 AI 模型的要求。
在Program.cs檔案中,新增下列程式代碼以連線並驗證 AI 模型。
C#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 AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()) .AsChatClient(deployment);
注意
DefaultAzureCredential 會從本機工具搜尋驗證認證。 如果您未使用
azd
範本來布建 Azure OpenAI 資源,則必須將角色指派Azure AI Developer
給您用來登入 Visual Studio 或 Azure CLI 的帳戶。 如需詳細資訊,請參閱 使用 .NET 向 Azure AI 服務進行驗證。C#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"]; // Create the IChatClient IChatClient client = new OpenAIClient(key).AsChatClient(model);
讀取 benefits.md 檔案內容,並用來為模型創建提示。 提示會指示模型摘要檔案文字內容。
C#// Create and print out the prompt string prompt = $""" summarize the the following text in 20 words or less: {File.ReadAllText("benefits.md")} """; Console.WriteLine($"user >>> {prompt}");
呼叫 函
InvokePromptAsync
式,將提示傳送至模型以產生回應。C#// Submit the prompt and print out the response ChatResponse response = await client.GetResponseAsync(prompt, new ChatOptions { MaxOutputTokens = 400 }); Console.WriteLine($"assistant >>> {response}");
使用
dotnet run
命令來執行應用程式:.NET CLIdotnet run
應用程式會列印 AI 模型的完成回應。 自定義檔案的
benefits.md
文字內容或摘要的長度,以查看響應的差異。
其他資源
訓練
模組
使用 .NET 和 Azure OpenAI 完成產生文字和交談 - Training
了解如何使用 .NET SDK 搭配 Azure OpenAI 服務,讓您的應用程式以自然語言與使用者進行交談。
認證
Microsoft Certified: Azure AI Fundamentals - Certifications
示範與 Microsoft Azure 軟體和服務開發相關的基本 AI 概念,以建立 AI 解決方案。
文件
-
快速入門 - 建置最小的 .NET AI RAG 應用程式 - .NET
使用內嵌和適用於 .NET 的 Microsoft.Extensions.VectorData 套件,建立 AI 支援的應用程式來搜尋和整合向量存放區
-
快速入門 - 使用 AI 搭配 .NET 產生影像 - .NET
建立一個使用 .NET 和 OpenAI 或 Azure OpenAI 模型來生成圖像的簡單應用程式。
-
快速入門 - 使用 .NET 建置 AI 聊天應用程式 - .NET
使用適用於 .NET 的 Semantic Kernel SDK 和 OpenAI 或 Azure OpenAI SDK 建立簡單的 AI 支援聊天應用程式