SDK-, REST- en CLI-ontwikkelaarsbronnen voor Language Understanding (LUIS)

  • Artikel

Belangrijk

LUIS wordt op 1 oktober 2025 buiten gebruik gesteld en vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken. We raden u aan uw LUIS-toepassingen te migreren naar gesprekstaalbegrip om te profiteren van continue productondersteuning en meertalige mogelijkheden.

SDK's, REST API's, CLI, helpen u bij het ontwikkelen van LUIS-apps (Language Understanding) in uw programmeertaal. Beheer uw Azure-resources en LUIS-voorspellingen.

Azure-resourcebeheer

Gebruik de beheerlaag van Azure AI-services om de Language Understanding- of Azure AI-servicesresource te maken, te bewerken, weer te geven en te verwijderen.

Referentiedocumentatie zoeken op basis van het hulpprogramma:

Language Understanding-creatie- en voorspellingsaanvragen

De Language Understanding-service wordt geopend 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 de tekst van de gebruiker te verzenden en een voorspelling te ontvangen.

Gebruik voorbeeldcode van Azure AI-services 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 creatie- en voorspellingseindpunten zijn beschikbaar via REST API's:

Type Versie
Ontwerpen V2
preview V3
Voorspelling V2
V3

REST-eindpunten

LUIS heeft momenteel twee typen eindpunten:

  • ontwerpen op het trainingseindpunt
  • queryvoorspelling op het runtime-eindpunt.
Doel URL
V2-creatie op trainingseindpunt https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
V3-creatie op trainingseindpunt https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
V2-voorspelling : alle voorspellingen op 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- versiesvoorspelling 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, aangeduid met accolades {}, in de vorige tabel uitgelegd.

Parameter Doel
your-resource-name Azure-resourcenaam
q of query Uitingstekst verzonden vanuit clienttoepassing, zoals een chatbot
version Naam van versie van 10 tekens
slot production of staging

REST-queryreeksparameters

V3 API-queryreeksparameters zijn:

Queryparameter NAAM VAN LUIS-portal Type Versie Standaard Doel
log Logboeken opslaan boolean V2 & V3 false Sla query's op in het logboekbestand. De standaardwaarde is false.
query - tekenreeks Alleen V3 Geen standaardwaarde. Dit is vereist in de GET-aanvraag In V2 bevindt de te voorspellen uiting zich in de q parameter.

In V3 wordt de functionaliteit doorgegeven in de query parameter.
show-all-intents Scores voor alle intenties opnemen boolean Alleen V3 false Retourneert alle intenties met de bijbehorende score in het object prediction.intents . Intenties worden geretourneerd als objecten in een bovenliggend intents object. Hierdoor is programmatische toegang mogelijk zonder dat u de intentie in een matrix hoeft te vinden: prediction.intents.give. In V2 zijn deze geretourneerd in een matrix.
verbose Meer details van entiteiten opnemen boolean V2 & V3 false In V2, wanneer deze is ingesteld op waar, werden alle voorspelde intenties geretourneerd. Als u alle voorspelde intenties nodig hebt, gebruikt u de V3-param van show-all-intents.

In V3 biedt deze parameter alleen details van entiteitsmetagegevens van entiteitsvoorspelling.
timezoneOffset - tekenreeks V2 - Tijdzone toegepast op datum/tijdV2-entiteiten.
datetimeReference - tekenreeks V3 - Tijdzone toegepast op datum/tijdV2-entiteiten. timezoneOffset Vervangt door V2.

App-schema

Het app-schema wordt geïmporteerd en geëxporteerd in een .json of .lu indeling.

Taalgebaseerde SDK's

Taal Referentiedocumentatie Pakket Snelstartgidsen
C# Voorspelling ontwerpen
 NuGet-creatie
NuGet-voorspelling		 Ontwerpen
Queryvoorspelling
Go Ontwerpen en voorspellen SDK
Java Ontwerpen en voorspellen Maven-creatie
Maven-voorspelling
JavaScript Ontwerpen
Prediction		 NPM-creatie
NPM-voorspelling		 Ontwerpen
Prediction
Python Ontwerpen en voorspellen Pip Ontwerpen
Prediction

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 bijbehorende modellen te beheren in een JSON-indeling, de .LU (LUDown)-indeling 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

Bot Framework-hulpprogramma's

Het botframework is beschikbaar als EEN SDK in verschillende talen en als een service met behulp van Azure AI Bot Service.

Bot Framework biedt verschillende hulpprogramma's om te helpen met Language Understanding, waaronder:

  • Bot Framework-emulator : een bureaubladtoepassing waarmee botontwikkelaars bots kunnen testen en er fouten in kunnen opsporen die zijn gebouwd met behulp van de Bot Framework SDK
  • Bot Framework Composer - een geïntegreerd ontwikkelhulpprogramma voor ontwikkelaars en multidisciplinaire teams om bots en gesprekservaringen te bouwen met het Microsoft Bot Framework
  • Bot Framework-voorbeelden : in #C, JavaScript, TypeScript en Python

Volgende stappen