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

Verwenden Sie diese Schnellstartanleitung, um mit der Verwendung von Azure Cognitive Services zu beginnen. 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 Dienste mit REST-APIs und Clientbibliothek-SDKs, die Entwickler bei der Erstellung intelligenter Anwendungen unterstützen, ohne dass direkte KI- oder Data Science-Fähigkeiten oder -Kenntnisse erforderlich sind. Mit Cognitive Services können Entwickler ganz einfach kognitive Features in ihre Anwendungen integrieren – mit kognitiven Lösungen, die sehen, hören, sprechen, verstehen und sogar schlussfolgern können.

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. Kontaktieren Sie Ihren Administrator, der Ihrem Konto diese Rolle zuweisen kann.

Erstellen einer neuen Azure Cognitive Services-Ressource

  1. Dient zum Erstellen einer Ressource.

Die Ressource für mehrere Dienste wird im Portal Cognitive Services benannt. Erstellen Sie eine Cognitive Services-Ressource.

Zu diesem Zeitpunkt ermöglicht die Ressource für mehrere Dienste den Zugriff auf die folgenden Cognitive Services:

  • Vision: Maschinelles Sehen, Custom Vision, Formularerkennung, Gesichtserkennung
  • Speech: Speech
  • Sprache: Language Understanding (LUIS), Textanalyse, Textübersetzung
  • Entscheidungsfindung: Content Moderator
  1. 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

Lesen und akzeptieren Sie die Bedingungen (nach Ihren Anforderungen), und wählen Sie dann Überprüfen und erstellen aus.

Tipp

Wenn Ihr Abonnement die Erstellung einer Cognitive Service-Ressource nicht zulässt, müssen Sie möglicherweise diese Fähigkeit des Azure-Ressourcenanbieters mit dem Azure-Portal, PowerShell-Befehl oder einem Azure CLI-Befehl 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 fragen Sie nach den „/register/action“-Berechtigungen, die Ihrem Konto erteilt wurden.

Abrufen der Schlüssel für die Ressource

  1. Klicken Sie nach erfolgreicher Ressourcenbereitstellung unter Nächste Schritte auf Zu Ressource wechseln.

    Suchen nach Cognitive Services

  2. Von dem Schnellstartbereich, der geöffnet wird, können Sie auf Ihren Schlüssel und Endpunkt zugreifen.

    Schlüssel und Endpunkt abrufen

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.

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. Klicken Sie mit der rechten Maustaste auf die Ressourcengruppenauflistung. Klicken Sie auf Ressourcengruppe löschen, und bestätigen Sie den Vorgang.

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

Siehe auch