빠른 시작: 미리 작성된 Home automation 앱 사용Quickstart: Use prebuilt Home automation app

이 빠른 시작에서는 미리 작성된 도메인 HomeAutomation를 사용하여 조명 및 어플라이언스를 켜고 끄는 LUIS 응용 프로그램을 만듭니다.In this quickstart, create a LUIS app that uses the prebuilt domain HomeAutomation for turning lights and appliances on and off. 미리 작성된 도메인에는 의도, 엔터티 및 예제 발언이 제공됩니다.This prebuilt domain provides intents, entities, and example utterances for you. 마치면 클라우드에서 LUIS 엔드포인트를 실행하게 됩니다.When you're finished, you'll have a LUIS endpoint running in the cloud.

필수 조건Prerequisites

이 문서에서는 https://www.luis.ai의 LUIS 포털에 만들어진 무료 LUIS 계정이 필요합니다.For this article, you need a free LUIS account, created on the LUIS portal at https://www.luis.ai.

새 앱 만들기Create a new app

응용 프로그램은 내 앱에서 만들고 관리할 수 있습니다.You can create and manage your applications on My Apps.

  1. LUIS 포털에 로그인합니다.Sign in to the LUIS portal.

  2. 새 앱 만들기를 선택합니다.Select Create new app.

  3. 대화 상자에서 응용 프로그램 이름을 "Home Automation"으로 지정합니다.In the dialog box, name your application "Home Automation".

  4. 응용 프로그램 문화권을 선택합니다.Choose your application culture. Home Automation 앱의 경우 영어를 선택합니다.For this Home Automation app, choose English. 그런 후 완료를 선택합니다.Then select Done. LUIS에서 Home Automation 앱이 만들어집니다.LUIS creates the Home Automation app.

    참고

    응용 프로그램을 만든 후에는 문화권을 변경할 수 없습니다.The culture cannot be changed once the application is created.

미리 빌드된 도메인 추가Add prebuilt domain

왼쪽 탐색 창에서 미리 작성된 도메인을 선택합니다.Select Prebuilt domains in the left-side navigation pane. 그런 다음, "Home"을 검색합니다.Then search for "Home". 도메인 추가를 선택합니다.Select Add domain.

도메인 추가에 성공하면 미리 작성된 도메인 상자에 도메인 제거 단추가 표시됩니다.When the domain is successfully added, the prebuilt domain box displays a Remove domain button.

의도 및 엔터티Intents and entities

왼쪽 탐색 창에서 의도를 선택하여 HomeAutomation 도메인 의도를 검토합니다.Select Intents in the left-side navigation pane to review the HomeAutomation domain intents. 의도마다 예제 발언이 있습니다.Each intent has sample utterances.

참고

없음은 모든 LUIS 앱에 제공되는 의도입니다.None is an intent provided by all LUIS apps. 이것은 앱에 제공되는 기능과 일치하지 않는 발언을 처리하는 데 사용됩니다.You use it to handle utterances that don't correspond to functionality your app provides.

HomeAutomation.TurnOff 의도를 선택합니다.Select the HomeAutomation.TurnOff intent. 엔터티를 사용하여 레이블이 지정된 발언 목록이 의도에 포함된 것을 볼 수 있습니다.You can see that the intent contains a list of utterances that are labeled with entities.

LUIS 앱 학습Train the LUIS app

  1. LUIS 웹 사이트의 오른쪽 위에서 학습 단추를 선택합니다.In the top right side of the LUIS website, select the Train button.

    학습 단추

  2. 웹 사이트의 위쪽에 성공이 확인된 녹색 상태 표시줄이 표시되면 학습이 완료됩니다.Training is complete when you see the green status bar at the top of the website confirming success.

    학습 완료 상태 표시줄

앱 테스트Test your app

앱을 학습시킨 후에는 테스트할 수 있습니다.Once you've trained your app, you can test it. 맨 위 탐색에서 테스트를 선택합니다.Select Test in the top navigation. 대화형 테스트 창에 테스트 발언(예: "Turn off the lights")을 입력하고 Enter 키를 누릅니다.Type a test utterance like "Turn off the lights" into the Interactive Testing pane, and press Enter.

Turn off the lights

점수가 가장 높은 의도가 각 테스트 발언에 대한 의도와 일치하는지 확인합니다.Check that the top scoring intent corresponds to the intent you expected for each test utterance.

이 예제에서 "Turn off the lights"는 "HomeAutomation.TurnOff"의 최고 득점 의도로 올바르게 식별되었습니다.In this example, "Turn off the lights" is correctly identified as the top scoring intent of "HomeAutomation.TurnOff."

테스트를 다시 선택하여 테스트 창을 접습니다.Select Test again to collapse the test pane.

앱을 게시하여 엔드포인트 URL 가져오기Publish the app to get the endpoint URL

챗봇 또는 다른 클라이언트 응용 프로그램에서 LUIS 예측을 받으려면 앱을 엔드포인트에 게시해야 합니다.In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the endpoint.

  1. 오른쪽 맨 위 탐색 창에서 게시를 선택합니다.Select Publish in the top right navigation.

    오른쪽 맨 위에 있는 엔드포인트에 LUIS 게시 단추

  2. 프로덕션 슬롯과 게시 단추를 선택합니다.Select the Production slot and the Publish button.

    엔드포인트에 LUIS 게시

  3. 웹 사이트의 위쪽에 성공이 확인된 녹색 상태 표시줄이 표시되면 게시가 완료됩니다.Publishing is complete when you see the green status bar at the top of the website confirming success.

    엔드포인트에 LUIS 게시

  4. 녹색 상태 표시줄에서 엔드포인트를 선택하여 키 및 엔드포인트 페이지로 이동합니다.Select the endpoints link in the green status bar to go to the Keys and endpoints page. 엔드포인트 URL은 맨 아래에 나열됩니다.The endpoint URLs are listed at the bottom.

다른 발화를 사용하여 엔드포인트 쿼리Query the endpoint with a different utterance

  1. 관리 섹션(오른쪽 위 메뉴)의 키 및 엔드포인트 페이지(왼쪽 메뉴)에서, 페이지 맨 아래에 있는 엔드포인트 URL을 선택합니다.In the Manage section (top right menu), on the Keys and endpoints page (left menu), select the endpoint URL at the bottom of the page. 그러면 주소 표시줄에 엔드포인트 URL이 표시된 다른 브라우저 탭이 열립니다.This action opens another browser tab with the endpoint URL in the address bar.

    엔드포인트 URL은 https://<region>.api.cognitive.microsoft.com/luis/v2.0/apps/<appID>?verbose=true&subscription-key=<YOUR_KEY>&<optional-name-value-pairs>&q=<user-utterance-text> 형식입니다.The endpoint URL looks like https://<region>.api.cognitive.microsoft.com/luis/v2.0/apps/<appID>?verbose=true&subscription-key=<YOUR_KEY>&<optional-name-value-pairs>&q=<user-utterance-text>.

  2. 주소의 URL 끝으로 이동하고 turn off the living room light를 입력한 다음, Enter 키를 누릅니다.Go to the end of the URL in the address and enter turn off the living room light, and then press Enter. 브라우저는 HTTP 엔드포인트의 JSON 응답을 표시합니다.The browser displays the JSON response of your HTTP endpoint.

리소스 정리Clean up resources

더 이상 필요하지 않은 경우 LUIS 앱을 삭제합니다.When no longer needed, delete the LUIS app. 그러려면 왼쪽 위 메뉴에서 내 앱을 선택합니다.To do so, select My apps from the top left menu. 앱 목록에서 앱 이름 오른쪽에 있는 줄임표(...)를 선택하고 삭제를 선택합니다.Select the ellipsis (...) to the right of the app name in the app list, select Delete. 앱을 삭제하시겠습니까? 팝업 대화 상자에서 확인을 선택합니다.On the pop-up dialog Delete app?, select Ok.

다음 단계Next steps

다음 코드에서 엔드포인트를 호출할 수 있습니다.You can call the endpoint from code: