.NET에서 AI를 사용하여 이미지 생성
단순한 .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를 사용하는 방법을 알아봅니다.
필수 조건
- .NET 8 SDK - .NET 8 SDK를 설치합니다.
- Azure 구독 – 체험 구독을 만듭니다.
- Azure OpenAI 서비스에 액세스합니다.
- Azure 개발자 CLI(선택 사항) - Azure Developer CLI를 설치하거나 업데이트합니다.
샘플 프로젝트 가져오기
샘플 리포지토리 복제
앞의 섹션의 단계를 사용하여 고유한 앱을 만들거나 모든 빠른 시작에 대해 완료된 샘플 앱이 포함된 GitHub 리포지토리를 복제할 수 있습니다. Azure OpenAI를 사용하려는 경우 샘플 리포지토리는 Azure OpenAI 리소스를 프로비전할 수 있는 Azure 개발자 CLI 템플릿으로도 구성됩니다.
git clone https://github.com/dotnet/ai-samples.git
Azure OpenAI 서비스 만들기
- Azure Developer CLI
- Azure CLI
- Azure Portal
샘플 GitHub 리포지토리는 Azure OpenAI 서비스 및 모델을 프로비전하는 데 사용할 수 있는 azd
Azure 개발자 CLI(azd
) 템플릿으로 구성됩니다.
터미널 또는 명령 프롬프트에서 샘플 리포지토리의 디렉터리로 이동합니다
src\quickstarts\azure-openai
.명령을
azd up
실행하여 Azure OpenAI 리소스를 프로비전합니다. Azure OpenAI 서비스를 만들고 모델을 배포하는 데 몇 분 정도 걸릴 수 있습니다.azd up
azd
또한 Azure OpenAI 엔드포인트 및 모델 이름과 같은 샘플 앱에 필요한 사용자 비밀을 구성합니다.
하이킹 이미지 샘플 사용해 보기
리포지토리 복제: dotnet/ai-samples
다음 명령을 실행하여 OpenAI API 키를 샘플 앱의 비밀로 구성합니다.
dotnet user-secrets init dotnet user-secrets set OpenAIKey <your-openai-key>
dotnet run
명령을 사용하여 앱을 실행합니다.dotnet run
터미널이나 명령 프롬프트에서
azure-openai\semantic-kernel\05-HikeImages
디렉터리로 이동합니다.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"];
AzureOpenAITextToImageService
서비스는 요청과 응답을 편리하게 수행할 수 있습니다.
AzureOpenAITextToImageService textToImageService = new(deployment, endpoint, new DefaultAzureCredential(), 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은 디지털 서명되지 않았습니다. 스크립트가 시스템에서 실행되지 않습니다.
애플리케이션에 사용되는 .NET 사용자 비밀을 설정하기 위해 postprovision.ps1 스크립트가 실행됩니다. 이 오류를 방지하려면 다음 PowerShell 명령을 실행합니다.
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
그런 다음 azd up
명령을 다시 실행합니다.
발생할 수 있는 다른 오류:
'pwsh'가 내부 또는 외부 명령, 실행 가능한 프로그램 또는 배치 파일로 인식되지 않습니다. 경고: 종료 코드: '1', 경로: '.\infra\post-script\postprovision.ps1'으로 인해 'postprovision' 후크가 실패했습니다. : 종료 코드: 1 ContinueOnError가 true로 설정되었으므로 실행이 계속됩니다.
애플리케이션에 사용되는 .NET 사용자 비밀을 설정하기 위해 postprovision.ps1 스크립트가 실행됩니다. 이 오류를 방지하려면 다음 PowerShell 명령을 사용하여 스크립트를 수동으로 실행합니다.
.\infra\post-script\postprovision.ps1
이제 .NET AI 앱에 사용자 암호가 구성되어 테스트할 수 있습니다.
다음 단계
.NET