Szybki start: tworzenie aplikacji w portalu usługi LUIS
Ważne
Usługa LUIS zostanie wycofana 1 października 2025 r. i od 1 kwietnia 2023 r. nie będzie można utworzyć nowych zasobów usługi LUIS. Zalecamy migrację aplikacji LUIS do interpretacji języka konwersacyjnego, aby korzystać z ciągłej pomocy technicznej i wielojęzycznych możliwości produktów.
W tym przewodniku Szybki start utwórz aplikację usługi LUIS przy użyciu wstępnie utworzonej domeny automatyzacji domu na potrzeby włączania i wyłączania świateł i urządzeń. Ta wstępnie utworzona domena zapewnia intencje, jednostki i przykładowe wypowiedzi. Następnie spróbuj dostosować aplikację, dodając więcej intencji i jednostek. Po zakończeniu samouczka punkt końcowy usługi LUIS będzie działał w chmurze.
Zaloguj się do portalu usługi LUIS
Nowy użytkownik usługi LUIS musi wykonać tę procedurę:
- Zaloguj się do portalu usługi LUIS, wybierz swój kraj/region i zaakceptuj warunki użytkowania. Jeśli widzisz Moje aplikacje zamiast tego, zasób usługi LUIS już istnieje i należy przejść dalej, aby utworzyć aplikację. Jeśli nie, zacznij od użycia zasobu platformy Azure, dzięki temu możesz połączyć konto usługi LUIS z nowym lub istniejącym zasobem usługi Azure Authoring.
W wyświetlonym oknie Wybieranie tworzenia znajdź swoją subskrypcję platformy Azure i zasób tworzenia usługi LUIS. Jeśli nie masz zasobu, możesz utworzyć nowy.
Podczas tworzenia nowego zasobu tworzenia podaj następujące informacje:
- Nazwa dzierżawy — dzierżawa, z która jest skojarzona twoja subskrypcja platformy Azure.
- Nazwa subskrypcji platformy Azure — subskrypcja, która zostanie naliczona za zasób.
- Nazwa grupy zasobów platformy Azure — niestandardowa nazwa wybranej lub utworzonej grupy zasobów. Grupy zasobów umożliwiają grupowanie zasobów platformy Azure na potrzeby dostępu i zarządzania.
- Nazwa zasobu platformy Azure — wybrana nazwa niestandardowa używana jako część adresu URL dla zapytań punktu końcowego tworzenia i przewidywania.
- Warstwa cenowa — warstwa cenowa określa maksymalną transakcję na sekundę i miesiąc.
Wybieranie zasobu subskrypcji i tworzenia
Po wybraniu określonej subskrypcji i zasobu tworzenia zostanie wyświetlona lista skojarzonych z nią aplikacji.
Utwórz nową aplikację
Tworzenie aplikacji i zarządzanie nimi jest możliwe w obszarze My Apps (Moje aplikacje).
Tworzenie aplikacji
Aby utworzyć aplikację, kliknij pozycję + Nowa aplikacja.
W wyświetlonym oknie wprowadź następujące informacje:
| Nazwa/nazwisko | Opis |
|---|---|
| Nazwa/nazwisko | Nazwa aplikacji. Na przykład "automatyzacja domu". |
| Kultura | Język, który aplikacja rozumie i mówi. |
| opis | Opis aplikacji. |
| Zasób przewidywania | Zasób przewidywania, który będzie otrzymywać zapytania. |
Wybierz pozycję Gotowe.
Uwaga
Kultury nie można zmienić po utworzeniu aplikacji.
Dodawanie wstępnie utworzonej domeny
Usługa LUIS oferuje zestaw wstępnie utworzonych domen, które mogą ułatwić rozpoczęcie pracy z aplikacją. Wstępnie utworzona aplikacja domeny jest już wypełniona intencjami, jednostkami i wypowiedziami.
W obszarze nawigacji po lewej stronie wybierz pozycję Wstępnie utworzone domeny.
Wyszukaj pozycję HomeAutomation.
Wybierz pozycję Dodaj domenę na karcie HomeAutomation.
Po pomyślnym dodaniu domeny pole wstępnie utworzonej domeny wyświetla przycisk Remove domain (Usuń domenę).
Wyewidencjonowywanie intencji i jednostek
Wybierz pozycję Intents (Intencje ) w menu nawigacji po lewej stronie, aby wyświetlić intencje domeny HomeAutomation. Zawiera przykładowe wypowiedzi, takie jak
HomeAutomation.QueryStateiHomeAutomation.SetDevice.Uwaga
None (Brak) to intencja zapewniana przez wszystkie aplikacje usługi LUIS. Używa się jej do obsługi wypowiedzi, które nie odnoszą się do funkcji zapewnianej przez aplikację.
Wybierz intencję HomeAutomation.TurnOff. Intencja zawiera listę przykładowych wypowiedzi, które są oznaczone jednostkami.
Jeśli chcesz wyświetlić jednostki dla aplikacji, wybierz pozycję Jednostki. W przypadku wybrania jednej z jednostek, takich jak HomeAutomation.DeviceName , zostanie wyświetlona lista skojarzonych z nią wartości.
Uczenie aplikacji LUIS
Po wypełnieniu aplikacji intencjami, jednostkami i wypowiedziami należy wytrenować aplikację, aby można było odzwierciedlić wprowadzone zmiany.
W prawym górnym rogu witryny internetowej usługi LUIS wybierz przycisk Trenuj .
Trenowanie jest ukończone po wyłączeniu przycisku Train (Trenowanie).
Przetestuj aplikację
Po przeprowadzeniu uczenia aplikacji możesz ją przetestować.
Wybierz pozycję Testuj w prawym górnym rogu nawigacji.
Wpisz wypowiedź testową w okienku interakcyjnym testu i naciśnij Enter. Na przykład Wyłącz światła.
W tym przykładzie wyłącz światła są poprawnie identyfikowane jako główna intencja oceniania HomeAutomation.TurnOff.
Wybierz pozycję Sprawdź, aby wyświetlić więcej informacji na temat przewidywania.
Zamknij okienko testu.
Dostosowywanie aplikacji
Oprócz wstępnie utworzonych domen usługa LUIS umożliwia tworzenie własnych aplikacji niestandardowych lub dostosowywanie na podstawie wstępnie utworzonych.
Tworzenie intencji
Aby dodać więcej intencji do aplikacji
- Wybierz pozycję Intents (Intencje ) w menu nawigacji po lewej stronie.
- Wybierz pozycję Utwórz
- Wprowadź nazwę intencji ,
HomeAutomation.AddDeviceAliasa następnie wybierz pozycję Gotowe.
Tworzenie jednostek
Aby dodać więcej jednostek do aplikacji
- Wybierz pozycję Jednostki w menu nawigacji po lewej stronie.
- Wybierz pozycję Utwórz
- Wprowadź nazwę jednostki ,
HomeAutomation.DeviceAliaswybierz maszynę poznaną na podstawie typu , a następnie wybierz pozycję Utwórz.
Dodawanie przykładowych wypowiedzi
Przykładowe wypowiedzi to tekst, który użytkownik wprowadza w czatbotze lub innych aplikacjach klienckich. Mapują intencję tekstu użytkownika na intencję usługi LUIS.
Na stronie Intents for HomeAutomation.AddDeviceAliasdodaj następujące przykładowe wypowiedzi w obszarze Przykładowa wypowiedź,
| # | Przykładowe wypowiedzi |
|---|---|
| 1 | Add alias to my fan to be wind machine |
| 2 | Alias lights to illumination |
| 3 | nickname living room speakers to our speakers a new fan |
| 100 | rename living room tv to main tv |
Aby uzyskać najlepsze wyniki, upewnij się, że przykładowe wypowiedzi różnią się w następujący sposób:
- Długość wypowiedzi
- interpunkcja
- Wybór wyrazu
- Czasownik (is, was, will will)
- Kolejność wyrazów
Przykładowe wypowiedzi etykiet
Wymagane jest etykietowanie wypowiedzi, ponieważ dodano jednostkę uczenia maszynowego. Etykietowanie jest używane przez aplikację, aby dowiedzieć się, jak wyodrębnić utworzone jednostki uczenia maszynowego.
Aby oznaczyć wypowiedzi, masz dwie opcje: etykietowanie palety jednostek i etykietowanie wbudowane.
Etykietowanie palety jednostek
Po wybraniu ikony @ w prawym górnym rogu paleta jednostek zostanie otwarta po prawej stronie.
Wybierz jednostkę, którą chcesz rozpocząć etykietowanie.
Wyróżnij tekst, który chcesz oznaczyć etykietą za pomocą tej jednostki.
Etykietowanie wbudowane
Wyróżnij tekst, który chcesz oznaczyć.
Wybierz jednostkę, której chcesz oznaczyć tekst za pomocą wyświetlonego menu.
Tworzenie zasobu przewidywania
Na tym etapie ukończono tworzenie aplikacji. Musisz utworzyć zasób przewidywania, aby opublikować aplikację w celu odbierania przewidywań w czatbotze lub innych aplikacjach klienckich za pośrednictwem punktu końcowego przewidywania
Aby utworzyć zasób przewidywania z poziomu portalu usługi LUIS
Przejdź do karty Zarządzanie w aplikacji.
W obszarze nawigacji po lewej stronie wybierz pozycję Zasoby platformy Azure.
wybierz przycisk Dodaj zasób przewidywania.
Jeśli masz już zasób przewidywania, dodaj go. W przeciwnym razie wybierz pozycję Utwórz nowy zasób przewidywania.
Publikowanie aplikacji w celu uzyskania adresu URL punktu końcowego
Aby otrzymać przewidywanie usługi LUIS w czatbotze lub innych aplikacjach klienckich, należy opublikować aplikację w punkcie końcowym przewidywania.
Wybierz pozycję Publikuj w prawym górnym rogu nawigacji.
Wybierz miejsce produkcyjne, a następnie wybierz pozycję Gotowe.
Wybierz pozycję Uzyskaj dostęp do adresów URL punktów końcowych w powiadomieniu, aby przejść do strony Zasoby platformy Azure. Adresy URL będą widoczne tylko wtedy, gdy masz zasób przewidywania skojarzony z aplikacją. Możesz również znaleźć stronę Zasoby platformy Azure, klikając pozycję Zarządzaj.
Wykonywanie zapytań względem punktu końcowego przewidywania interfejsu API w wersji 3
W portalu usługi LUIS w sekcji Zarządzanie (menu w prawym górnym rogu) na stronie Zasoby platformy Azure (menu po lewej stronie) na karcie Zasoby przewidywania skopiuj przykładowe zapytanie w dolnej części strony. Adres URL ma identyfikator aplikacji, klucz i nazwę miejsca. Adres URL punktu końcowego przewidywania w wersji 3 ma postać:
https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE
Wklej adres URL do nowej karty przeglądarki. Jeśli nie widzisz adresu URL, nie masz zasobu przewidywania i musisz go utworzyć.
Na pasku adresu przeglądarki dla ciągu zapytania upewnij się, że następujące wartości znajdują się w adresie URL. Jeśli nie znajdują się w ciągu zapytania, dodaj je:
verbose=trueshow-all-intents=true
Na pasku adresu przeglądarki przejdź na końcu adresu URL i wprowadź wyłącz światło salonu dla ciągu zapytania, a następnie naciśnij Enter.
{ "query": "turn off the living room light", "prediction": { "topIntent": "HomeAutomation.TurnOff", "intents": { "HomeAutomation.TurnOff": { "score": 0.969448864 }, "HomeAutomation.QueryState": { "score": 0.0122336326 }, "HomeAutomation.TurnUp": { "score": 0.006547436 }, "HomeAutomation.TurnDown": { "score": 0.0050634006 }, "HomeAutomation.SetDevice": { "score": 0.004951761 }, "HomeAutomation.TurnOn": { "score": 0.00312553928 }, "None": { "score": 0.000552945654 } }, "entities": { "HomeAutomation.Location": [ "living room" ], "HomeAutomation.DeviceName": [ [ "living room light" ] ], "HomeAutomation.DeviceType": [ [ "light" ] ], "$instance": { "HomeAutomation.Location": [ { "type": "HomeAutomation.Location", "text": "living room", "startIndex": 13, "length": 11, "score": 0.902181149, "modelTypeId": 1, "modelType": "Entity Extractor", "recognitionSources": [ "model" ] } ], "HomeAutomation.DeviceName": [ { "type": "HomeAutomation.DeviceName", "text": "living room light", "startIndex": 13, "length": 17, "modelTypeId": 5, "modelType": "List Entity Extractor", "recognitionSources": [ "model" ] } ], "HomeAutomation.DeviceType": [ { "type": "HomeAutomation.DeviceType", "text": "light", "startIndex": 25, "length": 5, "modelTypeId": 5, "modelType": "List Entity Extractor", "recognitionSources": [ "model" ] } ] } } } }
Czyszczenie zasobów
Gdy aplikacja LUIS nie będzie już potrzebna, usuń ją. Aby to zrobić, wybierz pozycję My apps (Moje aplikacje) z menu w lewym górnym rogu. Wybierz wielokropek (...) po prawej stronie nazwy aplikacji na liście aplikacji i wybierz polecenie Delete (Usuń). W wyskakującym oknie dialogowym Delete app? (Usunąć aplikację?) wybierz pozycję OK.