SDK-, REST-och CLI-utvecklarresurser för Language Understanding (LUIS)SDK, REST, and CLI developer resources for Language Understanding (LUIS)

SDK: er, REST API: er, CLI, hjälper dig att utveckla Language Understanding-appar (LUIS) i ditt programmeringsspråk.SDKs, REST APIs, CLI, help you develop Language Understanding (LUIS) apps in your programming language. Hantera dina Azure-resurser och LUIS-förutsägelser.Manage your Azure resources and LUIS predictions.

Resurs hantering i AzureAzure resource management

Använd Azure-Cognitive Services hanterings lager för att skapa, redigera, Visa och ta bort Language Understanding eller kognitiva tjänst resurser.Use the Azure Cognitive Services Management layer to create, edit, list, and delete the Language Understanding or Cognitive Service resource.

Hitta referens dokumentation baserat på verktyget:Find reference documentation based on the tool:

Language Understanding redigerings-och förutsägelse begär AndenLanguage Understanding authoring and prediction requests

Language Understandings tjänsten nås från en Azure-resurs som du måste skapa.The Language Understanding service is accessed from an Azure resource you need to create. Det finns två resurser:There are two resources:

  • Använd redigerings resursen för utbildning för att skapa, redigera, träna och publicera.Use the authoring resource for training to create, edit, train, and publish.
  • Använd förutsägelse för körning för att skicka användarens text och få en förutsägelse.Use the prediction for runtime to send user's text and receive a prediction.

Läs mer om v3 förutsägelse slut punkten.Learn about the V3 prediction endpoint.

Använd Cognitive Services exempel kod för att lära dig och använda de vanligaste uppgifterna.Use Cognitive Services sample code to learn and use the most common tasks.

REST-specifikationerREST specifications

Luis rest-specifikationerna, tillsammans med alla Azure rest-specifikationer, är offentligt tillgängliga på GitHub.The LUIS REST specifications, along with all Azure REST specifications, are publicly available on GitHub.

REST API:erREST APIs

Både redigerings-och förutsägelse slut punkts-API: er är tillgängliga från REST API: er:Both authoring and prediction endpoint APIS are available from REST APIs:

TypType VersionVersion
RedigeringAuthoring 2V2
Förhandsgranska v3preview V3
FörutsägelsePrediction 2V2
V3V3

REST-slutpunkterREST Endpoints

LUIS har för närvarande två typer av slut punkter:LUIS currently has 2 types of endpoints:

  • redigering av utbildnings slut punktenauthoring on the training endpoint
  • fråga förutsägelse på körnings slut punkten.query prediction on the runtime endpoint.
SyftePurpose URLURL
V2-redigering av utbildnings slut punktV2 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
V3-redigering av utbildnings slut punktV3 Authoring on training endpoint https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
V2-förutsägelse – alla förutsägelser på runtime-slutpunktV2 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]
V3 förutsägelse-versioner förutsägelse på runtime-slutpunktV3 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]
V3 förutsägelse av förutsägelser på runtime-slutpunktV3 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]

I följande tabell förklaras parametrarna, med klammerparenteser {} , i föregående tabell.The following table explains the parameters, denoted with curly braces {}, in the previous table.

ParameterParameter SyftePurpose
your-resource-name Namn på Azure-resursAzure resource name
q eller queryq or query uttryck text som skickats från klient programmet, till exempel chatt-robotutterance text sent from client application such as chat bot
version namn på 10-siffrig version10 character version name
slot production eller stagingproduction or staging

REST-parametrar för frågesträngREST query string parameters

V3 API-frågeparametrar innehåller:V3 API query string parameters include:

FrågeparameterQuery parameter LUIS-portalens namnLUIS portal name TypType VersionVersion StandardvärdeDefault SyftePurpose
log Spara loggarSave logs booleanboolean V2 & V3V2 & V3 falsktfalse Lagra fråga i logg filen.Store query in log file. Standardvärdet är false.Default value is false.
query - strängstring Endast v3V3 only Ingen standard – det krävs i GET-begäranNo default - it is required in the GET request I v2 är uttryck som ska förutsägas i q parametern.In V2, the utterance to be predicted is in the q parameter.

I v3 skickas funktionerna i- query parametern.In V3, the functionality is passed in the query parameter.
show-all-intents Inkludera resultat för alla avsikterInclude scores for all intents booleanboolean Endast v3V3 only falsktfalse Returnera alla avsikter med motsvarande Poäng i objektet förutsägelse. avsikter .Return all intents with the corresponding score in the prediction.intents object. Avsikter returneras som objekt i ett överordnat intents objekt.Intents are returned as objects in a parent intents object. Detta ger program mässig åtkomst utan att behöva hitta avsikten i en matris: prediction.intents.give .This allows programmatic access without needing to find the intent in an array: prediction.intents.give. I v2 returnerades dessa i en matris.In V2, these were returned in an array.
verbose Ta med mer information om entiteterInclude more entities details booleanboolean V2 & V3V2 & V3 falsktfalse I v2 returnerades alla förväntade avsikter när värdet är true.In V2, when set to true, all predicted intents were returned. Om du behöver alla förutsägande syften använder du v3-parametrarna för show-all-intents .If you need all predicted intents, use the V3 param of show-all-intents.

I v3 innehåller den här parametern endast information om entitetens metadata för entitet förutsägelse.In V3, this parameter only provides entity metadata details of entity prediction.
timezoneOffset - strängstring V2V2 - Tids zonen som används för datetimeV2-entiteter.Timezone applied to datetimeV2 entities.
datetimeReference - strängstring V3V3 - Tids zonen som används för datetimeV2-entiteter.Timezone applied to datetimeV2 entities. Ersätter timezoneOffset från v2.Replaces timezoneOffset from V2.

AppschemaApp schema

Appens schema importeras och exporteras i ett- .json eller- .lu format.The app schema is imported and exported in a .json or .lu format.

Språkbaserade SDK: erLanguage-based SDKs

SpråkLanguage Referens dokumentationReference documentation PaketPackage SnabbstarterQuickstarts
C#C# RedigeringAuthoring
FörutsägelsePrediction
NuGet-redigeringNuGet authoring
NuGet förutsägelseNuGet prediction
RedigeringAuthoring
Fråga förutsägelseQuery prediction
GoGo Redigering och förutsägelseAuthoring and prediction SDKSDK
JavaJava Redigering och förutsägelseAuthoring and prediction Maven-redigeringMaven authoring
Maven förutsägelseMaven prediction
JavaScriptJavaScript RedigeringAuthoring
FörutsägelsePrediction
NPM-redigeringNPM authoring
NPM förutsägelseNPM prediction
RedigeringAuthoring
FörutsägelsePrediction
PythonPython Redigering och förutsägelseAuthoring and prediction PipPip RedigeringAuthoring
FörutsägelsePrediction

ContainersContainers

Language Understanding (LUIS) innehåller en behållare för att tillhandahålla lokala och befintliga versioner av din app.Language Understanding (LUIS) provides a container to provide on-premises and contained versions of your app.

Exportera och importera formatExport and import formats

Language Understanding ger möjlighet att hantera din app och dess modeller i ett JSON-format, .LU (LUDown)-format och ett komprimerat paket för language Understanding containern.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.

Import och export av dessa format är tillgängligt från API: erna och från LUIS-portalen.Importing and exporting these formats is available from the APIs and from the LUIS portal. Portalen innehåller import och export som en del av listan över appar och versioner.The portal provides import and export as part of the Apps list and Versions list.

WorkshopsWorkshops

Verktyg för kontinuerlig integreringContinuous integration tools

Verktyg för bot FrameworkBot Framework tools

Bot Framework är tillgängligt som en SDK på en rad olika språk och som en tjänst med hjälp av 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 innehåller flera verktyg som hjälper dig med language Understanding, inklusive:Bot framework provides several tools to help with Language Understanding, including:

  • Bot Framework-emulator – ett Skriv bords program som gör det möjligt för bot-utvecklare att testa och felsöka robotar som skapats med 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 – ett integrerat utvecklingsverktyg för utvecklare och flera disciplin team för att bygga robotar och konversations upplevelser med 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
  • Robot Framework-exempel – i #C, Java Script, typescript och pythonBot Framework Samples - in #C, JavaScript, TypeScript, and Python

Nästa stegNext steps