Jak tworzyć zasoby usługi LUIS i zarządzać nimi

Ważne

Usługa LUIS zostanie wycofana 1 października 2025 r. i od 1 kwietnia 2023 r. nie będzie można tworzyć nowych zasobów usługi LUIS. Zalecamy migrowanie aplikacji LUIS do interpretacji języka konwersacyjnego , aby korzystać z ciągłej pomocy technicznej produktu i możliwości wielojęzycznych.

Skorzystaj z tego artykułu, aby dowiedzieć się więcej o typach zasobów platformy Azure, których można używać z usługą LUIS, oraz o tym, jak nimi zarządzać.

Zasób tworzenia

Zasób tworzenia umożliwia tworzenie, trenowanie, testowanie i publikowanie aplikacji oraz zarządzanie nimi. Jedna warstwa cenowa jest dostępna dla zasobu tworzenia usługi LUIS — warstwa bezpłatna (F0), która zapewnia następujące możliwości:

• 1 milion transakcji tworzenia
• 1000 żądań punktów końcowych przewidywania na miesiąc.

Do zarządzania zasobami tworzenia można użyć interfejsów API programowych usługi LUIS w wersji 3.0-preview .

Zasób przewidywania

Zasób przewidywania umożliwia wykonywanie zapytań względem punktu końcowego przewidywania poza 1000 żądań dostarczonych przez zasób tworzenia. Dla zasobu przewidywania są dostępne dwie warstwy cenowe :

• Bezpłatny zasób przewidywania (F0), który daje 10 000 żądań punktów końcowych przewidywania miesięcznie.
• Zasób przewidywania w warstwie Standardowa (S0), który jest warstwą płatną.

Do zarządzania zasobami przewidywania można użyć interfejsu API punktu końcowego usługi LUIS w wersji 3.0 w wersji 0.0 .

Uwaga

• Możesz również użyć zasobu z wieloma usługami , aby uzyskać pojedynczy punkt końcowy, którego można użyć dla wielu usług Cognitive Services.
• Usługa LUIS udostępnia dwa typy zasobów F0 (warstwa bezpłatna): jeden dla transakcji tworzenia i jeden dla transakcji przewidywania. Jeśli kończy się bezpłatny limit przydziału dla transakcji przewidywania, upewnij się, że używasz zasobu przewidywania F0, który daje 10 000 bezpłatnych transakcji miesięcznie, a nie zasób tworzenia, który daje 1000 transakcji przewidywania miesięcznie.
• Aplikacje usługi LUIS należy tworzyć w regionach , w których chcesz publikować i wykonywać zapytania.

Tworzenie zasobów usługi LUIS

Aby utworzyć zasoby usługi LUIS, możesz użyć portalu usługi LUIS, Azure Portal lub interfejsu wiersza polecenia platformy Azure. Po utworzeniu zasobów należy przypisać je do aplikacji, które będą używane przez nie.

Portal usługi LUIS

Tworzenie zasobu tworzenia usługi LUIS przy użyciu portalu usługi LUIS

1. Zaloguj się do portalu usługi LUIS, wybierz swój kraj/region i zaakceptuj warunki użytkowania. Jeśli w portalu zostanie wyświetlona sekcja Moje aplikacje, zasób usługi LUIS już istnieje i możesz pominąć następny krok.

2. W wyświetlonym oknie Wybieranie tworzenia znajdź 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 będzie rozliczana za zasób.
   • Nazwa grupy zasobów platformy Azure: wybrana lub utworzona nazwa niestandardowej 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.

Tworzenie zasobu przewidywania usługi LUIS przy użyciu portalu usługi LUIS

1. Przejdź do karty Zarządzanie w aplikacji.

2. W obszarze nawigacji po lewej stronie wybierz pozycję Zasoby platformy Azure.

3. kliknij 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.

   

Bez portalu usługi LUIS

Tworzenie zasobów usługi LUIS bez korzystania z portalu usługi LUIS

Użyj interfejsu wiersza polecenia platformy Azure , aby utworzyć każdy zasób osobno.

Porada

• Zasób kind tworzenia to LUIS.Authoring
• Zasób kind przewidywania to LUIS

1. Zaloguj się do interfejsu wiersza polecenia platformy Azure:

   az login
   

   To polecenie otwiera przeglądarkę, aby można było wybrać poprawne konto i podać uwierzytelnianie.

2. Utwórz zasób tworzenia usługi LUIS o nazwie LUIS.Authoring.my-luis-authoring-resource Utwórz ją w istniejącej grupie zasobów o nazwie my-resource-group dla westus regionu.

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

3. Utwórz zasób punktu końcowego przewidywania usługi LUIS o nazwie LUISmy-luis-prediction-resource. Utwórz ją w istniejącej grupie zasobów o nazwie my-resource-group dla westus regionu. Jeśli potrzebujesz wyższej przepływności niż zapewnia warstwa Bezpłatna, zmień wartość F0 na S0. Dowiedz się więcej o warstwach cenowych i przepływności.

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

Przypisywanie zasobów usługi LUIS

Utworzenie zasobu nie musi oznaczać, że jest ono używane, należy przypisać je do aplikacji. Możesz przypisać zasób tworzenia dla jednej aplikacji lub dla wszystkich aplikacji w usłudze LUIS.

Portal usługi LUIS

Przypisywanie zasobów przy użyciu portalu usługi LUIS

Przypisywanie zasobu tworzenia do wszystkich aplikacji

Poniższa procedura przypisuje zasób tworzenia do wszystkich aplikacji.

1. Zaloguj się do portalu usługi LUIS.
2. W prawym górnym rogu wybierz konto użytkownika, a następnie wybierz pozycję Ustawienia.
3. Na stronie Ustawienia użytkownika wybierz pozycję Dodaj zasób tworzenia, a następnie wybierz istniejący zasób tworzenia. Wybierz pozycję Zapisz.

Przypisywanie zasobu do określonej aplikacji

Poniższa procedura przypisuje zasób do określonej aplikacji.

1. Zaloguj się do portalu usługi LUIS. Wybierz aplikację z listy Moje aplikacje .

2. Przejdź do obszaru Zarządzanie zasobami>platformy Azure:

   

3. Na karcie Zasób przewidywania lub Zasób tworzenia wybierz przycisk Dodaj zasób przewidywania lub Dodaj zasób tworzenia .

4. Użyj pól w formularzu, aby znaleźć prawidłowy zasób, a następnie wybierz pozycję Zapisz.

Bez portalu usługi LUIS

Przypisywanie zasobu przewidywania bez korzystania z portalu usługi LUIS

W przypadku zautomatyzowanych procesów, takich jak potoki ciągłej integracji/ciągłego wdrażania, można zautomatyzować przypisywanie zasobu usługi LUIS do aplikacji usługi LUIS, wykonując następujące czynności:

1. Pobierz token usługi Azure Resource Manager, który jest ciągiem alfanumerycznym znaków. Ten token wygaśnie, więc użyj go od razu. Możesz również użyć następującego polecenia interfejsu wiersza polecenia platformy Azure.

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

2. Użyj tokenu, aby zażądać zasobów środowiska uruchomieniowego usługi LUIS w ramach subskrypcji. Użyj interfejsu API, aby uzyskać konto platformy Azure usługi LUIS , do którego twoje konto użytkownika ma dostęp.

   Ten interfejs API POST wymaga następujących wartości:

   Nagłówek	Wartość
   Authorization	Wartość to AuthorizationBearer {token}. Wartość tokenu musi być poprzedzona wyrazem Bearer i spacją.
   Ocp-Apim-Subscription-Key	Klucz tworzenia.

   Interfejs API zwraca tablicę obiektów JSON reprezentujących subskrypcje usługi LUIS. Zwrócone wartości obejmują identyfikator subskrypcji, grupę zasobów i nazwę zasobu zwróconą jako AccountName. Znajdź element w tablicy, który jest zasobem usługi LUIS, który chcesz przypisać do aplikacji usługi LUIS.

3. Przypisz token do zasobu usługi LUIS przy użyciu polecenia Przypisywanie kont platformy Azure usługi LUIS do interfejsu API aplikacji .

   Ten interfejs API POST wymaga następujących wartości:

   Typ	Ustawienie	Wartość
   Nagłówek	Authorization	Wartość Authorization to Bearer {token}. Wartość tokenu musi być poprzedzona wyrazem Bearer i spacją.
   Nagłówek	Ocp-Apim-Subscription-Key	Klucz tworzenia.
   Nagłówek	Content-type	application/json
   Querystring	appid	Identyfikator aplikacji usługi LUIS.
   Treść		{AzureSubscriptionId: Identyfikator subskrypcji, ResourceGroup: Nazwa grupy zasobów, która ma zasób przewidywania, AccountName: Nazwa zasobu przewidywania}

   Gdy ten interfejs API zakończy się pomyślnie, zwraca wartość 201 - created status.

Anulowanie przypisania zasobu

Gdy nie przypiszesz zasobu, nie zostanie on usunięty z platformy Azure. Jest to tylko odłączone od usługi LUIS.

Portal usługi LUIS

Anulowanie przypisania zasobów przy użyciu portalu usługi LUIS

1. Zaloguj się do portalu usługi LUIS, a następnie wybierz aplikację z listy Moje aplikacje .
2. Przejdź do pozycji Zarządzanie>zasobami platformy Azure.
3. Wybierz przycisk Coprzypisuj zasób dla zasobu.

Bez portalu usługi LUIS

Anulowanie przypisania zasobu przewidywania bez korzystania z portalu usługi LUIS

1. Pobierz token usługi Azure Resource Manager, który jest ciągiem alfanumerycznym znaków. Ten token wygaśnie, więc użyj go od razu. Możesz również użyć następującego polecenia interfejsu wiersza polecenia platformy Azure.

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

2. Użyj tokenu, aby zażądać zasobów środowiska uruchomieniowego usługi LUIS w ramach subskrypcji. Użyj interfejsu API uzyskiwania kont platformy Azure usługi LUIS, do którego twoje konto użytkownika ma dostęp.

   Ten interfejs API POST wymaga następujących wartości:

   Nagłówek	Wartość
   Authorization	Wartość Authorization to Bearer {token}. Wartość tokenu musi być poprzedzona wyrazem Bearer i spacją.
   Ocp-Apim-Subscription-Key	Klucz tworzenia.

   Interfejs API zwraca tablicę obiektów JSON reprezentujących subskrypcje usługi LUIS. Zwrócone wartości obejmują identyfikator subskrypcji, grupę zasobów i nazwę zasobu zwróconą jako AccountName. Znajdź element w tablicy, który jest zasobem usługi LUIS, który chcesz przypisać do aplikacji usługi LUIS.

3. Przypisz token do zasobu usługi LUIS przy użyciu polecenia Cofnij przypisanie konta platformy Azure usługi LUIS z interfejsu API aplikacji .

   Ten interfejs API DELETE wymaga następujących wartości:

   Typ	Ustawienie	Wartość
   Nagłówek	Authorization	Wartość Authorization to Bearer {token}. Wartość tokenu musi być poprzedzona wyrazem Bearer i spacją.
   Nagłówek	Ocp-Apim-Subscription-Key	Klucz tworzenia.
   Nagłówek	Content-type	application/json
   Querystring	appid	Identyfikator aplikacji usługi LUIS.
   Treść		{AzureSubscriptionId: Identyfikator subskrypcji, ResourceGroup: Nazwa grupy zasobów, która ma zasób przewidywania, AccountName: Nazwa zasobu przewidywania}

   Gdy ten interfejs API zakończy się pomyślnie, zwraca wartość 200 - OK status.

Własność zasobów

Zasób platformy Azure, taki jak zasób usługi LUIS, jest własnością subskrypcji zawierającej zasób.

Aby zmienić własność zasobu, możesz wykonać jedną z następujących akcji:

• Przeniesienie własności subskrypcji.
• Wyeksportuj aplikację usługi LUIS jako plik, a następnie zaimportuj aplikację do innej subskrypcji. Eksportowanie jest dostępne na stronie Moje aplikacje w portalu usługi LUIS.

Limity zasobów

Limity tworzenia kluczy

Możesz utworzyć aż 10 kluczy tworzenia w poszczególnych regionach na subskrypcję. Regiony publikowania różnią się od regionów tworzenia. Upewnij się, że w regionie tworzenia utworzono aplikację odpowiadającą regionowi publikowania, w którym ma znajdować się aplikacja kliencka. Aby uzyskać informacje na temat sposobu mapowania regionów tworzenia na regiony publikowania, zobacz Tworzenie i publikowanie regionów.

Aby uzyskać więcej informacji, zobacz limity zasobów .

Błędy dotyczące limitów użycia kluczy

Limity użycia są oparte na warstwie cenowej.

W przypadku przekroczenia limitu przydziału transakcji na sekundę (TPS) otrzymasz błąd HTTP 429. Jeśli przekroczono limit przydziału transakcji miesięcznie (TPM), zostanie wyświetlony błąd HTTP 403.

Zmienianie warstwy cenowej

1. W Azure Portal przejdź do pozycji Wszystkie zasoby i wybierz zasób

   

2. W menu po lewej stronie wybierz pozycję Warstwa cenowa , aby wyświetlić dostępne warstwy cenowe

3. Wybierz odpowiednią warstwę cenową, a następnie kliknij pozycję Wybierz , aby zapisać zmianę. Po zakończeniu zmiany cen w prawym górnym rogu zostanie wyświetlone powiadomienie z aktualizacją warstwy cenowej.

Wyświetlanie metryk zasobów platformy Azure

Wyświetlanie podsumowania użycia zasobów platformy Azure

Informacje o użyciu usługi LUIS można wyświetlić w Azure Portal. Na stronie Przegląd przedstawiono podsumowanie, w tym ostatnie wywołania i błędy. Jeśli wykonasz żądanie punktu końcowego usługi LUIS, poczekaj maksymalnie pięć minut na wyświetlenie zmiany.

Dostosowywanie wykresów użycia zasobów platformy Azure

Strona Metryki zawiera bardziej szczegółowy widok danych. Wykresy metryk można skonfigurować dla określonego okresu i metryki.

Alert dotyczący progu łącznych transakcji

Jeśli chcesz wiedzieć, kiedy osiągniesz określony próg transakcji, na przykład 10 000 transakcji, możesz utworzyć alert:

1. W menu po lewej stronie wybierz pozycję Alerty

2. W górnym menu wybierz pozycję Nowa reguła alertu

   

3. Kliknij pozycję Dodaj warunek

   

4. Wybierz pozycję Łączna liczba wywołań

   

5. Przewiń w dół do sekcji Logika alertu i ustaw atrybuty zgodnie z potrzebami, a następnie kliknij przycisk Gotowe

   

6. Aby wysyłać powiadomienia lub wywoływać akcje po wyzwoleniu reguły alertu, przejdź do sekcji Akcje i dodaj grupę akcji.

   

Resetowanie klucza tworzenia

W przypadku migrowanych aplikacji zasobów tworzenia: jeśli klucz tworzenia został naruszony, zresetuj klucz w Azure Portal na stronie Klucze zasobu tworzenia.

W przypadku aplikacji, które nie zostały zmigrowane: klucz jest resetowany we wszystkich aplikacjach w portalu usługi LUIS. Jeśli tworzysz aplikacje za pośrednictwem interfejsów API tworzenia, musisz zmienić wartość Ocp-Apim-Subscription-Key na nowy klucz.

Ponowne generowanie klucza platformy Azure

Klucz platformy Azure można wygenerować ponownie na stronie Klucze w Azure Portal.

Własność, dostęp i zabezpieczenia aplikacji

Aplikacja jest definiowana przez jej zasoby platformy Azure, które są określane przez subskrypcję właściciela.

Możesz przenieść aplikację usługi LUIS. Skorzystaj z następujących zasobów, aby to zrobić przy użyciu Azure Portal lub interfejsu wiersza polecenia platformy Azure:

• Przenoszenie aplikacji między zasobami tworzenia usługi LUIS
• Przenoszenie zasobu do nowej grupy zasobów lub subskrypcji
• Przenoszenie zasobu w ramach tej samej subskrypcji lub między subskrypcjami

Następne kroki

• Dowiedz się , jak używać wersji do kontrolowania cyklu życia aplikacji.