LUIS 리소스를 만들고 관리하는 방법

Important

LUIS는 2025년 10월 1일에 사용 중지되며 2023년 4월 1일부터 새 LUIS 리소스를 만들 수 없습니다. 지속적인 제품 지원 및 다국어 기능을 활용하려면 LUIS 애플리케이션을 대화 언어 이해로 마이그레이션하는 것이 좋습니다.

이 문서를 사용하여 LUIS와 함께 사용할 수 있는 Azure 리소스 유형 및 관리 방법에 대해 알아봅니다.

작성 리소스

작성 리소스를 사용하여 애플리케이션을 만들고, 관리하고, 학습하고, 테스트하고, 게시할 수 있습니다. LUIS 작성 리소스에 대해 다음을 제공하는 무료(F0) 계층에 하나의 가격 책정 계층 을 사용할 수 있습니다.

• 100만 작성 트랜잭션
• 매월 1,000개의 테스트 예측 엔드포인트 요청.

v3.0 미리 보기 LUIS 프로그래밍 API를 사용하여 제작 리소스를 관리할 수 있습니다.

예측 리소스

예측 리소스를 사용하면 작성 리소스에서 제공한 1,000개 이상의 요청을 초과하여 예측 엔드포인트를 쿼리할 수 있습니다. 예측 리소스에는 다음 두 가지 가격 책정 계층을 사용할 수 있습니다.

• 매월 10,000개의 예측 엔드포인트 요청을 제공하는 무료(F0) 예측 리소스입니다.
• 유료 계층인 표준(S0) 예측 리소스입니다.

v3.0-preview LUIS 엔드포인트 API를 사용하여 예측 리소스를 관리할 수 있습니다.

참고 항목

• 다중 서비스 리소스를 사용하여 여러 Azure AI 서비스에 사용할 수 있는 단일 엔드포인트를 가져올 수도 있습니다.
• LUIS는 두 가지 유형의 F0(무료 계층) 리소스를 제공합니다. 하나는 트랜잭션 작성용이고 다른 하나는 예측 트랜잭션용입니다. 예측 트랜잭션에 대한 무료 할당량이 부족한 경우 매월 1,000개의 예측 트랜잭션을 제공하는 작성 리소스가 아니라 매월 10,000개의 무료 트랜잭션을 제공하는 F0 예측 리소스를 사용하고 있는지 확인합니다.
• 게시하고 쿼리하려는 지역에서 LUIS 앱을 작성해야 합니다.

LUIS 리소스 만들기

LUIS 리소스를 만들려면 LUIS 포털, Azure Portal 또는 Azure CLI를 사용할 수 있습니다. 리소스를 만든 후에는 해당 리소스를 사용하도록 앱에 할당해야 합니다.

LUIS 포털

LUIS 포털을 사용하여 LUIS 작성 리소스 만들기

1. LUIS 포털에 로그인하고, 국가/지역을 선택하고, 사용 약관에 동의합니다. 포털에 My Apps 섹션이 표시되면 LUIS 리소스가 이미 존재하며 다음 단계를 건너뛸 수 있습니다.

2. 표시되는 제작 선택 창에서 Azure 구독 및 LUIS 작성 리소스를 찾습니다. 리소스가 없는 경우 새 리소스 그룹을 만들 수 있습니다.

   

   새 제작 리소스를 만들 때 다음 정보를 제공합니다.

   • 테넌트 이름: Azure 구독이 연결된 테넌트입니다.
   • Azure 구독 이름: 리소스에 대한 요금이 청구되는 구독입니다.
   • Azure 리소스 그룹 이름: 선택하거나 만드는 사용자 지정 리소스 그룹 이름입니다. 리소스 그룹을 사용하면 액세스 및 관리를 위해 Azure 리소스를 그룹화할 수 있습니다.
   • Azure 리소스 이름: 사용자가 선택한 사용자 지정 이름으로, 작성 및 예측 엔드포인트 쿼리에 대한 URL의 일부로 사용됩니다.
   • 가격 책정 계층: 가격 책정 계층은 초당 최대 트랜잭션 수와 월을 결정합니다.

LUIS 포털을 사용하여 LUIS 예측 리소스 만들기

1. 애플리케이션의 관리 탭으로 이동합니다.

2. 왼쪽 탐색 창에서 Azure 리소스를 선택합니다.

3. 예측 리소스 추가 단추를 선택합니다.

   

   예측 리소스가 이미 있는 경우 추가합니다. 그렇지 않으면 새 예측 리소스 만들기를 선택합니다.

   

LUIS 포털이 없는 경우

LUIS 포털을 사용하지 않고 LUIS 리소스 만들기

Azure CLI를 사용하여 각 리소스를 개별적으로 만듭니다.

팁

• 제작 리소스 kind 는 입니다. LUIS.Authoring
• 예측 리소스 kind 는 입니다. LUIS

1. Azure CLI에 로그인합니다.

   az login
   

   이 명령은 올바른 계정을 선택하고 인증을 제공할 수 있도록 브라우저를 엽니다.

2. 이름이 지정된 종류의 LUIS.AuthoringLUIS 제작 리소스를 만듭니다 my-luis-authoring-resource. 해당 지역의 이름이 지정된 my-resource-groupwestus 기존 리소스 그룹에 만듭니다.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. 이름이 지정된 종류의 LUISLUIS 예측 엔드포인트 리소스를 만듭니다 my-luis-prediction-resource. 해당 지역의 이름이 지정된 my-resource-groupwestus 기존 리소스 그룹에 만듭니다. 무료 계층에서 제공하는 것보다 높은 처리량을 원하는 경우 .로 변경 F0 합니다 S0. 가격 책정 계층 및 처리량에 대해 자세히 알아봅니다.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

LUIS 리소스 할당

리소스 만들기는 반드시 사용해야 하는 것을 의미하는 것은 아닙니다. 앱에 할당해야 합니다. 단일 앱 또는 LUIS의 모든 앱에 대한 제작 리소스를 할당할 수 있습니다.

LUIS 포털

LUIS 포털을 사용하여 리소스 할당

모든 앱에 제작 리소스 할당

다음 절차에서는 모든 앱에 작성 리소스를 할당합니다.

1. LUIS 포털에 로그인합니다.
2. 오른쪽 위 모서리에서 사용자 계정을 선택한 다음, 설정 선택합니다.
3. 사용자 설정 페이지에서 작성 리소스 추가를 선택한 다음, 기존 작성 리소스를 선택합니다. 저장을 선택합니다.

특정 앱에 리소스 할당

다음 절차에서는 특정 앱에 리소스를 할당합니다.

1. LUIS 포털에 로그인합니다. 내 앱 목록에서 앱을 선택합니다.

2. 관리>Azure 리소스로 차례로 이동합니다.

   

3. 예측 리소스 또는 작성 리소스 탭에서 예측 리소스 추가 또는 제작 리소스 추가 단추를 선택합니다.

4. 양식의 필드를 사용하여 올바른 리소스를 찾은 다음 저장을 선택합니다.

LUIS 포털이 없는 경우

LUIS 포털을 사용하지 않고 예측 리소스 할당

CI/CD 파이프라인과 같은 자동화된 프로세스의 경우 다음 단계를 사용하여 LUIS 리소스를 LUIS 앱에 할당하는 것을 자동화할 수 있습니다.

1. 영숫자 문자열인 Azure Resource Manager 토큰 을 가져옵니다. 이 토큰은 만료되므로 즉시 사용합니다. 다음 Azure CLI 명령을 사용할 수도 있습니다.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. 토큰을 사용하여 구독 간에 LUIS 런타임 리소스를 요청합니다. API를 사용하여 사용자 계정에 액세스할 수 있는 LUIS Azure 계정을 가져옵니다.

   이 POST API에 필요한 값은 다음과 같습니다.

   헤더	값
   Authorization	Authorization의 값은 Bearer {token}입니다. 토큰 값 앞에 단어 Bearer 와 공백이 있어야 합니다.
   Ocp-Apim-Subscription-Key	작성 키

   API는 LUIS 구독을 나타내는 JSON 개체의 배열을 반환합니다. 반환되는 값에는 AccountName으로 반환되는 구독 ID, 리소스 그룹 및 리소스 이름이 포함됩니다. 배열에서 LUIS 앱에 할당하려는 LUIS 리소스 항목을 찾습니다.

3. 애플리케이션 API에 LUIS Azure 계정 할당을 사용하여 LUIS 리소스에 토큰을 할당합니다.

   이 POST API에 필요한 값은 다음과 같습니다.

   Type	설정	값
   헤더	Authorization	Authorization의 값은 Bearer {token}입니다. 토큰 값 앞에 단어 Bearer 와 공백이 있어야 합니다.
   헤더	Ocp-Apim-Subscription-Key	작성 키
   헤더	Content-type	application/json
   Querystring	appid	LUIS 앱 ID
   본문		{AzureSubscriptionId: 구독 ID, ResourceGroup: 예측 리소스가 있는 리소스 그룹 이름, AccountName: 예측 리소스의 이름}

   이 API가 성공하면 201 - created status를 반환합니다.

리소스 할당 취소

리소스를 할당 취소하면 Azure에서 삭제되지 않습니다. 다만 LUIS에서 연결이 해제될 뿐입니다.

LUIS 포털

LUIS 포털을 사용하여 리소스 할당 취소

1. LUIS 포털에 로그인한 다음 내 앱 목록에서 앱을 선택합니다.
2. Azure 리소스 관리>로 이동합니다.
3. 리소스에 대한 리소스 할당 취소 단추를 선택합니다.

LUIS 포털이 없는 경우

LUIS 포털을 사용하지 않고 예측 리소스 할당 취소

1. 영숫자 문자열인 Azure Resource Manager 토큰 을 가져옵니다. 이 토큰은 만료되므로 즉시 사용합니다. 다음 Azure CLI 명령을 사용할 수도 있습니다.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. 토큰을 사용하여 구독 간에 LUIS 런타임 리소스를 요청합니다. 사용자 계정에 액세스할 수 있는 LUIS Azure 계정 가져오기 API를 사용합니다.

   이 POST API에 필요한 값은 다음과 같습니다.

   헤더	값
   Authorization	Authorization의 값은 Bearer {token}입니다. 토큰 값 앞에 단어 Bearer 와 공백이 있어야 합니다.
   Ocp-Apim-Subscription-Key	작성 키

   API는 LUIS 구독을 나타내는 JSON 개체의 배열을 반환합니다. 반환되는 값에는 AccountName으로 반환되는 구독 ID, 리소스 그룹 및 리소스 이름이 포함됩니다. 배열에서 LUIS 앱에 할당하려는 LUIS 리소스 항목을 찾습니다.

3. 애플리케이션에서 LUIS Azure 계정 할당 취소 API를 사용하여 토큰을 LUIS 리소스에 할당합니다.

   이 DELETE API에 필요한 값은 다음과 같습니다.

   Type	설정	값
   헤더	Authorization	Authorization의 값은 Bearer {token}입니다. 토큰 값 앞에 단어 Bearer 와 공백이 있어야 합니다.
   헤더	Ocp-Apim-Subscription-Key	작성 키
   헤더	Content-type	application/json
   Querystring	appid	LUIS 앱 ID
   본문		{AzureSubscriptionId: 구독 ID, ResourceGroup: 예측 리소스가 있는 리소스 그룹 이름, AccountName: 예측 리소스의 이름}

   이 API가 성공하면 200 - OK status를 반환합니다.

리소스 소유권

LUIS 리소스와 같은 Azure 리소스는 리소스를 포함하는 구독에서 소유합니다.

리소스 소유권을 변경하려면 다음 작업 중 하나를 수행할 수 있습니다.

• 구독의 소유권을 이전합니다.
• LUIS 앱을 파일로 내보낸 다음, 다른 구독에서 앱을 가져옵니다. 내보내기는 LUIS 포털의 내 앱 페이지에서 사용할 수 있습니다.

리소스 제한

키 만들기 제한 작성

구독당 지역당 10개의 작성 키를 만들 수 있습니다. 게시 지역은 작성 지역과 다릅니다. 클라이언트 애플리케이션을 배치하려는 게시 지역에 해당하는 앱을 작성 지역에 만들어야 합니다. 제작 지역이 게시 지역에 매핑되는 방법에 대한 자세한 내용은 작성 및 게시 지역을 참조 하세요.

자세한 내용은 리소스 제한을 참조하세요.

주요 사용량 제한에 대한 오류

사용량 제한은 가격 책정 계층을 기반으로 합니다.

TPS(초당 트랜잭션 수) 할당량을 초과하는 경우 HTTP 429 오류가 표시됩니다. TPM(월별 트랜잭션 수) 할당량을 초과하면 HTTP 403 오류가 발생합니다.

가격 책정 계층 변경

1. Azure Portal에서 모든 리소스로 이동하여 리소스를 선택합니다.

   

2. 왼쪽 메뉴에서 가격 책정 계층을 선택하여 사용 가능한 가격 책정 계층을 확인합니다.

3. 원하는 가격 책정 계층을 선택하고, 선택을 클릭하여 변경 내용을 저장합니다. 가격 책정 변경이 완료되면 가격 책정 계층 업데이트가 포함된 알림이 오른쪽 위에 표시됩니다.

Azure 리소스 메트릭 보기

Azure 리소스 사용량 요약 보기

Azure Portal에서 LUIS 사용량 정보를 볼 수 있습니다. 개요 페이지에는 최근 호출 및 오류를 포함한 요약이 표시됩니다. LUIS 엔드포인트 요청을 만드는 경우 변경 내용이 표시되도록 최대 5분 동안 허용합니다.

Azure 리소스 사용 현황 차트 사용자 지정

메트릭 페이지는 데이터에 대한 자세한 보기를 제공합니다. 특정 기간 및 메트릭에 대한 메트릭 차트를 구성할 수 있습니다.

총 트랜잭션 임계값 경고

특정 트랜잭션 임계값(예: 10,000개 트랜잭션)에 도달하면 경고를 만들 수 있습니다.

1. 왼쪽 메뉴에서 경고를 선택합니다.

2. 위쪽 메뉴에서 새 경고 규칙 선택

   

3. 조건 추가를 선택합니다.

   

4. 총 호출 선택

   

5. 경고 논리 섹션까지 아래로 스크롤하여 원하는 대로 특성을 설정하고 완료를 클릭합니다.

   

6. 경고 규칙 트리거 시 알림을 보내거나 작업을 호출하려면 작업 섹션으로 이동하여 작업 그룹을 추가합니다.

   

제작 키 다시 설정

마이그레이션된 제작 리소스 앱의 경우: 작성 키가 손상된 경우 Azure Portal의 작성 리소스에 대한 키 페이지에서 키를 다시 설정합니다.

마이그레이션되지 않은 앱의 경우: LUIS 포털의 모든 앱에서 키가 다시 설정됩니다. 작성 API를 통해 앱을 작성하는 경우 Ocp-Apim-Subscription-Key 값을 새 키로 변경해야 합니다.

Azure 키 다시 생성

Azure Portal의 키 페이지에서 Azure 키를 다시 생성할 수 있습니다.

앱 소유권, 액세스 및 보안

앱은 소유자의 구독에 의해 결정되는 Azure 리소스에 의해 정의됩니다.

LUIS 앱을 이동할 수 있습니다. 다음 리소스를 사용하여 Azure Portal 또는 Azure CLI를 사용하여 이 작업을 수행할 수 있습니다.

• LUIS 작성 리소스 간에 앱 이동
• 리소스를 새 리소스 그룹 또는 구독으로 이동
• 동일한 구독 내에서 또는 구독 간에 리소스 이동

다음 단계

• 앱 수명 주기를 제어하도록 버전을 사용하는 방법을 알아봅니다.