Erstellen und Verwalten von LUIS-Ressourcen

Wichtig

LUIS wird am 1. Oktober 2025 eingestellt, und ab dem 1. April 2023 können Sie keine neuen LUIS-Ressourcen erstellen. Es wird die Migration Ihrer LUIS-Anwendungen zu Conversational Language Understanding empfohlen, um fortgesetzte Produktunterstützung und mehrsprachige Funktionen zu erhalten.

In diesem Artikel erfahren Sie mehr über die Typen von Azure-Ressourcen, die Sie mit LUIS verwenden können, und wie Sie sie verwalten.

Erstellungsressource

Mit einer Erstellungsressource können Sie Ihre Anwendungen erstellen, verwalten, trainieren, testen und veröffentlichen. Für die LUIS-Erstellungsressource ist ein Tarif verfügbar, der Tarif „Free“ (F0), der Folgendes bietet:

• 1 Million Erstellungstransaktionen
• 1\.000 Testanforderungen für den Vorhersageendpunkt pro Monat.

Sie können die programmgesteuerten LUIS-APIs (v3.0-preview) verwenden, um Erstellungsressourcen zu verwalten.

Vorhersageressource

Mit einer Vorhersageressource können Sie Ihren Vorhersageendpunkt über die von der Erstellungsressource bereitgestellten 1.000 Anforderungen hinaus abfragen. Für die Vorhersageressource sind zwei Tarife verfügbar:

• Die Vorhersageressource „Free“ (F0), die Ihnen monatlich 10.000 Anforderungen für den Vorhersageendpunkt bietet.
• Die Vorhersageressource „Standard“ (S0), die der kostenpflichtige Tarif ist.

Sie können die LUIS-Endpunkt-API (v3.0-preview) verwenden, um Vorhersageressourcen zu verwalten.

Hinweis

• Sie können auch eine Ressource mit mehreren Diensten verwenden, um einen einzelnen Endpunkt abzurufen, den Sie für mehrere Azure KI Services-Instanzen verwenden können.
• LUIS bietet zwei Arten von F0-Ressourcen (kostenloser Tarif): eine für Erstellungstransaktionen und eine für Vorhersagetransaktionen. Wenn das Kontingent kostenloser Vorhersagetransaktionen erschöpft ist, stellen Sie sicher, dass Sie die F0-Vorhersageressource verwenden, die Ihnen monatlich 10.000 kostenlose Transaktionen bietet, und nicht die Erstellungsressource, die Ihnen monatlich 1.000 Vorhersagetransaktionen bietet.
• Sie sollten LUIS-Apps in den Regionen erstellen, in denen sie veröffentlicht und abgefragt werden sollen.

Erstellen von LUIS-Ressourcen

Zum Erstellen von LUIS-Ressourcen können Sie das LUIS-Portal, das Azure-Portal oder die Azure CLI verwenden. Nachdem Sie Ihre Ressourcen erstellt haben, müssen Sie sie Ihren Apps zuweisen, damit sie von diesen verwendet werden können.

LUIS-Portal

Erstellen einer LUIS-Erstellungsressource über das LUIS-Portal

1. Melden Sie sich beim LUIS-Portal an, wählen Sie Ihr Land bzw. Ihre Region aus, und stimmen Sie den Nutzungsbedingungen zu. Wenn der Abschnitt Meine Apps im Portal angezeigt wird, ist bereits eine LUIS-Ressource vorhanden, und Sie können den nächsten Schritt überspringen.

2. Suchen Sie im angezeigten Fenster zum Auswählen einer Erstellungsressource nach Ihrem Azure-Abonnement und der LUIS-Erstellungsressource. Wenn keine Ressource vorhanden ist, können Sie eine neue erstellen.

   

   Geben Sie beim Erstellen einer neuen Erstellungsressource die folgenden Informationen an:

   • Mandantenname: Der Mandant, dem Ihr Azure-Abonnement zugeordnet ist.
   • Azure-Abonnementname: Das Abonnement, unter dem die Ressource abgerechnet wird.
   • Name der Azure-Ressourcengruppe: Ein benutzerdefinierter Ressourcengruppenname, den Sie auswählen oder erstellen. Mit Ressourcengruppen können Sie Azure-Ressourcen für den Zugriff und die Verwaltung gruppieren.
   • Azure-Ressourcenname: Ein von Ihnen gewählter benutzerdefinierter Name, der als Teil der URL für Ihre Abfragen für Erstellungs- und Vorhersageendpunkte verwendet wird.
   • Tarif: Der Tarif bestimmt die maximale Anzahl von Transaktionen pro Sekunde und Monat.

Erstellen einer LUIS-Vorhersageressource über das LUIS-Portal

1. Navigieren Sie in Ihrer Anwendung zur Registerkarte Verwalten.

2. Wählen Sie im linken Navigationsbereich die Option Azure-Ressourcen aus.

3. Wählen Sie die Schaltfläche Vorhersageressource hinzufügen aus.

   

   Wenn Sie bereits über eine Vorhersageressource verfügen, fügen Sie sie hinzu. Wählen Sie andernfalls Neue Vorhersageressource erstellen aus.

   

Ohne LUIS-Portal

Erstellen von LUIS-Ressourcen ohne Verwendung des LUIS-Portals

Verwenden Sie die Azure CLI, um die einzelnen Ressourcen individuell zu erstellen.

Tipp

• Die Erstellungsressource kind ist LUIS.Authoring.
• Die Vorhersageressource kind ist LUIS.

1. Melden Sie sich bei der Azure CLI an:

   az login
   

   Dieser Befehl öffnet einen Browser, in dem Sie das richtige Konto auswählen und die Authentifizierung bereitstellen können.

2. Erstellen Sie eine LUIS-Erstellungsressource der Art LUIS.Authoring namens my-luis-authoring-resource. Erstellen Sie sie in der vorhandenen Ressourcengruppe namens my-resource-group für die Region westus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Erstellen Sie eine LUIS-Vorhersageendpunkt-Ressource der Art LUIS namens my-luis-prediction-resource. Erstellen Sie sie in der vorhandenen Ressourcengruppe namens my-resource-group für die Region westus. Wenn Sie einen höheren Durchsatz als für den Free-Tarif wünschen, ändern Sie F0 in S0. Weitere Informationen zu Tarifen und Durchsatz.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

Zuweisen von LUIS-Ressourcen

Das Erstellen einer Ressource bedeutet nicht unbedingt, dass sie auch verwendet wird. Sie müssen sie Ihren Apps zuweisen. Sie können eine Erstellungsressource für eine einzelne App oder für alle Apps in LUIS zuweisen.

LUIS-Portal

Zuweisen von Ressourcen über das LUIS-Portal

Zuweisen einer Erstellungsressource zu allen Ihren Apps

In der folgenden Vorgehensweise wird die Erstellungsressource allen Apps zugewiesen.

1. Melden Sie sich beim LUIS-Portal an.
2. Wählen Sie oben rechts Ihr Benutzerkonto und dann in der Liste Einstellungen aus.
3. Wählen Sie auf der Seite Benutzereinstellungen die Option Erstellungsressource hinzufügen aus, und wählen Sie dann eine vorhandene Erstellungsressource aus. Wählen Sie Speichern aus.

Zuweisen einer Ressource zu einer bestimmten App

In der folgenden Vorgehensweise wird einer bestimmten App eine Ressource zugewiesen.

1. Melden Sie sich beim LUIS-Portal an. Wählen Sie in der Liste Meine Apps eine App aus.

2. Wechseln Sie zu Verwalten>Azure-Ressourcen:

   

3. Wählen Sie auf der Registerkarte Vorhersageressource oder Erstellungsressource die Schaltfläche Vorhersageressource hinzufügen oder Erstellungsressource hinzufügen aus.

4. Verwenden Sie die Felder im Formular, um die richtige Ressource zu finden, und wählen Sie dann Speichern aus.

Ohne LUIS-Portal

Zuweisen einer Vorhersageressource ohne Verwendung des LUIS-Portals

Für automatisierte Prozesse wie CI/CD-Pipelines können Sie die Zuweisung einer LUIS-Ressource zu einer LUIS-App mit den folgenden Schritten automatisieren:

1. Rufen Sie ein Azure Resource Manager-Token ab, bei dem es sich um eine alphanumerische Zeichenfolge handelt. Dieses Token läuft ab, daher sollten Sie es sofort verwenden. Sie können auch den folgenden Azure CLI-Befehl verwenden:

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Verwenden Sie das Token, um die LUIS-Runtimeressourcen abonnementübergreifend anzufordern. Verwenden Sie die API, um das LUIS-Azure-Konto abzurufen, auf das Ihr Benutzerkonto Zugriff hat.

   Diese POST-API erfordert folgende Werte:

   Header	Wert
   Authorization	Der Wert von Authorization ist Bearer {token}. Dem Tokenwert müssen das Wort Bearer und ein Leerzeichen vorangestellt werden.
   Ocp-Apim-Subscription-Key	Ihr Erstellungsschlüssel.

   Die API gibt ein Array von JSON-Objekten zurück, die Ihre LUIS-Abonnements darstellen. Die zurückgegebenen Werte umfassen die Abonnement-ID, die Ressourcengruppe und den Ressourcennamen, der als AccountName zurückgegeben wurde. Finden Sie im Array das Element, das die LUIS-Ressource darstellt, die Sie der LUIS-App zuweisen möchten.

3. Weisen Sie das Token mit der API zum Zuweisen eines LUIS-Azure-Kontos zu einer Anwendung der LUIS-Ressource zu.

   Diese POST-API erfordert folgende Werte:

   type	Einstellung	Wert
   Header	Authorization	Der Wert von Authorization ist Bearer {token}. Dem Tokenwert müssen das Wort Bearer und ein Leerzeichen vorangestellt werden.
   Header	Ocp-Apim-Subscription-Key	Ihr Erstellungsschlüssel.
   Header	Content-type	application/json
   Abfragezeichenfolge	appid	die LUIS-App-ID
   Body		{AzureSubscriptionId: Ihre Abonnement-ID, ResourceGroup: Ressourcengruppenname mit Ihrer Vorhersageressource, AccountName: Name Ihrer Vorhersageressource}

   Wenn diese API erfolgreich ist, gibt sie 201 - created status zurück.

Aufheben der Zuweisung einer Ressource

Wenn Sie die Zuweisung einer Ressource aufheben, wird diese nicht aus Azure gelöscht. Lediglich die Verknüpfung mit LUIS wird aufgehoben.

LUIS-Portal

Aufheben der Zuweisung von Ressourcen über das LUIS-Portal

1. Melden Sie sich beim LUIS-Portal an, und wählen Sie dann in der Liste Meine Apps eine App aus.
2. Wechseln Sie zu Verwalten>Azure-Ressourcen.
3. Wählen Sie die Schaltfläche Ressourcenzuweisung aufheben für die Ressource aus.

Ohne LUIS-Portal

Aufheben der Zuweisung einer Vorhersageressource ohne Verwendung des LUIS-Portals

1. Rufen Sie ein Azure Resource Manager-Token ab, bei dem es sich um eine alphanumerische Zeichenfolge handelt. Dieses Token läuft ab, daher sollten Sie es sofort verwenden. Sie können auch den folgenden Azure CLI-Befehl verwenden:

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Verwenden Sie das Token, um die LUIS-Runtimeressourcen abonnementübergreifend anzufordern. Verwenden Sie die API zum Abrufen von LUIS-Azure-Konten, auf die Ihr Benutzerkonto Zugriff hat.

   Diese POST-API erfordert folgende Werte:

   Header	Wert
   Authorization	Der Wert von Authorization ist Bearer {token}. Dem Tokenwert müssen das Wort Bearer und ein Leerzeichen vorangestellt werden.
   Ocp-Apim-Subscription-Key	Ihr Erstellungsschlüssel.

   Die API gibt ein Array von JSON-Objekten zurück, die Ihre LUIS-Abonnements darstellen. Die zurückgegebenen Werte umfassen die Abonnement-ID, die Ressourcengruppe und den Ressourcennamen, der als AccountName zurückgegeben wurde. Finden Sie im Array das Element, das die LUIS-Ressource darstellt, die Sie der LUIS-App zuweisen möchten.

3. Weisen Sie das Token mit der API zum Aufheben der Zuweisung eines LUIS-Azure-Kontos zu einer Anwendung der LUIS-Ressource zu.

   Diese DELETE-API erfordert folgende Werte:

   type	Einstellung	Wert
   Header	Authorization	Der Wert von Authorization ist Bearer {token}. Dem Tokenwert müssen das Wort Bearer und ein Leerzeichen vorangestellt werden.
   Header	Ocp-Apim-Subscription-Key	Ihr Erstellungsschlüssel.
   Header	Content-type	application/json
   Abfragezeichenfolge	appid	die LUIS-App-ID
   Body		{AzureSubscriptionId: Ihre Abonnement-ID, ResourceGroup: Ressourcengruppenname mit Ihrer Vorhersageressource, AccountName: Name Ihrer Vorhersageressource}

   Wenn diese API erfolgreich ist, gibt sie 200 - OK status zurück.

Ressourcenbesitz

Eine Azure-Ressource gehört (wie eine LUIS-Ressource) zu dem Abonnement, das die Ressource enthält.

Um den Besitzer einer Ressource zu ändern, können Sie eine der folgenden Aktionen durchführen:

• Übertragen Sie das Eigentum Ihres Abonnements.
• Exportieren Sie die LUIS-App als Datei, und importieren Sie die App anschließend in einem anderen Abonnement. Die Exportfunktion finden Sie im LUIS-Portal auf der Seite Meine Apps.

Ressourceneinschränkungen

Grenzwerte für die Erstellung von Erstellungsschlüsseln

Sie können bis zu 10 Erstellungsschlüssel pro Region und Abonnement erstellen. Veröffentlichungsregionen unterscheiden sich von Erstellungsregionen. Stellen Sie sicher, dass Sie eine App in der Erstellungsregion erstellen, die der Veröffentlichungsregion entspricht, in der sich Ihre Clientanwendung befinden soll. Weitere Informationen wie Erstellungsregionen Veröffentlichungsregionen zugeordnet werden können, finden Sie unter Erstellungs- und Veröffentlichungsregionen und die dazugehörigen Schlüssel.

Weitere Informationen finden Sie unter Ressourcenlimits.

Fehler für Grenzwerte bei der Schlüsselnutzung

Nutzungslimits sind tarifabhängig.

Wenn Sie Ihr TPS-Kontingent (Transaktionen pro Sekunde) überschreiten, erhalten Sie den HTTP-Fehler 429. Wenn Sie Ihr TPM-Kontingent (Transaktionen pro Monat) überschreiten, erhalten Sie den HTTP-Fehler 403.

Ändern des Tarifs

1. Wechseln Sie im Azure-Portal zu Alle Ressourcen, und wählen Sie Ihre Ressource aus.

   

2. Wählen Sie im Menü auf der linken Seite Tarif aus, um die verfügbaren Tarife anzuzeigen.

3. Wählen Sie den gewünschten Tarif aus, und klicken Sie dann auf Auswählen, um Ihre Änderung zu speichern. Wenn die Preisänderung abgeschlossen ist, wird oben rechts eine Benachrichtigung mit dem Tarifupdate angezeigt.

Anzeigen von Azure-Ressourcenmetriken

Anzeigen einer Zusammenfassung der Azure-Ressourcennutzung

Sie können LUIS-Nutzungsinformationen im Azure-Portal anzeigen. Die Seite Übersicht zeigt eine Zusammenfassung, einschließlich der letzten Aufrufe und Fehler. Wenn Sie eine LUIS-Endpunktanforderung stellen, kann es bis zu fünf Minuten dauern, bis die Änderung angezeigt wird.

Anpassen von Nutzungsdiagrammen für Azure-Ressourcen

Die Seite Metriken bietet eine detailliertere Ansicht der Daten. Sie können Ihre Metrikdiagramme für einen bestimmten Zeitraum und eine bestimmte Metrik konfigurieren.

Warnung für Gesamttransaktions-Schwellenwert

Wenn Sie wissen möchten, wann Sie einen bestimmten Transaktionsschwellenwert erreichen, z. B. 10.000 Transaktionen, können Sie eine Warnung erstellen:

1. Wählen Sie auf der linken Seite im Menü Warnungen aus.

2. Wählen Sie im oberen Menü die Option Neue Warnungsregel aus.

   

3. Wählen Sie Bedingung hinzufügen aus.

   

4. Wählen Sie Aufrufe gesamt aus.

   

5. Scrollen Sie nach unten zum Abschnitt Warnungslogik, legen Sie die Attribute wie gewünscht fest, und klicken Sie auf Fertig.

   

6. Um Benachrichtigungen zu senden oder Aktionen aufzurufen, wenn die Warnungsregel ausgelöst wird, wechseln Sie zum Abschnitt Aktionen, und fügen Sie Ihre Aktionsgruppe hinzu.

   

Zurücksetzen des Erstellungsschlüssels

Apps, die zur Erstellungsressource migriert wurden: Wurde Ihr Erstellungsschlüssel kompromittiert, setzen Sie den Schlüssel für diese Erstellungsressource im Azure-Portal auf der Seite Schlüssel zurück.

Für Apps, die nicht migriert wurden: Der Schlüssel wird für all Ihre Apps im LUIS-Portal zurückgesetzt. Wenn Sie Ihre Apps mithilfe der Authoring-APIs verfassen, müssen Sie den Wert von Ocp-Apim-Subscription-Key auf den neuen Schlüssel ändern.

Erneutes Generieren eines Azure-Schlüssels

Sie können einen Azure-Schlüssel über die Seite Schlüssel im Azure-Portal neu generieren.

App-Besitz, -Zugriff und -Sicherheit

Eine App ist durch ihre Azure-Ressourcen definiert, die durch das Abonnement des Besitzers bestimmt sind.

Sie können Ihre LUIS-App verschieben. Verwenden Sie die folgenden Azure-Ressourcen, damit diese Ihnen über das Azure-Portal oder die Azure CLI dabei helfen können:

• Verschieben einer Ressource in eine neue Ressourcengruppe oder in ein Abonnement
• Verschieben einer Ressource innerhalb desselben Abonnements oder zwischen Abonnements

Nächste Schritte

• Erfahren Sie, wie Sie Versionen verwenden, um den Lebenszyklus ihrer App zu steuern.