LUIS(Language Understanding)용 SDK, REST 및 CLI 개발자 리소스

  • 아티클

Important

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

SDK, REST API, CLI는 프로그래밍 언어로 LUIS(Language Understanding) 앱을 개발하는 데 도움이 됩니다. Azure 리소스 및 LUIS 예측을 관리합니다.

Azure 리소스 관리

Azure AI 서비스 관리 계층을 사용하여 Language Understanding 또는 Azure AI 서비스 리소스를 만들고, 편집하고, 나열하고, 삭제할 수 있습니다.

도구를 기반으로 참조 설명서를 찾습니다.

Language Understanding 작성 및 예측 요청

Language Understanding 서비스는 만들어야 하는 Azure 리소스에서 액세스합니다. 두 가지 리소스가 있습니다.

  • 학습에 제작 리소스를 사용하여 만들고, 편집하고, 학습하고, 게시합니다.
  • 런타임에 대한 예측을 사용하여 사용자의 텍스트를 보내고 예측을 받습니다.

Azure AI 서비스 샘플 코드를 사용하여 가장 일반적인 작업을 학습하고 사용합니다.

REST 사양

LUIS REST 사양은 모든 Azure REST 사양과 함께 GitHub에서 공개적으로 사용할 수 있습니다.

REST API

작성 및 예측 엔드포인트 API는 모두 REST API에서 사용할 수 있습니다.

Type 버전
작성 V2
미리 보기 V3
예측 V2
V3

REST 엔드포인트

LUIS에는 현재 2가지 유형의 엔드포인트가 있습니다.

  • 학습 엔드포인트의 작성
  • 런타임 엔드포인트에 대한 쿼리 예측 입니다.
목적 URL
학습 엔드포인트에 대한 V2 작성 https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
학습 엔드포인트에 대한 V3 작성 https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
V2 예측 - 런타임 엔드포인트의 모든 예측 https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
V3 예측 - 런타임 엔드포인트에서의 버전 예측 https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
V3 예측 - 런타임 엔드포인트의 슬롯 예측 https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

다음 표에서는 이전 표에서 중괄호로 표시된 매개 변수에 대해 설명합니다 {}.

매개 변수 목적
your-resource-name Azure 리소스 이름
q 또는 query 챗봇과 같은 클라이언트 애플리케이션에서 보낸 발화 텍스트
version 10자 버전 이름
slot production 또는 staging

REST 쿼리 문자열 매개 변수

V3 API 쿼리 문자열 매개 변수는 다음과 같습니다.

쿼리 매개 변수 LUIS 포털 이름 Type 버전 기본값 목적
log 로그 저장 부울 값 V2 및 V3 false 로그 파일에 쿼리를 저장합니다. 기본값은 거짓입니다.
query - string V3만 기본값 없음 - GET 요청에 필요 V2에서 예측할 발화는 q 매개 변수에 있습니다.

V3에서 기능은 query 매개 변수로 전달됩니다.
show-all-intents 모든 의도의 점수 포함 부울 값 V3만 false prediction.intents 개체의 해당 점수와 함께 모든 의도를 반환합니다. 의도는 부모 intents 개체의 개체로 반환됩니다. 이렇게 하면 prediction.intents.give 배열에서 의도를 찾을 필요 없이 프로그래밍 방식으로 액세스할 수 있습니다 V2에서는 배열로 반환되었습니다.
verbose 자세한 엔터티 정보 포함 부울 값 V2 및 V3 false V2에서는 true로 설정할 경우 예측된 모든 의도가 반환되었습니다. 예측된 모든 의도가 필요한 경우 V3 매개 변수 show-all-intents를 사용합니다.

V3에서 이 매개 변수는 엔터티 예측의 엔터티 메타데이터 세부 정보만 제공합니다.
timezoneOffset - string V2 - datetimeV2 엔터티에 적용되는 표준 시간대입니다.
datetimeReference - string V3 - datetimeV2 엔터티에 적용되는 표준 시간대입니다. V2의 timezoneOffset을 대체합니다.

앱 스키마

앱 스키마를 가져오고 형식으로 .json 내보 .lu 냅니다.

언어 기반 SDK

언어 참조 설명서 Package(패키지) 빠른 시작
C# 작성
예측		 NuGet 작성
NuGet 예측		 작성
쿼리 예측
Go 작성 및 예측 SDK
Java 작성 및 예측 Maven 작성
Maven 예측
JavaScript 작성
예측		 NPM 작성
NPM 예측		 작성
예측
Python 작성 및 예측 핍 작성
예측

컨테이너

LUIS(Language Understanding)는 온-프레미스 및 포함된 버전의 앱을 제공하는 컨테이너를 제공합니다.

형식 내보내기 및 가져오기

Language Understanding은 앱 및 해당 모델을 JSON 형식, .LU LUDown(형식) 및 Language Understanding 컨테이너에 대한 압축 패키지로 관리하는 기능을 제공합니다.

이러한 형식을 가져오고 내보내는 기능은 API 및 LUIS 포털에서 사용할 수 있습니다. 포털은 앱 목록 및 버전 목록의 일부로 가져오기 및 내보내기를 제공합니다.

워크샵

지속적인 통합 도구

Bot Framework 도구

Bot Framework는 다양한 언어의 SDK로 또한 Azure AI Bot Service를 사용하는 서비스로 제공됩니다.

Bot Framework는 다음을 포함하여 Language Understanding에 도움이 되는 몇 가지 도구를 제공합니다.

  • Bot Framework Emulator - 봇 개발자가 Bot Framework SDK를 사용하여 빌드된 봇을 테스트 및 디버그할 수 있게 해주는 데스크톱 애플리케이션
  • Bot Framework Composer - Microsoft Bot Framework를 사용하여 봇 및 대화형 환경을 빌드하기 위한 개발자 및 다학제 팀을 위한 통합 개발 도구입니다.
  • Bot Framework 샘플 - #C, JavaScript, TypeScript 및 Python로 작성

다음 단계