빠른 시작: Azure CLI(명령줄 인터페이스)를 사용하여 Cognitive Services 리소스 만들기

Azure CLI(명령줄 인터페이스)를 사용하여 Azure Cognitive Services를 시작하려면 이 빠른 시작을 참조하세요.

Azure Cognitive Services는 REST API가 있는 클라우드 기반 서비스이며, 개발자가 직접적인 AI(인공 지능) 또는 데이터 과학 기술이나 지식 없이도 인지적 인텔리전스를 애플리케이션에 빌드하도록 지원하는 데 사용할 수 있는 클라이언트 라이브러리 SDK입니다. Azure Cognitive Services를 사용하는 개발자는 보고, 듣고, 말하고, 이해하고, 추론할 수도 있는 인지적 솔루션을 통해 애플리케이션에 인지적 기능을 손쉽게 추가할 수 있습니다.

Cognitive Services는 Azure 구독에서 만든 Azure 리소스로 표시됩니다. 리소스를 만든 후에는 자동으로 생성된 키와 엔드포인트를 사용하여 애플리케이션을 인증합니다.

이 빠른 시작에서는 Azure Cognitive Services에 가입한 후 Azure CLI(명령줄 인터페이스)를 사용하여 단일 서비스 또는 다중 서비스 구독이 있는 계정을 만드는 방법을 알아봅니다. 이러한 서비스는 하나 이상의 Azure Cognitive Services API에 연결할 수 있는 Azure 리소스로 표시됩니다.

다음과 같이 서로 다른 두 리소스를 통해 Azure Cognitive Services에 액세스할 수 있습니다. 다중 서비스 리소스 또는 단일 서비스 리소스

  • 다중 서비스 리소스
    • 단일 키와 엔드포인트로 여러 Azure Cognitive Services에 액세스합니다.
    • 사용하는 서비스의 청구를 통합합니다.
  • 단일 서비스 리소스
    • 만든 각 서비스에 대해 고유한 키와 엔드포인트를 사용하여 단일 Azure Cognitive Service에 액세스합니다.
    • 무료 계층을 사용하여 서비스를 사용해 봅니다.

사전 요구 사항

Azure CLI 설치 및 로그인

Azure CLI를 설치합니다. 로컬에 설치된 CLI로 로그인하려면 az login 명령을 실행합니다.

az login

녹색 사용해 보기 단추를 사용하여 브라우저에서 이 명령을 실행할 수도 있습니다.

새 Azure Cognitive Services 리소스 그룹 만들기

Cognitive Services 리소스를 만들려면 리소스를 포함할 Azure 리소스 그룹이 있어야 합니다. 새 리소스 그룹을 만들 때 새 리소스 그룹을 만들 수도 있고 기존 리소스 그룹을 사용할 수도 있습니다. 이 문서에서는 새 리소스 그룹을 만드는 방법을 보여줍니다.

리소스 그룹 위치 선택

리소스를 만들려면 구독에 사용할 수 있는 Azure 위치 중 하나가 필요합니다. az account list-locations 명령으로 사용 가능한 지역 목록을 검색할 수 있습니다. 대부분의 Cognitive Services는 여러 위치에서 액세스할 수 있습니다. 가장 가까운 위치를 선택하거나 서비스에 사용할 수 있는 위치를 확인합니다.

중요

  • Azure Cognitive Services를 호출할 때 필요하므로 Azure 위치를 기억해 두어야 합니다.
  • 일부 Cognitive Services의 가용성은 지역에 따라 다를 수 있습니다. 자세한 내용은 지역별 Azure 제품을 참조하세요.
az account list-locations \
    --query "[].{Region:name}" \
    --out table

Azure 위치를 선택한 후에는 Azure CLI에서 az group create 명령을 사용하여 새 리소스 그룹을 만듭니다.

아래 예제에서 Azure 위치 westus2를 구독에 사용할 수 있는 Azure 위치 중 하나로 바꿉니다.

az group create \
    --name cognitive-services-resource-group \
    --location westus2

Cognitive Services 리소스 만들기

Cognitive Services 및 가격 책정 계층 선택

새 리소스를 만들 때 원하는 가격 책정 계층(또는 SKU)과 함께 사용할 서비스의 "종류"를 알아야 합니다. 리소스를 만들 때 이 정보와 기타 정보를 매개 변수로 사용합니다.

다중 서비스

서비스 종류
여러 서비스. 자세한 내용은 가격 책정 페이지를 참조하세요. CognitiveServices

참고

아래의 Cognitive Services 중 상당수는 서비스 체험용으로 체험 계층을 제공합니다. 체험 계층을 사용하려면 리소스의 SKU로 F0을 사용합니다.

Vision

서비스 종류
Computer Vision ComputerVision
Custom Vision - 예측 CustomVision.Prediction
Custom Vision - 학습 CustomVision.Training
Face Face
Form Recognizer FormRecognizer
Ink Recognizer InkRecognizer

음성

서비스 종류
Speech Services SpeechServices
음성 인식 SpeakerRecognition

언어

서비스 종류
양식 이해 FormUnderstanding
LUIS LUIS
QnA Maker QnAMaker
텍스트 분석 TextAnalytics
텍스트 번역 TextTranslation

의사 결정

서비스 종류
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

az cognitiveservices account list-kinds 명령으로 사용 가능한 Cognitive Service "종류" 목록을 찾을 수 있습니다.

az cognitiveservices account list-kinds

리소스 그룹에 새 리소스 추가

새 Cognitive Services 리소스를 만들고 구독하려면 az cognitiveservices account create 명령을 사용합니다. 이 명령은 앞에서 만든 리소스 그룹에 요금이 발생할 수 있는 새 리소스를 추가합니다. 새 리소스를 만들 때 가격 책정 계층(또는 SKU) 및 Azure 위치와 함께 사용할 서비스의 "종류"를 알아야 합니다.

아래 명령을 사용하여 anomaly-detector-resource라는 Anomaly Detector에 사용할 F0(체험) 리소스를 만들 수 있습니다.

az cognitiveservices account create \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --kind AnomalyDetector \
    --sku F0 \
    --location westus2 \
    --yes

구독에서 Cognitive Service 리소스 만들기를 허용하지 않는 경우 Azure Portal, PowerShell 명령 또는 Azure CLI 명령을 사용하여 Azure 리소스 공급자의 해당 기능을 사용하도록 설정해야 할 수도 있습니다. 구독 소유자가 아닌 경우 구독 소유자 또는 관리자 역할이 있는 사용자에게 대신 등록을 완료해 달라고 요청하거나 계정에 /register/action 권한을 부여해 달라고 요청하세요.

리소스의 키 가져오기

로컬에 설치된 CLI(명령줄 인터페이스)로 로그인하려면 az login 명령을 사용합니다.

az login

az cognitiveservices account keys list 명령을 사용하여 Cognitive Service 리소스의 키를 가져옵니다.

    az cognitiveservices account keys list \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group

인증을 위한 환경 변수 구성

애플리케이션은 사용하는 Cognitive Services에 대한 액세스를 인증해야 합니다. 인증하려면 Azure 리소스의 키를 저장할 환경 변수를 만드는 것이 좋습니다.

키를 받으면 애플리케이션을 실행하는 로컬 머신의 새 환경 변수에 씁니다. 환경 변수를 설정하려면 콘솔 창을 열고 사용 중인 운영 체제의 지침을 따릅니다. your-key를 리소스의 키 중 하나로 바꿉니다.

setx COGNITIVE_SERVICE_KEY "your-key"

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

가격 책정 계층 및 요금 청구

가격 책정 계층(및 청구되는 금액)은 인증 정보를 사용하여 전송하는 트랜잭션 수를 기반으로 합니다. 각 가격 책정 계층은 다음을 지정합니다.

  • 초당 허용되는 최대 트랜잭션 수(TPS)입니다.
  • 가격 책정 계층 내에서 사용하도록 설정된 서비스 기능입니다.
  • 미리 정의된 트랜잭션 수에 대한 비용입니다. 이 숫자를 초과하면 해당 서비스의 가격 책정 정보에 지정된 대로 추가 요금이 발생합니다.

리소스의 현재 할당량 사용 정보 가져오기

Cognitive Service 리소스 사용량 정보를 확인하려면 az cognitiveservices account list-usage 명령을 사용합니다.

az cognitiveservices account list-usage \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --subscription subscription-name

리소스 정리

Cognitive Services 리소스를 정리하고 제거하려면 해당 리소스 또는 리소스 그룹을 삭제하면 됩니다. 리소스 그룹을 삭제하면 그룹에 포함된 모든 리소스가 함께 삭제됩니다.

리소스 그룹과 관련 리소스를 제거하려면 az group delete 명령을 사용합니다.

az group delete --name cognitive-services-resource-group

참고 항목