SDK-, REST- und CLI-Entwicklerressourcen für LUIS (Language Understanding)SDK, REST, and CLI developer resources for Language Understanding (LUIS)

  • 3 Minuten Lesedauer

SDKs, REST-APIs und CLI unterstützen Sie beim Entwickeln von LUIS-Anwendungen (Language Understanding) in Ihrer Programmiersprache.SDKs, REST APIs, CLI, help you develop Language Understanding (LUIS) apps in your programming language. Verwalten Sie Ihre Azure-Ressourcen und LUIS-Vorhersagen.Manage your Azure resources and LUIS predictions.

Azure-RessourcenverwaltungAzure resource management

Verwenden Sie die Azure Cognitive Services Management-Ebene, um die Ressource Language Understanding oder Cognitive Service zu erstellen, zu bearbeiten, aufzulisten und zu löschen.Use the Azure Cognitive Services Management layer to create, edit, list, and delete the Language Understanding or Cognitive Service resource.

Suchen Sie nach der Referenzdokumentation auf Grundlage des Tools:Find reference documentation based on the tool:

Erstellungs- und Vorhersageanforderungen für Language UnderstandingLanguage Understanding authoring and prediction requests

Der Zugriff auf den Language Understanding-Dienst erfolgt über eine Azure-Ressource, die Sie erstellen müssen.The Language Understanding service is accessed from an Azure resource you need to create. Dafür gibt es zwei Ressourcen:There are two resources:

  • Verwenden Sie die Ressource Erstellung für das Training, um zu erstellen, zu bearbeiten, zu trainieren und zu veröffentlichen.Use the authoring resource for training to create, edit, train, and publish.
  • Verwenden Sie Vorhersage als Runtime, um den Text eines Benutzers zu senden und eine Vorhersage zu erhalten.Use the prediction for runtime to send user's text and receive a prediction.

Erfahren Sie mehr über den V3-Vorhersageendpunkt.Learn about the V3 prediction endpoint.

Verwenden Sie den Cognitive Services-Beispielcode, um die häufigsten Aufgaben zu erlernen und zu verwenden.Use Cognitive Services sample code to learn and use the most common tasks.

REST-SpezifikationenREST specifications

Die LUIS REST-Spezifikationen sind zusammen mit allen Azure REST-Spezifikationen öffentlich auf GitHub erhältlich.The LUIS REST specifications, along with all Azure REST specifications, are publicly available on GitHub.

REST-APIsREST APIs

Sowohl Erstellungs- als auch Vorhersage-Endpunkt-APIs sind über Rest-APIs verfügbar:Both authoring and prediction endpoint APIS are available from REST APIs:

typeType VersionVersion
ErstellenAuthoring Version 2V2
Vorschau der Version 3preview V3
VorhersagePrediction Version 2V2
Version 3V3

REST-EndpunkteREST Endpoints

LUIS weist zurzeit 2 Arten von Endpunkten auf:LUIS currently has 2 types of endpoints:

  • Erstellung auf dem Trainingsendpunktauthoring on the training endpoint
  • Abfragevorhersage auf dem Laufzeitendpunktquery prediction on the runtime endpoint.
ZweckPurpose URLURL
Version 2: Erstellung auf dem TrainingsendpunktV2 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Version 3: Erstellung auf dem TrainingsendpunktV3 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Version 2: alle Vorhersagen auf dem LaufzeitendpunktV2 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]
Version 3: Versionsvorhersage auf dem LaufzeitendpunktV3 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]
Version 3: Slotvorhersage auf dem LaufzeitendpunktV3 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]

In der folgende Tabelle werden die Parameter erläutert, die in der vorherigen Tabelle durch geschweifte Klammern {} gekennzeichnet sind.The following table explains the parameters, denoted with curly braces {}, in the previous table.

ParameterParameter ZweckPurpose
your-resource-name Name der Azure-RessourceAzure resource name
q oder queryq or query Äußerungstext, der von der Clientanwendung gesendet wird, wie z.B. ein Chatbotutterance text sent from client application such as chat bot
version Versionsname aus 10 Zeichen10 character version name
slot production oder stagingproduction or staging

REST-AbfragezeichenfolgenparameterREST query string parameters

Zu den V3 API-Abfragezeichenfolge-Parametern zählen:V3 API query string parameters include:

Query parameter (Abfrageparameter)Query parameter LUIS-PortalnameLUIS portal name typeType VersionVersion StandardDefault ZweckPurpose
log Protokolle speichernSave logs booleanboolean V2 und V3V2 & V3 falsefalse Speichern Sie die Abfrage in der Protokolldatei.Store query in log file. Der Standardwert ist „false“.Default value is false.
query - Zeichenfolgestring Nur V3V3 only Kein Standardwert: in GET-Anforderung erforderlichNo default - it is required in the GET request In V2 enthält der q-Parameter die vorherzusagende Äußerung.In V2, the utterance to be predicted is in the q parameter.

In V3 wird der query-Parameter verwendet, um anzugeben, dass dieses Feature verwendet werden soll.In V3, the functionality is passed in the query parameter.
show-all-intents Ergebnisse für alle Absichten einbeziehenInclude scores for all intents booleanboolean Nur V3V3 only falsefalse Alle Absichten mit der entsprechenden Bewertung werden innerhalb des prediction.intents-Objekts zurückgegeben.Return all intents with the corresponding score in the prediction.intents object. Absichten werden als Objekte in einem übergeordneten intents-Objekt zurückgegeben.Intents are returned as objects in a parent intents object. prediction.intents.give ermöglicht den programmgesteuerten Zugriff, ohne die Absicht im Array suchen zu müssen.This allows programmatic access without needing to find the intent in an array: prediction.intents.give. In V2 werden diese Absichten in einem Array zurückgegeben.In V2, these were returned in an array.
verbose Mehr Entitätendetails einbeziehenInclude more entities details booleanboolean V2 und V3V2 & V3 falsefalse Wenn in V2 TRUE festgelegt wird, werden alle vorhergesagten Absichten zurückgegeben.In V2, when set to true, all predicted intents were returned. Wenn Sie alle vorhergesagten Absichten abrufen müssen, verwenden Sie den V3-Parameter von show-all-intents.If you need all predicted intents, use the V3 param of show-all-intents.

In V3 stellt dieser Parameter nur Details zu Entitätsmetadaten einer Entitätsvorhersage bereit.In V3, this parameter only provides entity metadata details of entity prediction.
timezoneOffset - Zeichenfolgestring V2V2 - Zeitzone angewendet auf datetimeV2-Entitäten.Timezone applied to datetimeV2 entities.
datetimeReference - Zeichenfolgestring V3V3 - Zeitzone angewendet auf datetimeV2-Entitäten.Timezone applied to datetimeV2 entities. Ersetzt timezoneOffset aus V2.Replaces timezoneOffset from V2.

App-SchemaApp schema

Das App-Schema wird im Format .json oder .lu importiert/exportiert.The app schema is imported and exported in a .json or .lu format.

Sprachbasierte SDKsLanguage-based SDKs

SpracheLanguage ReferenzdokumentationReference documentation PaketPackage SchnellstartsQuickstarts
C#C# ErstellungAuthoring
VorhersagePrediction		 NuGet-ErstellungNuGet authoring
NuGet-VorhersageNuGet prediction		 ErstellungAuthoring
AbfragevorhersageQuery prediction
GoGo Erstellung und VorhersageAuthoring and prediction SDKSDK
JavaJava Erstellung und VorhersageAuthoring and prediction Maven-ErstellungMaven authoring
Maven-VorhersageMaven prediction
JavaScriptJavaScript ErstellungAuthoring
VorhersagePrediction		 NPM-ErstellungNPM authoring
NPM-VorhersageNPM prediction		 ErstellungAuthoring
VorhersagePrediction
PythonPython Erstellung und VorhersageAuthoring and prediction PipPip ErstellungAuthoring
VorhersagePrediction

ContainerContainers

Language Understanding (LUIS) stellt einen Container bereit, um lokale und in Containern enthaltene Versionen Ihrer App bereitzustellen.Language Understanding (LUIS) provides a container to provide on-premises and contained versions of your app.

Export- und ImportformateExport and import formats

Language Understanding bietet die Möglichkeit, Ihre App und ihre Modelle in einem JSON-Format, dem .LU-Format (LUDown), und einem komprimierten Paket für den Language Understanding-Container zu verwalten.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.

Das Importieren und Exportieren in diesen Formaten ist über die APIs und das LUIS-Portal möglich.Importing and exporting these formats is available from the APIs and from the LUIS portal. Das Portal bietet Import und Export als Teil der App-Liste und der Versionsliste.The portal provides import and export as part of the Apps list and Versions list.

WorkshopsWorkshops

Tools für Continuous IntegrationContinuous integration tools

Bot Framework-ToolsBot Framework tools

Das Bot Framework ist als SDK in einer Vielzahl von Sprachen und als Dienst mit Azure Bot Service verfügbar.The bot framework is available as an SDK in a variety of languages and as a service using Azure Bot Service.

Bot Framework bietet verschiedene Tools, um bei Language Understanding zu helfen, einschließlich:Bot framework provides several tools to help with Language Understanding, including:

  • Bot Framework-Emulator: Eine Desktopanwendung, mit der Entwickler von Bots mit dem Bot Framework SDK erstellte Bots testen und debuggen könnenBot Framework emulator - a desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK
  • Bot Framework Composer: Ein integriertes Entwicklungstool für Entwickler und bereichsübergreifende Teams zum Erstellen von Bots und Konversationsumgebungen mit 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-Beispiele in C#, JavaScript, TypeScript und PythonBot Framework Samples - in #C, JavaScript, TypeScript, and Python

Nächste SchritteNext steps