빠른 시작: Azure Portal을 사용하여 Cognitive Services 리소스 만들기

  • 아티클

이 빠른 시작을 사용하여 Cognitive Services 리소스를 만듭니다. Azure Portal에서 Cognitive Service 리소스를 만든 후에는 애플리케이션을 인증하는 데 사용할 엔드포인트와 키를 가져옵니다.

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

Cognitive Services 리소스 형식

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

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

사전 요구 사항

  • 유효한 Azure 구독 - 체험 구독 만들기.
  • 책임 있는 AI 조건에 동의하고 리소스를 만들려면 Azure 계정에 Cognitive Services 기여자 역할이 할당되어 있어야 합니다. 이 역할을 계정에 할당하려면 역할 할당의 단계를 수행하거나 관리자에게 문의하세요.

새 Azure Cognitive Services 리소스 만들기

다중 서비스 리소스의 이름은 포털에서 Cognitive Services로 지정됩니다. 다중 서비스 리소스를 사용하여 다음 Cognitive Services에 액세스할 수 있습니다.

  • 결정 - Content Moderator
  • 언어 - 언어, Translator
  • 음성 - 음성
  • Vision - Computer Vision, Custom Vision, Form Recognizer, Face

  1. 이 링크를 선택하여 Azure Cognitive 다중 서비스 리소스를 만들 수 있습니다. Cognitive Services 리소스 만들기

  2. 만들기 페이지에서 다음 정보를 제공합니다.

    프로젝트 세부 정보 Description
    구독 사용 가능한 Azure 구독 중 하나를 선택합니다.
    리소스 그룹 Cognitive Services 리소스를 포함할 Azure 리소스 그룹입니다. 새 그룹을 만들거나 기존 그룹에 추가할 수 있습니다.
    지역 Cognitive Service 인스턴스의 위치입니다. 다른 위치를 사용하면 대기 시간이 발생할 수 있지만 리소스의 런타임 가용성에는 영향을 주지 않습니다.
    이름 Cognitive Services 리소스를 설명하는 이름입니다. 예: MyCognitiveServicesResource.
    가격 책정 계층 Cognitive Services 계정의 비용은 선택한 옵션 및 사용량에 따라 다릅니다. 자세한 내용은 API 가격 책정 세부 정보를 참조하세요.

    다중 서비스 리소스 만들기 화면

  3. 필요에 따라 리소스에 대한 다른 설정을 구성하고 조건을 읽고 수락한 다음(해당하는 경우) 검토 + 만들기를 선택합니다.

팁

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

리소스의 키 가져오기

  1. 리소스가 성공적으로 배포되면 다음 단계>리소스로 이동을 선택합니다.

    리소스 키 가져오기 화면

  2. 열리는 빠른 시작 창에서 리소스 엔드포인트에 액세스하고 키를 관리할 수 있습니다.

인증을 위한 환경 변수 구성

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어, 리소스에 대한 키를 얻은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

팁

키를 코드에 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. COGNITIVE_SERVICE_KEY 환경 변수를 설정하려면 your-key를 리소스의 키 중 하나로 바꿉니다.

setx COGNITIVE_SERVICE_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에 액세스하면 되는 경우 setx 대신 set를 사용하여 환경 변수를 설정할 수 있습니다.

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

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 따릅니다. COGNITIVE_SERVICE_REGION을 해당 리소스의 지역으로 설정합니다. 예들 들어 westus입니다.

리소스 정리

Cognitive Services 구독을 정리하고 제거하려면 리소스나 리소스 그룹을 삭제하면 됩니다. 리소스 그룹을 삭제하면 그룹에 포함된 모든 리소스가 함께 삭제됩니다.

  1. Azure Portal에서 왼쪽의 메뉴를 확장하여 서비스 메뉴를 열고 리소스 그룹을 선택하여 리소스 그룹 목록을 표시합니다.
  2. 삭제할 리소스가 포함된 리소스 그룹을 찾습니다.
  3. 전체 리소스 그룹을 삭제하려면 리소스 그룹 이름을 선택합니다. 다음 페이지에서 리소스 그룹 삭제를 선택하고 확인합니다.
  4. Cognitive Service 리소스만 삭제하려면 리소스 그룹을 선택하여 해당 리소스 내의 모든 리소스를 확인합니다. 다음 페이지에서 삭제할 리소스를 선택하고 해당 행의 줄임표 메뉴를 선택한 다음, 삭제를 선택합니다.

삭제된 리소스를 복구해야 하는 경우 삭제된 Cognitive Services 리소스 복구를 참조하세요.

참고 항목