SDK-, REST- och CLI-utvecklarresurser för Language Understanding (LUIS)
SDK:er, REST-API:er, CLI, hjälper dig att Language Understanding (LUIS)-appar på ditt programmeringsspråk. Hantera dina Azure-resurser och LUIS-förutsägelser.
Azure-resurshantering
Använd Azure Cognitive Services Management för att skapa, redigera, lista och ta bort Language Understanding eller Cognitive Service-resursen.
Hitta referensdokumentation baserat på verktyget:
Language Understanding redigerings- och förutsägelsebegäranden
Tjänsten Language Understanding nås från en Azure-resurs som du behöver skapa. Det finns två resurser:
- Använd redigeringsresursen för träning för att skapa, redigera, träna och publicera.
- Använd förutsägelsen för körning för att skicka användarens text och ta emot en förutsägelse.
Läs mer om V3-förutsägelseslutpunkten.
Använd Cognitive Services exempelkod för att lära dig och använda de vanligaste uppgifterna.
REST-specifikationer
LUIS REST-specifikationerna,tillsammans med alla Azure REST-specifikationer,är offentligt tillgängliga på GitHub.
REST API:er
Api:er för både redigering och förutsägelseslutpunkt är tillgängliga från REST API:er:
| Typ | Version |
|---|---|
| Redigering | V2 förhandsversion V3 |
| Förutsägelse | V2 V3 |
REST-slutpunkter
LUIS har för närvarande 2 typer av slutpunkter:
- redigering på träningsslutpunkten
- frågeförutsägelse på körningsslutpunkten.
| Syfte | URL |
|---|---|
| V2-redigering på träningsslutpunkt | https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/ |
| V3-redigering på träningsslutpunkt | https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/ |
| V2-förutsägelse – alla förutsägelser på körningsslutpunkt | 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 – versionsförutsägelse för körningsslutpunkt | 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 – platsförutsägelse på körningsslutpunkt | 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, som betecknas med kparenteser {} , i föregående tabell.
| Parameter | Syfte |
|---|---|
your-resource-name |
Azure-resursnamn |
q eller query |
ta emot text som skickas från klientprogram, till exempel chattrobot |
version |
Versionsnamn på 10 tecken |
slot |
production eller staging |
REST-frågesträngsparametrar
V3 API-frågeparametrar innehåller:
| Frågeparameter | LUIS-portalens namn | Typ | Version | Standardvärde | Syfte |
|---|---|---|---|---|---|
log |
Spara loggar | boolean | V2 & V3 | falskt | Lagra fråga i logg filen. Standardvärdet är false. |
query |
- | sträng | Endast v3 | Ingen standard – det krävs i GET-begäran | I v2 är uttryck som ska förutsägas i q parametern. I v3 skickas funktionerna i- query parametern. |
show-all-intents |
Inkludera resultat för alla avsikter | boolean | Endast v3 | falskt | Returnera alla avsikter med motsvarande Poäng i objektet förutsägelse. avsikter . Avsikter returneras som objekt i ett överordnat intents objekt. Detta ger program mässig åtkomst utan att behöva hitta avsikten i en matris: prediction.intents.give . I v2 returnerades dessa i en matris. |
verbose |
Ta med mer information om entiteter | boolean | V2 & V3 | falskt | I v2 returnerades alla förväntade avsikter när värdet är true. Om du behöver alla förutsägande syften använder du v3-parametrarna för show-all-intents .I v3 innehåller den här parametern endast information om entitetens metadata för entitet förutsägelse. |
timezoneOffset |
- | sträng | V2 | - | Tids zonen som används för datetimeV2-entiteter. |
datetimeReference |
- | sträng | V3 | - | Tids zonen som används för datetimeV2-entiteter. Ersätter timezoneOffset från v2. |
Appschema
Appschemat importeras och exporteras i .json ett - eller .lu -format.
Språkbaserade SDK:er
| Språk | Referensdokumentation | Paket | Snabbstarter |
|---|---|---|---|
| C# | RedigeringPrognos | NuGet-redigering NuGet-förutsägelse |
Redigering Frågeförutsägelse |
| Go | Redigering och förutsägelse | Sdk | |
| Java | Redigering och förutsägelse | Maven-redigering Maven-förutsägelse |
|
| JavaScript | Redigering Prognos |
NPM-redigering NPM-förutsägelse |
Redigering Prognos |
| Python | Redigering och förutsägelse | Pip | Redigering Prognos |
Containers
Language Understanding (LUIS) tillhandahåller en container för att tillhandahålla lokala och inneslutna versioner av din app.
Export- och importformat
Language Understanding ger möjlighet att hantera din app och dess modeller i JSON-format, (LUDown)-format och ett komprimerat paket .LU för Language Understanding containern.
Import och export av dessa format är tillgängligt från API:erna och från LUIS-portalen. Portalen tillhandahåller import och export som en del av listan appar och versioner.
Workshops
- GitHub: (Workshop) Conversational-AI: NLU med LUIS
Verktyg för kontinuerlig integrering
- GitHub: (förhandsversion) Utveckla en LUIS-app med hjälp av DevOps-metoder
- GitHub: NLU. DevOps – Verktyg som stöder kontinuerlig integrering och distribution för NLU-tjänster.
Bot Framework verktyg
Robotramverket är tillgängligt som SDK på flera olika språk och som en tjänst med hjälp av Azure Bot Service.
Bot Framework innehåller flera verktyg för att hjälpa Language Understanding, inklusive:
- Bot Framework emulator – ett skrivbordsprogram som gör att robotutvecklare kan testa och felsöka robotar som skapats med hjälp av Bot Framework SDK
- Bot Framework Composer – ett integrerat utvecklingsverktyg för utvecklare och team med flera funktioner för att skapa robotar och konversationsupplevelser med Microsoft Bot Framework
- Bot Framework exempel – i #C, JavaScript, TypeScript och Python
Nästa steg
- Läs mer om vanliga HTTP-felkoder
- Referensdokumentation för alla API:er och SDK:er
- Bot framework and Azure Bot Service
- LUDown
- Kognitiva containrar