Schnellstart: Erstellen einer Cognitive Services-Ressource mithilfe des Azure-Portals

Verwenden Sie diesen Schnellstart, um eine Cognitive Services-Ressource zu erstellen. Nachdem Sie im Azure-Portal eine Cognitive Service-Ressource erstellt haben, erhalten Sie einen Endpunkt und einen Schlüssel zum Authentifizieren Ihrer Anwendungen.

Azure Cognitive Services sind cloudbasierte KI-Dienste (Künstliche Intelligenz), die Entwickler dabei unterstützen, kognitive Intelligenz in Anwendungen zu integrieren, ohne über direkte KI- oder Data Science-Fertigkeiten oder -Kenntnisse zu verfügen. Sie sind in beliebten Entwicklungssprachen über REST-APIs und Clientbibliotheks-SDKs verfügbar. Mit Azure Cognitive Services können Entwickler ganz einfach kognitive Features in ihre Anwendungen integrieren – mit kognitiven Lösungen, die sehen, hören, sprechen und analysieren können.

Typen von Cognitive Services-Ressourcen

Sie können über zwei unterschiedliche Ressourcen auf Azure Cognitive Services zugreifen: Eine Ressource für mehrere Dienste oder eine Ressource für nur einen Dienst.

  • Ressource für mehrere Dienste:
    • Greifen Sie mit einem einzigen Schlüssel und Endpunkt auf mehrere Azure Cognitive Services zu.
    • Konsolidiert die Abrechnung der von Ihnen verwendeten Dienste.
  • Ressource für einen einzelnen Dienst:
    • Greifen Sie mit einem für den jeweiligen Dienst erstellten eindeutigen Schlüssel und Endpunkt auf einen einzelnen Dienst der Azure Cognitive Services zu.
    • Verwenden Sie den Free-Tarif, um den Dienst zu testen.

Voraussetzungen

  • Ein gültiges Azure-Abonnement: Erstellen Sie ein kostenloses Abonnement.
  • Damit Sie den entsprechenden KI-Bedingungen zustimmen und eine Ressource erstellen können, muss Ihrem Azure-Konto die Rolle „Cognitive Services-Mitwirkender“ zugewiesen sein. Um diese Rolle Ihrem Konto zuzuweisen, führen Sie die Schritte in der Dokumentation Zuweisen von Rollen aus, oder wenden Sie sich an Ihren Administrator.

Erstellen einer neuen Azure Cognitive Services-Ressource

Die Ressource für mehrere Dienste wird im Portal Cognitive Services benannt. Die Ressource für mehrere Dienste ermöglicht den Zugriff auf die folgenden Cognitive Services:

  • Entscheidungsfindung: Content Moderator
  • Sprache - Sprache, Übersetzer
  • Speech: Speech
  • Vision – maschinelles Sehen, Custom Vision, Gesichtserkennung
  1. Sie können diesen Link benutzen, um eine Azure Cognitive-Ressource mit mehreren Diensten zu erstellen: Erstellen einer Cognitive Services-Ressource.

  2. Geben Sie auf der Seite Erstellen die folgenden Informationen ein:

    Projektdetails Beschreibung
    Abonnement Wählen Sie eines Ihrer verfügbaren Azure-Abonnements aus.
    Ressourcengruppe Die Azure-Ressourcengruppe, die Ihre Cognitive Services-Ressource enthält. Sie können eine neue Gruppe erstellen oder sie einer bereits bestehenden Gruppe hinzufügen.
    Region Der Speicherort Ihrer Cognitive Services-Instanz. Verschiedene Speicherorte können Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource.
    Name Ein beschreibender Name für Ihre Cognitive Services-Ressource. Beispiel: MyCognitiveServicesResource.
    Preisstufe Die Kosten für Ihr Cognitive Services-Konto hängen von den ausgewählten Optionen und Ihrer Nutzung ab. Weitere Informationen finden Sie unter API-Preise.

    Bildschirm „Ressourcenerstellung“ für mehrere Dienste

  3. Konfigurieren Sie nach Bedarf weitere Einstellungen für Ihre Ressource, lesen und akzeptieren Sie die Bedingungen (falls zutreffend), und klicken Sie dann auf Überprüfen + erstellen.

Tipp

Wenn Ihr Abonnement die Erstellung einer Cognitive Service-Ressource nicht zulässt, müssen Sie möglicherweise diese Berechtigung des betreffenden Azure-Ressourcenanbieters mithilfe des Azure-Portals, eines PowerShell-Befehls oder eines Azure CLI-Befehls aktivieren. Wenn Sie nicht der Abonnementbesitzer sind, fordern Sie den Abonnementbesitzer oder jemanden mit der Rolle des Administrators auf, die Registrierung für Sie abzuschließen, oder bitten Sie um die Erteilung von /register/action-Berechtigungen für Ihr Konto.

Abrufen der Schlüssel für die Ressource

  1. Nachdem Ihre Ressource erfolgreich bereitgestellt wurde, klicken Sie auf Nächste Schritte>Zu Ressource wechseln.

    Bildschirm zum Abrufen von Ressourcenschlüsseln

  2. Aus dem Schnellstartbereich, der geöffnet wird, können Sie auf den Ressourcenendpunkt zugreifen und Schlüssel verwalten.

Konfigurieren einer Umgebungsvariablen für die Authentifizierung

Ihre Anwendung muss authentifiziert werden, um auf die Cognitive Services-Ressourcen zugreifen zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. Wenn Sie beispielsweise über einen Schlüssel für Ihre Ressource verfügen, schreiben Sie ihn in eine neue Umgebungsvariable auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Tipp

Fügen Sie den Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Im Artikel zur Cognitive Services-Sicherheit finden Sie weitere Authentifizierungsoptionen wie zum Beispiel Azure Key Vault.

Um die Umgebungsvariable für Ihren Ressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster, und befolgen Sie die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung. Zum Festlegen der Umgebungsvariablen COGNITIVE_SERVICE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.

setx COGNITIVE_SERVICE_KEY your-key

Hinweis

Wenn Sie nur in der aktuell ausgeführten Konsole auf die Umgebungsvariable zugreifen müssen, können Sie die Umgebungsvariable mit set anstelle von setx festlegen.

Nachdem Sie die Umgebungsvariable hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Konsolen oder anderen Programme neu starten, in denen die Umgebungsvariable gelesen werden muss. Wenn Sie beispielsweise Visual Studio als Editor verwenden, müssen Sie Visual Studio neu starten, bevor Sie das Beispiel ausführen.

Befolgen Sie die gleichen Schritte, um die Umgebungsvariable für die Region Ihrer Speech-Ressource festzulegen. Legen Sie COGNITIVE_SERVICE_REGION auf die Region Ihrer Ressource fest. Beispiel: westus.

Bereinigen von Ressourcen

Wenn Sie ein Cognitive Services-Abonnement bereinigen und entfernen möchten, können Sie die Ressource oder die Ressourcengruppe löschen. Wenn Sie die Ressourcengruppe löschen, werden auch alle anderen in der Gruppe enthaltenen Ressourcen gelöscht.

  1. Erweitern Sie im Azure-Portal das Menü auf der linken Seite, um das Menü mit den Diensten zu öffnen, und klicken Sie auf Ressourcengruppen, um die Liste mit Ihren Ressourcengruppen anzuzeigen.
  2. Suchen Sie die Ressourcengruppe, die die zu löschende Ressource enthält.
  3. Wenn Sie die gesamte Ressourcengruppe löschen möchten, wählen Sie den Namen der Ressourcengruppe aus. Klicken Sie auf der nächsten Seite auf Ressourcengruppe löschen, und bestätigen Sie den Vorgang.
  4. Wenn Sie nur die Cognitive Service-Ressource löschen möchten, wählen Sie die Ressourcengruppe aus, um alle darin enthaltenen Ressourcen anzuzeigen. Wählen Sie auf der nächsten Seite die Ressource aus, die Sie löschen möchten, wählen Sie das Menü mit den Auslassungszeichen für diese Zeile, und wählen Sie dann Löschen aus.

Wenn Sie eine gelöschte Ressource wiederherstellen müssen, finden Sie weitere Informationen unter Wiederherstellen gelöschter Cognitive Services-Ressourcen.

Siehe auch