Veelgestelde vragen (FAQ’s) over Language Understanding

Dit artikel bevat antwoorden op veelgestelde vragen over Language Understanding (LUIS).

Nieuw

Meer informatie over wat er nieuw is in Language Understanding (LUIS).

Ontwerpen

Wat zijn de best practices voor LUIS?

Begin met de ontwerpcyclusen lees vervolgens de best practices.

Wat is de beste manier om te beginnen met het bouwen van mijn app in LUIS?

De beste manier om uw app te bouwen, is via een incrementeel proces.

Wat is een goede gewoonte om de intenties van mijn app te modelleren? Moet ik specifiekere of meer algemene intenties maken?

Kies intenties die niet zo algemeen zijn als overlappend, maar niet zo specifiek dat het voor LUIS moeilijk is om onderscheid te maken tussen vergelijkbare intenties. Het maken van discriminatieve specifieke intenties is een van de best practices voor LUIS-modellering.

Is het belangrijk om de intentie None te trainen?

Ja, het is goed om de intentie None te trainen met meer utterances naarmate u meer labels toevoegt aan andere intenties. Een goede verhouding is 1 of 2 labels die zijn toegevoegd aan Geen voor elke 10 labels die aan een intentie zijn toegevoegd. Deze verhouding verhoogt de discriminatieve kracht van LUIS.

Hoe kan ik spelfouten in utterances corrigeren?

Zie de zelfstudie Bing Spellingcontrole API V7. LUIS dwingt limieten af die zijn opgelegd door Bing Spellingcontrole API V7.

Hoe kan ik mijn LUIS-app programmatisch bewerken?

Als u uw LUIS-app programmatisch wilt bewerken, gebruikt u de ontwerp-API. Zie Luis-ontwerp-API aanroepen en Programmatisch een LUIS-app bouwen met behulp van Node.jsvoor voorbeelden van het aanroepen van de ontwerp-API. De ontwerp-API vereist dat u een ontwerpsleutel gebruikt in plaats van een eindpuntsleutel. Programmatisch schrijven staat maximaal 1.000.000 aanroepen per maand en vijf transacties per seconde toe. Zie Sleutels beheren voor meer informatie over de sleutels die u met LUIS gebruikt.

Waar is de patroonfunctie waarmee reguliere expressies zijn gevonden?

De vorige patroonfunctie is momenteel afgeschaft, vervangen door Patterns.

Hoe kan ik entiteit gebruiken om de juiste gegevens op te halen?

Moeten variaties van een voorbeeld-utterance leestekens bevatten?

Gebruik een van de volgende oplossingen:

Ondersteunt LUIS momenteel Cortana?

Cortana vooraf gebouwde apps zijn afgeschaft in 2017. Ze worden niet meer ondersteund.

Hoe kan ik eigendom van een LUIS-app overdragen?

Als u een LUIS-app wilt overdragen naar een ander Azure-abonnement, exporteert u de LUIS-app en importeert u deze met een nieuw account. Werk de LUIS-app-id bij in de clienttoepassing die deze aanroept. De nieuwe app retourneert mogelijk iets andere LUIS-scores dan de oorspronkelijke app.

Een vooraf gemaakte entiteit wordt getagd in een voorbeeld-utterance in plaats van mijn aangepaste entiteit. Hoe kan ik dit probleem oplossen?

In de LUIS-portal kunt u tekst labelen voor de exacte entiteit die u wilt extraheren. Als in de LUIS-portal niet de juiste entiteitsvoorspelling wordt weergegeven, moet u mogelijk meer utterances toevoegen en de entiteit labelen in de tekst of een functie toevoegen.

Ik heb geprobeerd een app of versiebestand te importeren, maar er is een fout opgetreden. Wat is er gebeurd?

Lees meer over fouten bij het importeren van versies.

Samenwerken en bijdragen

Hoe kan ik samenwerkers toegang geven tot LUIS met Azure Active Directory (Azure AD) of op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC)?

Zie Azure Active Directory resources en Azure Active Directory tenantgebruiker voor meer informatie over het verlenen van toegang aan samenwerkers.

Eindpunt

Ik heb een HTTP 403-foutstatuscode ontvangen. Hoe kan ik dit probleem oplossen?

U krijgt 403- en 429-foutstatuscodes wanneer u de transacties per seconde of transacties per maand voor uw prijscategorie overschrijdt. Verhoog uw prijscategorie of gebruik Language Understanding containers.

Wanneer u al deze gratis 1000 eindpuntquery's gebruikt of als u het quotum voor maandelijkse transacties van uw prijscategorie overschrijdt, ontvangt u een HTTP 403-foutstatuscode.

Als u deze fout wilt oplossen, moet u de prijscategorie wijzigen in een hogere laag of een nieuwe resource maken en deze toewijzen aan uw app.

Oplossingen voor deze fout zijn onder andere:

  • Wijzig in Azure Portal, op uw Language Understanding-resource, in de prijscategorie Resource Management -> uw prijscategorie in een hogere TPS-laag. U hoeft niets te doen in de Language Understanding portal als uw resource al is toegewezen aan uw Language Understanding app.
  • Als uw gebruik de hoogste prijscategorie overschrijdt, voegt u meer resources Language Understanding een load balancer er voor staat. De Language Understanding container met Kubernetes of Docker Compose kan daarbij helpen.

Ik heb een HTTP 429-foutstatuscode ontvangen. Hoe kan ik dit probleem oplossen?

U krijgt 403- en 429-foutstatuscodes wanneer u de transacties per seconde of transacties per maand voor uw prijscategorie overschrijdt. Verhoog uw prijscategorie of gebruik Language Understanding containers.

Deze statuscode wordt geretourneerd wanneer uw transacties per seconde de prijscategorie overschrijden.

Oplossingen zijn onder andere:

  • U kunt uw prijscategorie verhogenals u niet de hoogste laag hebt.
  • Als uw gebruik de hoogste prijscategorie overschrijdt, voegt u meer resources Language Understanding een load balancer er voor staat. De Language Understanding container met Kubernetes of Docker Compose kan daarbij helpen.
  • U kunt aanvragen van uw clienttoepassing gateen met een beleid voor opnieuw proberen dat u zelf implementeert wanneer u deze statuscode krijgt.

Mijn eindpuntquery heeft onverwachte resultaten geretourneerd. Wat moet ik doen?

Onverwachte queryvoorspellingsresultaten zijn gebaseerd op de status van het gepubliceerde model. Als u het model wilt corrigeren, moet u het model mogelijk wijzigen, trainen en opnieuw publiceren.

Het corrigeren van het model begint met actief leren.

U kunt niet-deterministische training verwijderen door de API voor toepassingsversie-instellingen bij te werken zodat alle trainingsgegevens worden gebruikt.

Bekijk de best practices voor andere tips.

Waarom voegt LUIS spaties toe aan de query rond of in het midden van woorden?

LUIS tokeniseert de utterance op basis van de cultuur. Zowel de oorspronkelijke waarde als de tokenized waarde zijn beschikbaar voor gegevensextractie.

Hoe kan ik luis-eindpuntsleutel maken en toewijzen?

Maak de eindpuntsleutel voor uw serviceniveau in Azure. Wijs de sleutel toe op de pagina Azure-resources. Er is geen bijbehorende API voor deze actie. Vervolgens moet u de HTTP-aanvraag wijzigen in het eindpunt om de nieuwe eindpuntsleutel te gebruiken.

Hoe kan ik LUIS-scores interpreteren?

Uw systeem moet de hoogst scorende intentie gebruiken, ongeacht de waarde. Een score lager dan 0,5 (minder dan 50%) betekent bijvoorbeeld niet noodzakelijkerwijs dat LUIS een lage betrouwbaarheid heeft. Door meer trainingsgegevens op te geven, kunt u de score van de meest waarschijnlijke intentie verhogen.

Waarom zie ik mijn eindpunt niet in het dashboard van mijn app?

Het totale aantal treffers in het dashboard van uw app wordt periodiek bijgewerkt, maar de metrische gegevens die zijn gekoppeld aan uw LUIS-eindpuntsleutel in de Azure Portal vaker bijgewerkt.

Als u bijgewerkte eindpunttreffers niet ziet in het dashboard, meldt u zich aan bij de Azure Portal, gaat u naar de resource die is gekoppeld aan uw LUIS-eindpuntsleutel en opent u Metrische gegevens om de metrische waarde Totaal aantal aanroepen te selecteren. Als de eindpuntsleutel wordt gebruikt voor meer dan één LUIS-app, toont de metrische waarde in de Azure Portal het cumulatief aantal aanroepen van alle LUIS-apps die deze gebruiken.

Is er een PowerShell-opdracht voor het eindpuntquotum?

Notitie

In dit artikel wordt de Azure Az PowerShell-module gebruikt. Dit is de aanbevolen PowerShell-module voor interactie met Azure. Raadpleeg Azure PowerShell installeren om aan de slag te gaan met de Az PowerShell-module. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

U kunt een PowerShell-opdracht gebruiken om het eindpuntquotum te bekijken:

Get-AzCognitiveServicesAccountUsage -ResourceGroupName <your-resource-group> -Name <your-resource-name>

Mijn LUIS-app werkte gisteren, maar vandaag krijg ik 403-fouten. Ik heb de app niet gewijzigd. Hoe kan ik dit probleem oplossen?

Volg deze instructies om een LUIS-eindpuntsleutel te maken en deze toe te wijzen aan de app. Vervolgens moet u de HTTP-aanvraag van de clienttoepassing wijzigen in het eindpunt om de nieuwe eindpuntsleutel te gebruiken. Als u een nieuwe resource in een andere regio hebt gemaakt, wijzigt u ook de regio van de HTTP-clientaanvraag.

Hoe kan ik luis-eindpunt beveiligen?

Werken binnen LUIS-limieten

Wat is het maximum aantal intenties en entiteiten dat een LUIS-app kan ondersteunen?

Ik wil een LUIS-app bouwen met meer dan het maximum aantal intenties. Wat moet ik doen?

Wat zijn de limieten voor het aantal en de grootte van woordgroepenlijsten?

Zie de naslag voor grenzen voor de maximale lengte van een frasenlijst.

Wat zijn de limieten voor voorbeeld-utterances?

Testen en trainen

Ik zie enkele fouten in het batchtestvenster voor sommige modellen in mijn app. Hoe kan ik dit probleem oplossen?

De fouten geven aan dat er een discrepantie is tussen uw labels en de voorspellingen van uw modellen. U kunt het probleem oplossen door een of beide van de volgende taken uit te voeren:

  • Voeg meer labels toe om LUIS te helpen de intenties te verbeteren.
  • Om LUIS sneller te laten leren, voegt u woordgroepenlijstfuncties toe die domeinspecifieke woordenlijst introduceren.

Zie de zelfstudie Batch-testen.

Wanneer een app wordt geëxporteerd en vervolgens opnieuw wordt geimporteerd in een nieuwe app (met een nieuwe app-id), zijn de LUIS-voorspellingsscores anders. Waarom gebeurt dit?

Sommige utterances gaan naar de verkeerde intentie nadat ik wijzigingen in mijn app heb aangebracht. Het probleem lijkt willekeurig te verdwijnen. Hoe kan ik dit probleem oplossen?

App-publicatie

Wat is de tenant-id in het venster Een sleutel toevoegen aan uw app?

In Azure vertegenwoordigt een tenant de client of organisatie die aan een service is gekoppeld. Zoek uw tenant-id in het Azure Portal in het vak Map-id door Azure Active Directory > Eigenschappen beheren te > selecteren.

Tenant-id in de Azure Portal

Waarom zijn er meer eindpuntsleutels toegewezen aan mijn app dan ik heb toegewezen?

Elke LUIS-app heeft voor het gemak de ontwerp-/startersleutel in de lijst met eindpunten. Deze sleutel staat slechts enkele eindpunttreffers toe, zodat u LUIS kunt uitproberen.

Als uw app bestond voordat LUIS algemeen beschikbaar was, worden LUIS-eindpuntsleutels in uw abonnement automatisch toegewezen. Dit is gedaan om de migratie van de ga naar een eenvoudigere migratie te maken. Nieuwe LUIS-eindpuntsleutels in de Azure Portal worden niet automatisch toegewezen aan LUIS.

Sleutelbeheer

Hoe kan ik welke sleutel ik nodig heb, waar haal ik deze op en wat ik er mee doe?

Zie Eindpuntsleutels voor ontwerp- en queryvoorspelling in LUIS voor meer informatie over de verschillen tussen de ontwerpsleutel en de voorspellingsruntimesleutel.

Ik heb een foutmelding over het overschrijden van het quotum. Hoe kan ik dit probleem oplossen?

Zie FIX HTTP status code 403 and 429 (HTTP-statuscode 403 en 429 herstellen) voor meer informatie.

Ik moet meer eindpuntquery's verwerken. Hoe doe ik dat?

Zie FIX HTTP status code 403 and 429 (HTTP-statuscode 403 en 429 herstellen) voor meer informatie.

Ik heb een ontwerpsleutel gemaakt, maar deze wordt niet weergegeven in de LUIS-portal. Wat is er gebeurd?

Ontwerpsleutels zijn beschikbaar in de LUIS-portal na de migratie naar de ontwerpsleutelervaring.

Appbeheer

Hoe kan ik logboek met uitingen van gebruikers downloaden?

Standaard registreert uw LUIS-app utterances van gebruikers. Als u een logboek met utterances wilt downloaden die gebruikers naar uw LUIS-app verzenden, gaat u naar Mijn apps en selecteert u de app. Selecteer In de contextuele werkbalk Eindpuntlogboeken exporteren. Het logboek is opgemaakt als een bestand met door komma's gescheiden waarden (CSV).

Hoe kan ik de logboekregistratie van utterances uitschakelen?

U kunt de logboekregistratie van gebruikers-utterances uitschakelen door de eindpunt-URL in te stellen die uw clienttoepassing gebruikt om query's uit te voeren log=false op LUIS. Als u logboekregistratie echter uit schakelen, wordt de mogelijkheid van uw LUIS-app uitgeschakeld om utterances voor te stellen of prestaties te verbeteren die zijn gebaseerd op actief leren. Als u in stelt vanwege problemen met de privacy van gegevens, kunt u geen record van deze gebruikers-utterances downloaden van LUIS of deze utterances gebruiken om uw log=false app te verbeteren.

Logboekregistratie is de enige opslag van utterances.

Waarom wil ik niet dat al mijn eindpunt-utterances worden vastgelegd?

Als u uw logboek gebruikt voor voorspellingsanalyse, moet u geen test-utterances vastleggen in uw logboek.

Gegevensbeheer

Kan ik gegevens uit LUIS verwijderen?

  • U kunt altijd voorbeeld-utterances verwijderen die worden gebruikt voor het trainen van LUIS. Als u een voorbeelduiting uit uw LUIS-app verwijdert, wordt deze verwijderd uit de LUIS-webservice en is deze niet beschikbaar voor export.
  • U kunt utterances verwijderen uit de lijst met uitingen van gebruikers die luis voorstelt op de pagina Eindpuntuitingen controleren. Als u utterances uit deze lijst verwijdert, voorkomt u dat ze worden voorgesteld, maar worden ze niet uit logboeken verwijderd.
  • Als u een account verwijdert, worden alle apps verwijderd, samen met hun voorbeeld-utterances en logboeken. De gegevens worden 60 dagen bewaard op de servers voordat ze permanent worden verwijderd.

Hoe beheert Microsoft de gegevens die ik naar LUIS verzend?

In het Vertrouwenscentrum worden onze toezeggingen en uw opties voor gegevensbeheer en -toegang in Azure Services uitgelegd.

Ondersteuning voor taal en vertaling

Ik heb een app in één taal en wil een parallelle app in een andere taal maken. Wat is de eenvoudigste manier om dit te doen?

  1. Exporteert u uw app.
  2. Vertaal de gelabelde utterances in het JSON-bestand van de geëxporteerde app naar de doeltaal.
  3. Mogelijk moet u de namen van de intenties en entiteiten wijzigen of deze laten zoals ze zijn.
  4. Importeer ten slotte de app om een LUIS-app in de doeltaal te hebben.

App-melding

Waarom krijg ik een e-mail met de vraag of ik bijna een quotum heb?

Uw ontwerp-/startersleutel is slechts 1000 eindpuntquery's per maand toegestaan. Maak een LUIS-eindpuntsleutel (gratis of betaald) en gebruik die sleutel bij het maken van eindpuntquery's. Als u eindpuntquery's maakt vanuit een bot of een andere clienttoepassing, moet u daar de LUIS-eindpuntsleutel wijzigen.

Bots

Mijn LUIS-bot werkt niet. Wat moet ik doen?

Het eerste probleem is om te isoleren als het probleem te maken heeft met LUIS of zich buiten de LUIS-middleware voor doet.

Probleem in LUIS oplossen

Geef dezelfde utterance door aan LUIS vanaf het LUIS-eindpunt. Als er een foutmelding wordt weergegeven, lost u het probleem in LUIS op totdat de fout niet meer wordt geretourneerd. Veelvoorkomende fouten zijn onder andere:

  • Out of call volume quota. Quota will be replenished in <time>.- Dit probleem geeft aan dat u moet wijzigen van een ontwerpsleutel in een eindpuntsleutel of dat u servicelagen moet wijzigen.

Probleem in Azure Bot Service

Als u de Azure Bot Service gebruikt en het probleem is dat de test in Webchat retourneert, Sorry, my bot code is having an issue controleert u uw logboeken:

  1. Selecteer in Azure Portal voor uw bot in de sectie Botbeheer de optie Bouwen.
  2. Open de online code-editor.
  3. Selecteer in de blauwe bovenste navigatiebalk de naam van de bot (het tweede item aan de rechterkant).
  4. Selecteer Kudu-console openen in de resulterende vervolgkeuzelijst.
  5. Selecteer LogFiles en selecteer vervolgens Toepassing. Controleer alle logboekbestanden. Als de fout niet wordt weergegeven in de toepassingsmap, controleert u alle logboekbestanden onder LogFiles.
  6. Vergeet niet om uw project opnieuw te bouwen als u een gecompileerde taal zoals C# gebruikt.

Tip

De -console kan ook pakketten installeren.

Los het probleem op tijdens het oplossen van de probleemopsporing op de lokale computer met Bot Framework.

Zie Fouten opsporen in een bot voor meer informatie over lokale foutopsporing van een bot.

LUIS integreren

Waar wordt mijn LUIS-app gemaakt tijdens het abonnementsproces van de Azure-web-app-bot?

Als u een LUIS-sjabloon selecteert en de knop Selecteren selecteert in het sjabloondeelvenster, wordt het deelvenster aan de linkerkant gewijzigd om het sjabloontype op te nemen en wordt u gevraagd in welke regio de LUIS-sjabloon moet worden gemaakt. Het web-app-botproces maakt echter geen LUIS-abonnement.

Regio van luis-sjabloonweb-app-bot

Welke LUIS-regio's Bot Framework spraakpriming?

Spraakpriming wordt alleen ondersteund voor LUIS-apps in het centrale exemplaar (VS).

API-programmeerstrategieën

Hoe kan ik programmatisch de LUIS-regio van een resource op te halen?

Gebruik het LUIS-voorbeeld om regio's programmatisch te vinden met C# of Node.Js.

LUIS-service

Is Language Understanding (LUIS) on-premises of in de privécloud beschikbaar?

Ja, u kunt de LUIS-container voor deze scenario's gebruiken als u over de benodigde connectiviteit voor metergebruik hebt.

Migreren naar de volgende versie

Hoe kan ik migreren naar preview-versie van de V3-API?