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 query q 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 staging production 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# | RedigeringAuthoringFö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
- GitHub: (Workshop) konversational-AI: NLU med LuisGitHub: (Workshop) Conversational-AI : NLU using LUIS
Verktyg för kontinuerlig integreringContinuous integration tools
- GitHub: (för hands version) utveckla en Luis-app med hjälp av DevOps-metoderGitHub: (Preview) Developing a LUIS app using DevOps practices
- GitHub: NLU. DevOps -verktyg som stöder kontinuerlig integrering och distribution av NLU-tjänster.GitHub: NLU.DevOps - Tools supporting continuous integration and deployment for NLU services.
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
- Läs mer om vanliga http-felkoderLearn about the common HTTP error codes
- Referens dokumentation för alla API: er och SDK: erReference documentation for all APIs and SDKs
- Bot Framework och Azure bot serviceBot framework and Azure Bot Service
- LUDownLUDown
- Kognitiva behållareCognitive Containers