Azure OpenAI를 사용하여 리소스 만들기 및 모델 배포
이 문서에서는 리소스를 만들고 모델을 배포하는 단계별 지침을 사용하여 Azure OpenAI를 시작합니다. 리소스 만들기 및 모델 배포 단계는 몇 분 내에 완료할 수 있지만, 실제 배포 프로세스 자체에는 1시간 넘게 걸릴 수 있습니다. 배포가 완료될 때까지 적극적으로 기다리지 않고 리소스를 만들고, 배포를 시작한 다음, 나중에 배포에서 다시 체크 인할 수 있습니다.
필수 구성 요소
Azure 구독 - 체험 구독 만들기
원하는 Azure 구독의 Azure OpenAI에 부여된 액세스 권한
현재 이 서비스에 대한 액세스 권한은 애플리케이션에서만 부여됩니다. https://aka.ms/oai/access에서 양식을 작성하여 Azure OpenAI에 대한 액세스를 신청할 수 있습니다. 문제가 있는 경우 이 리포지토리에서 문제를 엽니다.
리소스 만들기
Azure의 리소스는 다음과 같이 여러 가지 방법으로 만들 수 있습니다.
- Azure Portal 내에서
- REST API, Azure CLI, PowerShell 또는 클라이언트 라이브러리를 사용하여
- ARM 템플릿을 통해
이 가이드에서는 Azure Portal 만들기 환경을 안내합니다.
Azure OpenAI Service 만들기 페이지로 이동합니다.
만들기 페이지에서 다음 정보를 제공합니다.
필드 Description 구독 OpenAI 온보딩 애플리케이션에 사용되는 Azure 구독을 선택합니다. 리소스 그룹 OpenAI 리소스를 포함할 Azure 리소스 그룹입니다. 새 그룹을 만들거나 기존 그룹에 추가할 수 있습니다. 지역 인스턴스의 위치입니다. 다른 위치를 사용하면 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다. 이름 Cognitive Services 리소스를 설명하는 이름입니다. 예를 들어 MyOpenAIResource입니다. 가격 책정 계층 현재 서비스에는 하나의 가격 책정 계층만 사용할 수 있습니다. 
모델 배포
텍스트 또는 추론을 생성하려면 먼저 모델을 배포해야 합니다. Azure OpenAI Studio에서 사용 가능한 여러 모델 중 하나를 선택할 수 있습니다.
Davinci는 가장 뛰어난 모델 제품군이며, 다른 모델에서 수행할 수 있는 모든 작업을 수행할 수 있고, 종종 더 적은 지침으로 수행할 수 있습니다. 특정 대상 그룹에 대한 요약 및 창의적인 콘텐츠 생성과 같이 콘텐츠에 대한 많은 이해가 필요한 애플리케이션의 경우 Davinci는 최상의 결과를 생성합니다.
모델을 배포하려면 다음 단계를 수행합니다.
Azure OpenAI Studio에 로그인합니다.
작업할 구독 및 OpenAI 리소스를 선택합니다.
배포 및 모델 관리에서 리소스에서 배포 관리>배포로 이동을 선택합니다. 먼저 방문 페이지에서 아래로 스크롤해야 할 수 있습니다.
관리>배포 페이지에서 새 배포 만들기를 선택합니다.
드롭다운에서 모델을 선택합니다. 미국 동부 지역에서 시작하려면
text-davinci-003모델을 사용하는 것이 좋습니다. 다른 지역에서는text-davinci-002모델로 시작하는 것이 좋습니다. 일부 모델은 일부 지역에서만 사용할 수 있습니다. 지역당 사용 가능한 모델 목록은 모델 요약 테이블 및 지역 가용성을 참조하세요.모델을 식별하는 데 도움이 되는 모델 이름을 입력합니다. 신중하게 이름을 선택합니다. 모델 이름은 OpenAI 클라이언트 라이브러리 및 API를 통해 배포 이름으로 사용됩니다.
만들기를 선택하여 모델을 배포합니다.
배포 테이블은 새로 만든 이 모델에 해당하는 새 항목을 표시합니다. 배포가 완료되고 사용할 준비가 되면 배포 상태 성공으로 전환됩니다.
필수 구성 요소
Azure 구독 - 체험 구독 만들기
원하는 Azure 구독의 Azure OpenAI에 부여된 액세스 권한
현재 이 서비스에 대한 액세스 권한은 애플리케이션에서만 부여됩니다. https://aka.ms/oai/access에서 양식을 작성하여 Azure OpenAI 서비스에 대한 액세스를 신청할 수 있습니다. 문제가 있는 경우 이 리포지토리에서 문제를 엽니다.
Azure CLI. 설치 가이드
CLI에 로그인
az login 명령을 실행하여 로그인합니다(az login).
새 Azure 리소스 그룹 만들기
OpenAI 리소스를 만들려면 Azure 리소스 그룹이 있어야 합니다. 새 리소스 그룹을 만들 때 새 리소스 그룹을 만들 수도 있고 기존 리소스 그룹을 사용할 수도 있습니다. 이 문서에서는 새 리소스 그룹을 만드는 방법을 보여줍니다. az group create 명령을 사용하여 Azure CLI에서 새 리소스 그룹을 만들 수 있습니다. 아래 예제에서는 새 리소스 그룹을 eastus 위치에 만듭니다. 여기서 전체 참조 설명서를 찾을 수 있습니다.
az group create \
--name OAIResourceGroup \
--location eastus
리소스 만들기
다음 명령을 실행하여 OpenAI 리소스를 새 리소스 그룹에 만듭니다. 다음 예제에서는 MyOpenAIResource라는 리소스를 OAIResourceGroup이라는 리소스 그룹에 만듭니다. 리소스 그룹, 리소스 이름 및 Azure 구독 ID에 대한 사용자 고유의 값으로 업데이트해야 합니다. 여기서 전체 참조 설명서를 찾을 수 있습니다.
az cognitiveservices account create \
-n MyOpenAIResource \
-g OAIResourceGroup \
-l eastus \
--kind OpenAI \
--sku s0 \
--subscription 00000000-0000-0000-0000-000000000000
리소스에서 정보 검색
리소스가 만들어지면 Azure CLI를 사용하여 REST API 엔드포인트 기본 URL 및 액세스 키와 같은 서비스에 대한 유용한 정보를 찾을 수 있습니다. 다음은 두 작업을 모두 수행하는 방법에 대한 예제입니다. 여기서 전체 참조 설명서를 찾을 수 있습니다.
엔드포인트 검색:
az cognitiveservices account show \ -n $myResourceName \ -g $myResourceGroupName \ | jq -r .properties.endpoint기본 API 키 검색:
az cognitiveservices account keys list \ -n $myResourceName \ -g $myResourceGroupName | jq -r .key1
모델 배포
모델을 배포하려면 Azure CLI에서 다음 명령을 실행하여 text-curie-001 인스턴스를 배포할 수 있습니다. 다음 예제에서는 MyModel이라는 모델을 배포합니다. 사용자 고유의 값으로 업데이트해야 합니다. model-version, model-format 또는 scale-settings-scale-type 값은 변경할 필요가 없습니다. 여기서 전체 참조 설명서를 찾을 수 있습니다.
az cognitiveservices account deployment create \
-g $myResourceGroupName \
-n $myResourceName \
--deployment-name MyModel \
--model-name text-curie-001 \
--model-version "1" \
--model-format OpenAI \
--scale-settings-scale-type "Standard"
리소스에서 모델 삭제
리소스에서 배포한 모든 모델을 삭제할 수 있습니다. 이렇게 하려면 Azure CLI를 사용하여 다음 명령을 실행할 수 있습니다. 다음 예제에서는 MyModel이라는 모델을 삭제합니다. 사용자 고유의 값으로 업데이트해야 합니다. 여기서 전체 참조 설명서를 찾을 수 있습니다.
az cognitiveservices account deployment delete \
-g $myResourceGroupName \
-n $myResourceName \
--deployment-name MyModel
리소스 삭제
OpenAI 리소스를 정리하고 제거하려는 경우 해당 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 그룹에 포함된 모든 리소스가 함께 삭제됩니다.
리소스 그룹 및 관련 리소스를 제거하려면 az group delete 명령을 사용합니다.
이 애플리케이션을 사용하지 않으려면 다음 단계에 따라 리소스를 삭제합니다.
az cognitiveservices account delete \
--name MyOpenAIResource \
-g OAIResourceGroup
다음 단계
- 이제 리소스가 있고 첫 번째 모델을 배포했으므로 빠른 시작을 사용하여 API 호출 및 텍스트 만들기를 시작합니다.
- Azure OpenAI를 지원하는 기본 모델에 대해 자세히 알아봅니다.