Udostępnij za pomocą

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

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.

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 azure AI, aby tworzyć, edytować, wyświetlać i usuwać zasób usług Azure 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.
Przeznaczenie adres 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 Przeznaczenie
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 Przeznaczenie
log Zapisywanie dzienników typ logiczny (boolowski) Wersja 2 i wersja 3 fałsz Zapisz zapytanie w pliku dziennika. Wartość domyślna to false.
query - ciąg 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 typ logiczny (boolowski) 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 typ logiczny (boolowski) 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 - ciąg Wersja 2 - Strefa czasowa zastosowana do jednostek datetimeV2.
datetimeReference - ciąg Wersja 3 - 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 Zestaw 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 Tworzenie
Przewidywanie

Containers

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 Azure 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

  • Last updated on