Zasoby dla deweloperów zestawu SDK, rest i interfejsu wiersza polecenia dla usługi Language Understanding (LUIS)

  • Artykuł

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.

Zestawy SDK, interfejsy API REST, interfejs wiersza polecenia ułatwiają opracowywanie aplikacji usługi Language Understanding (LUIS) w języku programowania. Zarządzanie zasobami platformy Azure i przewidywaniami usługi LUIS.

Zarządzanie zasobami platformy Azure

Użyj warstwy zarządzania usługami AI platformy Azure, aby utworzyć, edytować, wyświetlić listę i usunąć zasób usług Language Understanding lub Azure AI.

Znajdź dokumentację referencyjną na podstawie narzędzia:

Żądania tworzenia i przewidywania usługi Language Understanding

Dostęp do usługi Language Understanding jest uzyskiwany z zasobu platformy Azure, który należy utworzyć. Istnieją dwa zasoby:

  • Użyj zasobu tworzenia do trenowania, aby utworzyć, edytować, trenować i publikować.
  • Użyj przewidywania dla środowiska uruchomieniowego, aby wysłać tekst użytkownika i otrzymać przewidywanie.

Przykładowy kod usług AI platformy Azure umożliwia naukę i używanie najbardziej typowych zadań.

Specyfikacje REST

Specyfikacje REST usługi LUIS wraz ze wszystkimi specyfikacjami REST platformy Azure są publicznie dostępne w witrynie GitHub.

Interfejsy API REST

Interfejsy API tworzenia i przewidywania punktu końcowego są dostępne w interfejsach API REST:

Typ Wersja
Tworzenie Wersja 2
wersja zapoznawcza 3
Przewidywanie Wersja 2
Wersja 3

Punkty końcowe REST

Usługa LUIS ma obecnie 2 typy punktów końcowych:

  • tworzenie w punkcie końcowym trenowania
  • przewidywanie zapytań w punkcie końcowym środowiska uruchomieniowego.
Purpose URL
Tworzenie w wersji 2 w punkcie końcowym trenowania https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Tworzenie w wersji 3 w punkcie końcowym trenowania https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Przewidywanie w wersji 2 — wszystkie przewidywania w punkcie końcowym środowiska uruchomieniowego https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Przewidywanie wersji 3 — przewidywanie wersji w punkcie końcowym środowiska uruchomieniowego https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Przewidywanie w wersji 3 — przewidywanie miejsca w punkcie końcowym środowiska uruchomieniowego https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

W poniższej tabeli opisano parametry oznaczone nawiasami klamrowymi {}w poprzedniej tabeli.

Parametr Purpose
your-resource-name Nazwa zasobu platformy Azure
q lub query tekst wypowiedzi wysyłany z aplikacji klienckiej, taki jak czatbot
version Nazwa wersji 10 znaków
slot production lub staging

Parametry ciągu zapytania REST

Parametry ciągu zapytania interfejsu API w wersji 3 obejmują:

Parametr zapytania Nazwa portalu usługi LUIS Typ Wersja Wartość domyślna Purpose
log Zapisywanie dzienników boolean Wersja 2 i wersja 3 fałsz Zapisz zapytanie w pliku dziennika. Wartość domyślna to false.
query - string Tylko wersja 3 Brak wartości domyślnej — jest to wymagane w żądaniu GET W wersji 2 wypowiedź, która ma być przewidywana, znajduje się w parametrze q .

W wersji 3 funkcja jest przekazywana w parametrze query .
show-all-intents Uwzględnij wyniki dla wszystkich intencji boolean Tylko wersja 3 fałsz Zwróć wszystkie intencje z odpowiednim wynikiem w obiekcie prediction.intents . Intencje są zwracane jako obiekty w obiekcie nadrzędnym intents . Umożliwia to dostęp programowy bez konieczności znajdowania intencji w tablicy: prediction.intents.give. W wersji 2 zostały one zwrócone w tablicy.
verbose Dołącz więcej szczegółów jednostek boolean Wersja 2 i wersja 3 fałsz W wersji 2 po ustawieniu wartości true wszystkie przewidywane intencje zostały zwrócone. Jeśli potrzebujesz wszystkich przewidywanych intencji, użyj parametru V3 .show-all-intents

W wersji 3 ten parametr zawiera tylko szczegóły metadanych jednostki przewidywania jednostki.
timezoneOffset - string Wersja 2 - Strefa czasowa zastosowana do jednostek datetimeV2.
datetimeReference - string V3 - Strefa czasowa zastosowana do jednostek datetimeV2. Zamienia wartość timezoneOffset z wersji 2.

Schemat aplikacji

Schemat aplikacji jest importowany i eksportowany w formacie .json lub.lu.

Zestawy SDK oparte na języku

Język Dokumentacja referencyjna Pakiet Przewodniki Szybki start
C# Przewidywanie tworzenia
 Tworzenie pakietów NuGet
Przewidywanie narzędzia NuGet		 Tworzenie
Przewidywanie zapytań
Go Tworzenie i przewidywanie SDK
Java Tworzenie i przewidywanie Tworzenie narzędzia Maven
Przewidywanie narzędzia Maven
JavaScript Tworzenie
Przewidywanie		 Tworzenie npm
Przewidywanie npm		 Tworzenie
Przewidywanie
Python Tworzenie i przewidywanie Pip Tworzenie
Przewidywanie

Kontenery

Usługa Language Understanding (LUIS) udostępnia kontener umożliwiający dostarczanie lokalnych i zawartych wersji aplikacji.

Eksportowanie i importowanie formatów

Usługa Language Understanding umożliwia zarządzanie aplikacją i jej modelami w formacie JSON, .LU formacie (LUDown) i skompresowanym pakiecie dla kontenera usługi Language Understanding.

Importowanie i eksportowanie tych formatów jest dostępne z interfejsów API i z portalu usługi LUIS. Portal udostępnia import i eksport w ramach listy Aplikacje i listy Wersje.

Warsztaty

Narzędzia ciągłej integracji

Narzędzia platformy Bot Framework

Platforma botów jest dostępna jako zestaw SDK w różnych językach i jako usługa przy użyciu usługi Azure AI Bot Service.

Platforma botów udostępnia kilka narzędzi , które ułatwiają usługę Language Understanding, w tym:

  • Bot Framework Emulator — aplikacja klasyczna, która umożliwia deweloperom botów testowanie i debugowanie botów utworzonych przy użyciu zestawu SDK platformy Bot Framework
  • Bot Framework Composer — zintegrowane narzędzie programistyczne dla deweloperów i zespołów wielodyscyplinarnych w celu tworzenia botów i środowisk konwersacyjnych za pomocą platformy Microsoft Bot Framework
  • Przykłady platformy Bot Framework — w języku #C, JavaScript, TypeScript i Python

Następne kroki