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

Für Anwendungen muss der Zugriff auf die von ihnen genutzten Cognitive Services authentifiziert werden. Für die Authentifizierung empfehlen wir die Erstellung einer Umgebungsvariable zum Speichern der Schlüssel in Ihren Azure-Ressourcen. Weitere Informationen zu Authentifizierungsoptionen finden Sie unter Authentifizieren von Anforderungen an Cognitive Services.

Wenn Sie Ihren Schlüssel vorliegen haben, können Sie ihn in eine neue Umgebungsvariable auf dem lokalen Computer schreiben, auf dem die Anwendung ausgeführt wird. Öffnen Sie zum Festlegen der Umgebungsvariablen ein Konsolenfenster, und befolgen Sie die Anleitung für Ihr Betriebssystem. Ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.

setx COGNITIVE_SERVICE_KEY "your-key"

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

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