搭配使用 AI 和 .NET 生成图像

通过创建简单的 .NET 8 控制台聊天应用程序,开始使用 AI。 应用程序将在本地运行,并使用 OpenAI dall-e-3 模型生成明信片图像,以便你可以邀请朋友们去徒步旅行! 按照以下步骤访问 OpenAI,并了解如何使用语义内核。

先决条件

  • .NET 8.0 SDK - 安装 .NET 8.0 SDK
  • OpenAI 的 API 密钥,可以用于运行此示例。
  • 在 Windows 上,必须安装 PowerShell v7+。 若要验证版本,请在终端中运行 pwsh。 它应返回当前版本。 如果返回错误,请执行以下命令 dotnet tool update --global PowerShell

通过创建简单的 .NET 8 控制台聊天应用程序,开始使用 AI。 应用程序将在本地运行,并使用 OpenAI dall-e-3 模型生成明信片图像,以便你可以邀请朋友们去徒步旅行! 按照以下步骤预配 Azure OpenAI,并了解如何使用 .NET Azure OpenAI SDK。

先决条件

获取示例项目

克隆 GitHub 存储库,其中包含用于所有快速入门的示例应用:

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

创建 Azure OpenAI 服务

示例 GitHub 存储库构造为 Azure Developer CLI (azd) 模板,azd 可以使用此模板为你预配 Azure OpenAI 服务和模型。

  1. 从终端或命令提示符导航到示例存储库的 src\quickstarts\azure-openai 目录。

  2. 运行 azd up 命令来预配 Azure OpenAI 资源。 创建 Azure OpenAI 服务并部署模型可能需要几分钟。

    azd up
    

    azd 还为示例应用配置所需的用户机密,例如 OpenAI 访问密钥。

    注意

    如果在 azd up 部署期间遇到错误,请访问故障排除部分。

尝试使用徒步旅行图像示例

  1. 克隆存储库:dotnet/ai-samples

  2. 运行以下命令,将 OpenAI API 密钥配置为示例应用的机密:

    dotnet user-secrets init
    dotnet user-secrets set OpenAIKey <your-openai-key>
    
  3. 使用 dotnet run 命令运行应用:

    dotnet run
    
  1. 在终端或命令提示符下,导航到 azure-openai\05-HikeImages 目录。

  2. 使用 dotnet run 命令运行应用:

    dotnet run
    

    提示

    如果收到错误消息,表明 Azure OpenAI 资源可能尚未完成部署。 等待几分钟,然后重试。

浏览代码

应用程序使用 Microsoft.SemanticKernel 包向 OpenAI 服务发送和接收请求。

Program.cs 文件包含所有应用代码。 前几行代码设置配置值,并获取以前使用 dotnet user-secrets 命令设置的 OpenAI 密钥。

var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string key = config["OpenAIKey"];

OpenAITextToImageService 服务有助于请求和响应。

OpenAITextToImageService textToImageService = new(key, null);

应用程序使用 Microsoft.SemanticKernel 包向 Azure OpenAI 服务发送和接收请求。

Program.cs 文件包含所有应用代码。 前几行代码加载在应用程序预配期间在 dotnet user-secrets 中设置的机密和配置值。

// Retrieve the local secrets saved during the Azure deployment
var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string endpoint = config["AZURE_OPENAI_ENDPOINT"];
string deployment = config["AZURE_OPENAI_GPT_NAME"];
string key = config["AZURE_OPENAI_KEY"];

AzureOpenAITextToImageService 服务有助于请求和响应。

AzureOpenAITextToImageService textToImageService = new(deployment, endpoint, key, null);

通过添加系统提示向模型提供上下文和说明。 一个优秀的图像生成提示需要明确描述图像的内容、所需使用的颜色、预期的风格以及其他描述信息。

GenerateImageAsync 函数指示模型根据用户提示、图像大小和质量配置生成响应。

// Generate the image
string imageUrl = await textToImageService.GenerateImageAsync("""
    A postal card with a happy hiker waving and a beautiful mountain in the background.
    There is a trail visible in the foreground.
    The postal card has text in red saying: 'You are invited for a hike!'
    """, 1024, 1024);

Console.WriteLine($"The generated image is ready at:\n{imageUrl}");

自定义提示以对模型生成的图像进行个性化设置。

清理资源

不再需要示例应用程序或资源时,请删除相应的部署和所有资源。

azd down

疑难解答

在 Windows 上,运行 azd up 后,可能会收到以下错误消息:

postprovision.ps1 未进行数字签名。 该脚本不会在系统上执行

执行脚本 postprovision.ps1 以设置应用程序中使用的 .NET 用户机密。 若要避免此错误,请运行以下 PowerShell 命令:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

然后,重新运行 azd up 命令。

另一个可能的错误:

“pwsh”没有被识别为内部或外部命令、可运行程序或批处理文件。 警告:“postprovision”挂钩失败,退出代码为“1”,路径:“.\infra\post-script\postprovision.ps1”。 :退出代码:1 执行将继续,因为 ContinueOnError 已设置为 true。

执行脚本 postprovision.ps1 以设置应用程序中使用的 .NET 用户机密。 若要避免此错误,请使用以下 PowerShell 命令手动运行脚本:

.\infra\post-script\postprovision.ps1

.NET AI 应用现已配置用户机密,可以对其进行测试。

后续步骤