Freigeben über


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.

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.

    Typ der Language Understanding-Erstellungsressource auswählen

    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.

    Hinzufügen einer Vorhersageressource über das Portal

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

    Hinzufügen einer Vorhersageressource über das Portal 2

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.

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:

    Typ der Language Understanding-Vorhersageressource auswählen

  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.

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.

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.

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.

    Der Screenshot zeigt ein LUIS-Abonnement im Azure-Portal.

  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.

Screenshot: Übersichtsseite

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.

Screenshot: Seite „Metriken“

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.

    Screenshot: Seite „Warnungsregeln“

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

    Screenshot: Seite „Bedingung hinzufügen“ für Warnungsregeln

  4. Wählen Sie Aufrufe gesamt aus.

    Screenshot: Seite „Aufrufe gesamt“ für Warnungen

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

    Screenshot: Seite „Warnungslogik“

  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.

    Screenshot: Aktionsseite für Warnungen

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:

Nächste Schritte