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

Ważne

Usługa Language Understanding Intelligent Service (LUIS) zostanie w pełni wycofana 31 marca 2026 r. Tworzenie zasobów usługi LUIS nie jest dostępne. Od 31 października 2025 r. portal usługi LUIS nie będzie już dostępny. 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.

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 i jak nimi zarządzać.

Zasób autorski

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 — bezpłatna (F0) warstwa, która zapewnia:

• 1 milion autorskich transakcji
• 1 000 żądań końcowych przewidywania miesięcznie.

Można używać programowych interfejsów API LUIS w wersji v3.0-preview do zarządzania zasobami autorstwa.

Zasób przewidywania

Zasób przewidywania pozwala na wykonywanie zapytań do punktu końcowego przewidywania poza granicę 1000 żądań oferowanych przez zasób autorowania. Dla zasobu przewidywania są dostępne dwie warstwy cenowe :

• Bezpłatny zasób przewidywań (F0), który umożliwia 10 000 żądań na punkty końcowe przewidywania miesięcznie.
• Standardowy zasób przewidywania (S0), który jest płatnym poziomem.

Do zarządzania zasobami przewidywania można użyć interfejsu v3.0-preview LUIS Endpoint API.

Uwaga

• Możesz również użyć zasobu wielousługowego, aby uzyskać pojedynczy punkt końcowy, którego można użyć dla wielu usług Azure AI.
• Usługa LUIS udostępnia dwa typy zasobów F0 (warstwa bezpłatna): jeden do tworzenia transakcji i jeden dla transakcji przewidywania. Jeśli kończy Ci się bezpłatny limit na transakcje przewidywania, upewnij się, że używasz zasobu przewidywania F0, który daje 10 000 bezpłatnych transakcji miesięcznie, a nie zasobu tworzenia, który zapewnia 1 000 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, witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure. Po utworzeniu zasobów, należy je przypisać do aplikacji, aby te mogły z nich korzystać.

Portal LUIS

Tworzenie zasobu do tworzenia w LUIS przy użyciu portalu 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 oknie Wybierz tworzenie, które się pojawi, znajdź swoją subskrypcję platformy Azure i zasób tworzenia LUIS. Jeśli nie masz zasobu, możesz utworzyć nowy.

   

   Podczas tworzenia nowego zasobu autorskiego podaj następujące informacje:

   • Nazwa dzierżawcy: dzierżawca, z którym jest skojarzona twoja subskrypcja Azure.
   • Nazwa subskrypcji platformy Azure: subskrypcja, która będzie rozliczana za zasób.
   • Nazwa grupy zasobów platformy Azure: wybrana lub utworzona niestandardowa nazwa grupy zasobów. Grupy zasobów umożliwiają grupowanie zasobów platformy Azure na potrzeby dostępu i zarządzania.
   • Nazwa zasobu Azure: niestandardowa nazwa, którą wybierasz, używana jako część adresu URL dla zapytań interfejsu końcowego tworzenia i prognozowania.
   • Warstwa cenowa: warstwa cenowa określa maksymalną transakcję na sekundę i miesiąc.

Utwórz zasób przewidywania LUIS przy użyciu portalu LUIS

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

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

3. wybierz przycisk "Dodaj zasób przewidywań".

   

   Jeśli masz już zasób przewidywania, dodaj go. W przeciwnym razie wybierz pozycję Utwórz nowy zasób przewidywania.

   

Bez portalu LUIS

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

Użyj Azure CLI, aby utworzyć każdy zasób indywidualnie.

Napiwek

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

1. Zaloguj się do Azure CLI:

   az login
   

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

2. Utwórz zasób projektowania LUIS o rodzaju LUIS.Authoring, o nazwie 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 rodzaju LUISo nazwie my-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
   

Przydziel zasoby LUIS

Utworzenie zasobu nie musi oznaczać, że jest ono używane, musisz przypisać go do aplikacji. Zasób tworzenia można przypisać dla jednej aplikacji lub dla wszystkich aplikacji w usłudze LUIS.

Portal LUIS

Przypisywanie zasobów przy użyciu portalu LUIS

Przypisywanie zasobu tworzenia do wszystkich aplikacji

Poniższa procedura przypisuje zasoby autorstwa 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źć poprawny zasób, a następnie wybierz pozycję Zapisz.

Bez portalu LUIS

Przypisywanie zasobu przewidywania bez korzystania z portalu usługi LUIS

W przypadku zautomatyzowanych procesów, takich jak pipeline'y CI/CD, można automatycznie przypisać zasób LUIS do aplikacji 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 Azure CLI.

   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ść Authorization to Bearer {token}. Wartość tokenu musi być poprzedzona wyrazem Bearer i spacją.
   Ocp-Apim-Subscription-Key	Klucz autorski.

   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 interfejsu API Przypisywanie zasobów LUIS Azure do 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 autorski.
   Nagłówek	Content-type	application/json
   Ciąg zapytania	appid	Identyfikator aplikacji 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

Po usunięciu przypisania zasobu nie zostanie on usunięty z platformy Azure. Jest odłączona tylko od LUIS.

Portal 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 obszaru Zarządzanie zasobami >platformy Azure.
3. Wybierz przycisk Odłącz zasób.

Bez portalu 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 Azure CLI.

   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 Get LUIS Azure Accounts, 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 autorski.

   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 LUIS za pomocą interfejsu API Unassign a LUIS Azure account from an application.

   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 autorski.
   Nagłówek	Content-type	application/json
   Ciąg zapytania	appid	Identyfikator aplikacji 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:

• Przenoszenie 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

Ograniczenia dotyczące tworzenia kluczy

Możesz utworzyć maksymalnie 10 kluczy autorskich na każdy region w ramach jednej subskrypcji. Regiony publikowania różnią się od regionów tworzenia treści. 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, zapoznaj się z limitami 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 na miesiąc (TPM), zostanie wyświetlony błąd HTTP 403.

Zmienianie warstwy cenowej

1. W witrynie 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 witrynie Azure Portal. Na stronie Przegląd przedstawiono podsumowanie, w tym ostatnie wywołania i błędy. Jeśli utworzysz żą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 łącznej liczby 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. Wybierz pozycję Dodaj warunek

   

4. Wybierz Łą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 witrynie 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 witrynie 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 witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure:

• 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.