Szybki start: tworzenie aplikacji w portalu usługi LUIS

Artykuł
02/21/2024

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.

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.QueryState i HomeAutomation.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 klawisz 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=true
- show-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 klawisz 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.

Share via

Szybki start: tworzenie aplikacji w portalu usługi LUIS

Wybieranie zasobu subskrypcji i tworzenia