Zasoby dla deweloperów zestawu SDK, interfejsu REST i interfejsu wiersza Language Understanding (LUIS)SDK, REST, and CLI developer resources for Language Understanding (LUIS)

Zestawy SDK, interfejsy API REST i interfejs wiersza polecenia ułatwiają tworzenie Language Understanding (LUIS) w języku programowania.SDKs, REST APIs, CLI, help you develop Language Understanding (LUIS) apps in your programming language. Zarządzanie zasobami platformy Azure i przewidywaniami usługi LUIS.Manage your Azure resources and LUIS predictions.

Zarządzanie zasobami platformy AzureAzure resource management

Warstwa zarządzania Azure Cognitive Services umożliwia tworzenie, edytowanie, tworzenie listy i usuwanie zasobu Language Understanding usług Cognitive Service.Use the Azure Cognitive Services Management layer to create, edit, list, and delete the Language Understanding or Cognitive Service resource.

Znajdź dokumentację referencyjną opartą na narzędziu:Find reference documentation based on the tool:

Language Understanding tworzenia i przewidywaniaLanguage Understanding authoring and prediction requests

Dostęp do Language Understanding jest uzyskiwany z zasobu platformy Azure, który należy utworzyć.The Language Understanding service is accessed from an Azure resource you need to create. Istnieją dwa zasoby:There are two resources:

  • Użyj zasobu tworzenia do szkolenia w celu tworzenia, edytowania, trenowania i publikowania.Use the authoring resource for training to create, edit, train, and publish.
  • Użyj przewidywania dla środowiska uruchomieniowego, aby wysłać tekst użytkownika i otrzymać przewidywanie.Use the prediction for runtime to send user's text and receive a prediction.

Dowiedz się więcej o punkcie końcowym przewidywania w wersji 3.Learn about the V3 prediction endpoint.

Użyj Cognitive Services przykładowego kodu, aby nauczyć się i korzystać z najczęściej wykonywanych zadań.Use Cognitive Services sample code to learn and use the most common tasks.

Specyfikacje RESTREST specifications

Specyfikacje REST usługi LUISwraz ze wszystkimi specyfikacjami REST platformy Azuresą publicznie dostępne w witrynie GitHub.The LUIS REST specifications, along with all Azure REST specifications, are publicly available on GitHub.

Interfejsy API RESTREST APIs

Interfejsy API punktu końcowego tworzenia i przewidywania są dostępne z interfejsów API REST:Both authoring and prediction endpoint APIS are available from REST APIs:

TypType WersjaVersion
TworzenieAuthoring Wersja 2V2
wersja zapoznawcza 3preview V3
PrzewidywaniePrediction Wersja 2V2
Wersja 3V3

Punkty końcowe RESTREST Endpoints

Usługa LUIS ma obecnie 2 typy punktów końcowych:LUIS currently has 2 types of endpoints:

  • tworzenie w punkcie końcowym szkoleniaauthoring on the training endpoint
  • przewidywanie zapytań w punkcie końcowym środowiska uruchomieniowego.query prediction on the runtime endpoint.
PrzeznaczeniePurpose Adres URLURL
Tworzenie w wersji 2 w punkcie końcowym trenowaniaV2 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Tworzenie w wersji 3 w punkcie końcowym szkoleniaV3 Authoring on training endpoint 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 uruchomieniowegoV2 Prediction - all predictions on runtime endpoint 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 uruchomieniowegoV3 Prediction - versions prediction on runtime endpoint 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 uruchomieniowegoV3 Prediction - slot prediction on runtime endpoint 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 wyjaśniono parametry oznaczone nawiasami {} klamrowymi w poprzedniej tabeli.The following table explains the parameters, denoted with curly braces {}, in the previous table.

ParametrParameter PrzeznaczeniePurpose
your-resource-name Nazwa zasobu platformy AzureAzure resource name
q lub queryq or query tekst wypowiedzi wysyłany z aplikacji klienckiej, takiej jak czatbotutterance text sent from client application such as chat bot
version 10-znakowa nazwa wersji10 character version name
slot production lub stagingproduction or staging

Parametry ciągu zapytania RESTREST query string parameters

Parametry ciągu zapytania interfejsu API v3 obejmują:V3 API query string parameters include:

Parametr zapytaniaQuery parameter Nazwa portalu LUISLUIS portal name TypType WersjaVersion DomyślneDefault PrzeznaczeniePurpose
log Zapisz dziennikiSave logs booleanboolean WERSJA 2 & V3V2 & V3 fałszfalse Zapisz zapytanie w pliku dziennika.Store query in log file. Wartość domyślna to false.Default value is false.
query - ciągstring Tylko wersja 3V3 only Brak domyślnej — jest to wymagane w żądaniu GETNo default - it is required in the GET request W wersji 2 wypowiedź do przewidywania jest q parametrem.In V2, the utterance to be predicted is in the q parameter.

W wersji 3 funkcja jest przenoszona do query parametru.In V3, the functionality is passed in the query parameter.
show-all-intents Uwzględnij wyniki dla wszystkich intencjiInclude scores for all intents booleanboolean Tylko wersja 3V3 only fałszfalse Zwróć wszystkie intencje z odpowiednim wynikiem w obiekcie przewidywania. intencje .Return all intents with the corresponding score in the prediction.intents object. Intencje są zwracane jako obiekty w obiekcie nadrzędnym intents .Intents are returned as objects in a parent intents object. Pozwala to na dostęp programistyczny bez konieczności wyszukiwania zamiaru w tablicy: prediction.intents.give .This allows programmatic access without needing to find the intent in an array: prediction.intents.give. W wersji 2 te zostały zwrócone w tablicy.In V2, these were returned in an array.
verbose Dołącz więcej szczegółów jednostekInclude more entities details booleanboolean WERSJA 2 & V3V2 & V3 fałszfalse W wersji 2, gdy ustawiono wartość true, wszystkie przewidywane intencje zostały zwrócone.In V2, when set to true, all predicted intents were returned. Jeśli potrzebujesz wszystkich przewidywanych intencji, użyj parametru v3 show-all-intents .If you need all predicted intents, use the V3 param of show-all-intents.

W wersji 3 ten parametr zawiera tylko szczegóły metadanych jednostki przewidywania jednostek.In V3, this parameter only provides entity metadata details of entity prediction.
timezoneOffset - ciągstring Wersja 2V2 - Strefa czasowa zastosowana do jednostek datetimeV2.Timezone applied to datetimeV2 entities.
datetimeReference - ciągstring CzytanieV3 - Strefa czasowa zastosowana do jednostek datetimeV2.Timezone applied to datetimeV2 entities. Zamienia timezoneOffset z wersji 2.Replaces timezoneOffset from V2.

Schemat aplikacjiApp schema

Schemat aplikacji jest importowany i eksportowany w .json formacie lub .lu .The app schema is imported and exported in a .json or .lu format.

Zestawy SDK oparte na językuLanguage-based SDKs

JęzykLanguage Dokumentacja referencyjnaReference documentation PakietPackage Przewodniki Szybki startQuickstarts
C#C# TworzenieAuthoring
PrzewidywaniaPrediction
Tworzenie nuGetNuGet authoring
Przewidywanie nuGetNuGet prediction
TworzenieAuthoring
Przewidywanie zapytańQuery prediction
GoGo Tworzenie i przewidywanieAuthoring and prediction SdkSDK
JavaJava Tworzenie i przewidywanieAuthoring and prediction Tworzenie w mavenMaven authoring
Przewidywanie mavenMaven prediction
JavaScriptJavaScript TworzenieAuthoring
PrzewidywaniaPrediction
Tworzenie npmNPM authoring
Przewidywanie NPMNPM prediction
TworzenieAuthoring
PrzewidywaniaPrediction
PythonPython Tworzenie i przewidywanieAuthoring and prediction PipPip TworzenieAuthoring
PrzewidywaniaPrediction

KonteneryContainers

Language Understanding (LUIS) udostępnia kontener w celu zapewnienia lokalnych i zawartych wersji aplikacji.Language Understanding (LUIS) provides a container to provide on-premises and contained versions of your app.

Formaty eksportu i importuExport and import formats

Language Understanding umożliwia zarządzanie aplikacją i jej modelami w formacie JSON, w formacie .LU (LUDown)i skompresowanym pakietem dla Language Understanding kontenera.Language Understanding provides the ability to manage your app and its models in a JSON format, the .LU (LUDown) format, and a compressed package for the Language Understanding container.

Importowanie i eksportowanie tych formatów jest dostępne z interfejsów API i portalu usługi LUIS.Importing and exporting these formats is available from the APIs and from the LUIS portal. Portal umożliwia importowanie i eksportowanie w ramach listy Aplikacje i Wersje.The portal provides import and export as part of the Apps list and Versions list.

WarsztatyWorkshops

Narzędzia do ciągłej integracjiContinuous integration tools

Bot Framework narzędziBot Framework tools

Bot Framework jest dostępny jako zestaw SDK w różnych językach i jako usługa przy użyciu Azure Bot Service.The bot framework is available as an SDK in a variety of languages and as a service using Azure Bot Service.

Bot Framework udostępnia kilka narzędzi, które ułatwiają Language Understanding, w tym:Bot framework provides several tools to help with Language Understanding, including:

  • Bot Framework — aplikacja desktopowa, która umożliwia deweloperom botów testowanie i debugowanie botów budowaną przy użyciu zestawu BOT FRAMEWORK SDKBot Framework emulator - a desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK
  • Bot Framework Composer — zintegrowane narzędzie deweloperacyjne dla deweloperów i wielodyscyplinarnych zespołów do tworzenia botów i konwersacyjne środowisko pracy z Microsoft Bot FrameworkBot Framework Composer - an integrated development tool for developers and multi-disciplinary teams to build bots and conversational experiences with the Microsoft Bot Framework
  • Bot Framework przykłady — w językach #C, JavaScript, TypeScript i PythonBot Framework Samples - in #C, JavaScript, TypeScript, and Python

Następne krokiNext steps