SDK-, REST- en CLI-resources voor ontwikkelaars voor Language Understanding (LUIS)
SDK's, REST API's, CLI helpen u bij het ontwikkelen Language Understanding apps (LUIS) in uw programmeertaal. Uw Azure-resources en LUIS-voorspellingen beheren.
Azure-resourcebeheer
Gebruik de Azure Cognitive Services Management-laag om de resource van de Language Understanding of Cognitive Service te maken, bewerken, weer te Language Understanding te verwijderen.
Zoek referentiedocumentatie op basis van het hulpprogramma:
Language Understanding-ontwerp- en voorspellingsaanvragen
De Language Understanding-service is toegankelijk vanuit een Azure-resource die u moet maken. Er zijn twee resources:
- Gebruik de ontwerpresource voor training om te maken, bewerken, trainen en publiceren.
- Gebruik de voorspelling voor runtime om tekst van de gebruiker te verzenden en een voorspelling te ontvangen.
Meer informatie over het V3-voorspellings-eindpunt.
Gebruik Cognitive Services voorbeeldcode om de meest voorkomende taken te leren en te gebruiken.
REST-specificaties
De LUIS REST-specificaties, samen met alle Azure REST-specificaties,zijn openbaar beschikbaar op GitHub.
REST-API’s
Api's voor ontwerp- en voorspellings-eindpunten zijn beschikbaar via REST API's:
| Type | Versie |
|---|---|
| Ontwerpen | V2 preview-versie V3 |
| Voorspelling | V2 V3 |
REST-eindpunten
LUIS heeft momenteel twee typen eindpunten:
- maken op het eindpunt van de training
- queryvoorspelling op het runtime-eindpunt.
| Doel | URL |
|---|---|
| V2-ontwerp op trainings-eindpunt | https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/ |
| V3-ontwerp op trainings-eindpunt | https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/ |
| V2-voorspelling - alle voorspellingen over runtime-eindpunt | 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-voorspelling - versievoorspelling op runtime-eindpunt | 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-voorspelling - slotvoorspelling op runtime-eindpunt | 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 de volgende tabel worden de parameters in de vorige tabel uitgelegd, aangeduid met accolades. {}
| Parameter | Doel |
|---|---|
your-resource-name |
Azure-resourcenaam |
q of query |
utterancetekst verzonden vanuit clienttoepassing zoals chatbot |
version |
Versienaam van 10 tekens |
slot |
production of staging |
Parameters voor REST-queryreeks
Para meters voor de V3 API-query reeks zijn:
| Queryparameter | Naam van LUIS-Portal | Type | Versie | Standaard | Doel |
|---|---|---|---|---|---|
log |
Logboeken opslaan | booleaans | V2 & V3 | onjuist | Sla de query op in het logboek bestand. De standaard waarde is False. |
query |
- | tekenreeks | Alleen v3 | Geen standaard-dit is vereist in de GET-aanvraag | In v2 bevindt de utterance die moet worden voor speld in de q para meter. In v3 wordt de functionaliteit door gegeven in de query para meter. |
show-all-intents |
Scores voor alle intenties toevoegen | booleaans | Alleen v3 | onjuist | Alle intenties retour neren met de bijbehorende Score in het object voor spellingen . Intenties worden geretourneerd als objecten in een bovenliggend intents object. Zo kunt u programmatisch toegang krijgen zonder dat u de bedoeling in een matrix hoeft te vinden: prediction.intents.give . In v2 zijn deze geretourneerd in een matrix. |
verbose |
Meer details van entiteiten toevoegen | booleaans | V2 & V3 | onjuist | In v2 zijn alle voorspelde intenten geretourneerd als deze zijn ingesteld op True. Als u alle voorspelde intenties nodig hebt, gebruikt u de V3-para meter van show-all-intents .In v3 biedt deze para meter alleen details van entiteits-meta gegevens van de voor spelling van de entiteit. |
timezoneOffset |
- | tekenreeks | V2 | - | De tijd zone die wordt toegepast op datetimeV2-entiteiten. |
datetimeReference |
- | tekenreeks | V3 | - | De tijd zone die wordt toegepast op datetimeV2-entiteiten. Vervangt door timezoneOffset v2. |
App-schema
Het app-schema wordt geïmporteerd en geëxporteerd in de .json indeling of .lu .
Op taal gebaseerde SDK's
| Taal | Referentiedocumentatie | Pakket | Snelstartgidsen |
|---|---|---|---|
| C# | OntwerpenVoorspelling | NuGet-ontwerp NuGet-voorspelling |
Ontwerpen Queryvoorspelling |
| Go | Maken en voorspellen | Sdk | |
| Java | Maken en voorspellen | Maven-ontwerp Maven-voorspelling |
|
| Javascript | Ontwerpen Voorspelling |
NPM-ontwerp NPM-voorspelling |
Ontwerpen Voorspelling |
| Python | Maken en voorspellen | Pip | Ontwerpen Voorspelling |
Containers
Language Understanding (LUIS) biedt een container voor on-premises en ingesloten versies van uw app.
Indelingen exporteren en importeren
Language Understanding biedt de mogelijkheid om uw app en de modellen ervan te beheren in een JSON-indeling, de .LU indeling(LUDown)en een gecomprimeerd pakket voor de Language Understanding container.
Het importeren en exporteren van deze indelingen is beschikbaar via de API's en vanuit de LUIS-portal. De portal biedt importeren en exporteren als onderdeel van de lijst Met apps en versies.
Workshops
Hulpprogramma's voor continue integratie
- GitHub: (preview) Een LUIS-app ontwikkelen met behulp van DevOps-procedures
- GitHub: NLU. DevOps: hulpprogramma's voor continue integratie en implementatie voor NLU-services.
Bot Framework hulpprogramma's
Het bot-framework is beschikbaar als een SDK in verschillende talen en als een service met behulp van Azure Bot Service.
Bot Framework biedt verschillende hulpprogramma's voor Language Understanding, waaronder:
- Bot Framework emulator: een bureaubladtoepassing waarmee botontwikkelaars bots kunnen testen en fouten kunnen opsporen die zijn gebouwd met de Bot Framework SDK
- Bot Framework Composer: een geïntegreerd ontwikkelhulpprogramma voor ontwikkelaars en teams met meerdere ontwikkelmogelijkheden om bots en gesprekservaringen met de Microsoft Bot Framework
- Bot Framework voorbeelden : in #C, JavaScript, TypeScript en Python
Volgende stappen
- Meer informatie over de algemene HTTP-foutcodes
- Referentiedocumentatie voor alle API's en SDK's
- Bot-framework en -Azure Bot Service
- LUDown
- Cognitieve containers