Schnellstart: Verwenden der Clientbibliothek und REST-API für die Schlüsselbegriffserkennung

Referenzdokumentation | Weitere Beispiele | Paket (NuGet) | Quellcode der Bibliothek

Verwenden Sie diese Schnellstartanleitung, um eine Anwendung zur Schlüsselbegriffserkennung mit der Clientbibliothek für .NET zu erstellen. Im folgenden Beispiel erstellen Sie eine C#-Anwendung, die Schlüsselwörter und -begriffe erkennen kann, die in Text gefunden werden.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Visual Studio-IDE

Einrichten

Erstellen einer Azure-Ressource

Um das nachstehende Codebeispiel zu verwenden, müssen Sie eine Azure-Ressource bereitstellen. Diese Ressource enthält einen Schlüssel und Endpunkt, mit dem Sie die API-Aufrufe authentifizieren, die Sie an den Sprachdienst senden.

1. Verwenden Sie den folgenden Link, um über das Azure-Portal eine Sprachressource zu erstellen. Sie müssen sich mit Ihrem Azure-Abonnement anmelden.

2. Wählen Sie auf dem angezeigten Bildschirm Zusätzliche Funktionen auswählen die Option Fahren Sie fort mit dem Erstellen Ihrer Ressource aus.

   

3. Geben Sie auf dem Bildschirm Sprache erstellen die folgenden Informationen an:

   Detail	Beschreibung
   Subscription	Das Abonnementkonto, mit dem Ihre Ressource verknüpft wird. Wählen Sie im Dropdownmenü Ihr Azure-Abonnement aus.
   Ressourcengruppe	Eine Ressourcengruppe ist ein Container, der die von Ihnen erstellten Ressourcen speichert. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen.
   Region	Der Standort Ihrer Sprachressource Verschiedene Regionen können je nach physischem Standort Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource. Wählen Sie für diesen Schnellstart entweder eine verfügbare Region in Ihrer Nähe oder USA, Osten aus.
   Name	Der Name für Ihre Sprachressource. Dieser Name wird auch zum Erstellen einer Endpunkt-URL verwendet, die Ihre Anwendungen zum Senden von API-Anforderungen verwenden.
   Tarif	Der Tarif für Ihre Sprachressource Sie können den Tarif Free F0 verwenden, um den Dienst zu testen, und später für die Produktion auf einen kostenpflichtigen Tarif upgraden.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen Hinweis zu verantwortungsvoller KI aktiviert ist.

5. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

6. Stellen Sie auf dem angezeigten Bildschirm sicher, dass die Überprüfung erfolgreich war und dass Sie Ihre Informationen ordnungsgemäß eingegeben haben. Klicken Sie anschließend auf Erstellen.

Abrufen Ihres Schlüssels und Endpunkts

Als Nächstes benötigen Sie den Schlüssel und Endpunkt der Ressource, um Ihre Anwendung mit der API zu verbinden. Der Schlüssel und der Endpunkt werden später in der Schnellstartanleitung in den Code eingefügt.

1. Klicken Sie nach erfolgreicher Bereitstellung der Sprachressource unter Nächste Schritte auf die Schaltfläche Zu Ressource wechseln.

   

2. Wählen Sie auf dem Bildschirm für Ihre Ressource im linken Navigationsmenü die Option Schlüssel und Endpunkt aus. Sie verwenden einen Ihrer Schlüssel und Ihren Endpunkt in den folgenden Schritten.

   

Erstellen von Umgebungsvariablen

Ihre Anwendung muss authentifiziert werden, um API-Anforderungen senden zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. In diesem Beispiel schreiben Sie Ihre Anmeldeinformationen in Umgebungsvariablen auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Um die Umgebungsvariable für Ihren Sprachressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster und befolgen die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung.

• Zum Festlegen der Umgebungsvariablen LANGUAGE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.
• Zum Festlegen der Umgebungsvariablen LANGUAGE_ENDPOINT ersetzen Sie your-endpoint durch den Endpunkt für Ihre Ressource.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

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 Umgebungsvariablen hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, die die Umgebungsvariablen lesen müssen, 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.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bashrc aus, damit die Änderungen wirksam werden.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bash_profile aus, damit die Änderungen wirksam werden.

Xcode

Für die iOS- und macOS-Entwicklung legen Sie die Umgebungsvariablen in Xcode fest. Führen Sie zum Beispiel die folgenden Schritte aus, um die Umgebungsvariable in Xcode 13.4.1 festzulegen.

1. Wählen Sie Produkt>Schema>Schema bearbeiten aus.
2. Wählen Sie auf der Seite Ausführen (Debugausführung) die Option Argumente aus.
3. Klicken Sie unter Umgebungsvariablen auf das Pluszeichen (+), um eine neue Umgebungsvariable hinzuzufügen.
4. Geben Sie als Name den Wert LANGUAGE_KEY und für Wert den Schlüssel Ihrer Sprachressource ein.
5. Führen Sie diese Schritte für Ihren Ressourcenendpunkt aus. Geben Sie der neuen Umgebungsvariablen den Namen LANGUAGE_ENDPOINT.

Weitere Konfigurationsoptionen finden Sie in der Xcode-Dokumentation.

Erstellen einer neuen .NET Core-Anwendung

Erstellen Sie über die Visual Studio-IDE eine neue .NET Core-Konsolenanwendung. Dadurch wird ein Projekt vom Typ „Hallo Welt“ mit einer einzelnen C#-Quelldatei program.cs erstellt.

Installieren Sie die Clientbibliothek, indem Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe klicken und NuGet-Pakete verwalten auswählen. Wählen Sie im daraufhin geöffneten Paket-Manager die Option Durchsuchen aus, und suchen Sie nach Azure.AI.TextAnalytics. Wählen Sie die Version 5.2.0 und anschließend Installieren aus. Sie können auch die Paket-Manager-Konsole verwenden.

Codebeispiel

Kopieren Sie den folgenden Code in die Datei Program.cs. Führen Sie dann den Code aus.

using Azure;
using System;
using Azure.AI.TextAnalytics;

namespace KeyPhraseExtractionExample
{
    class Program
    {
        // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
        static string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
        static string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");

        private static readonly AzureKeyCredential credentials = new AzureKeyCredential(languageKey);
        private static readonly Uri endpoint = new Uri(languageEndpoint);

        // Example method for extracting key phrases from text
        static void KeyPhraseExtractionExample(TextAnalyticsClient client)
        {
            var response = client.ExtractKeyPhrases(@"Dr. Smith has a very modern medical office, and she has great staff.");

            // Printing key phrases
            Console.WriteLine("Key phrases:");

            foreach (string keyphrase in response.Value)
            {
                Console.WriteLine($"\t{keyphrase}");
            }
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(endpoint, credentials);
            KeyPhraseExtractionExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

Output

Key phrases:
    modern medical office
    Dr. Smith
    great staff

Referenzdokumentation | Weitere Beispiele | Paket (Maven) | Quellcode der Bibliothek

Verwenden Sie diese Schnellstartanleitung, um eine Anwendung zur Schlüsselbegriffserkennung mit der Clientbibliothek für Java zu erstellen. Im folgenden Beispiel erstellen Sie eine Java-Anwendung, die Schlüsselwörter und -begriffe erkennen kann, die in Text gefunden werden.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Java Development Kit (JDK), Version 8 oder höher

Einrichten

Erstellen einer Azure-Ressource

Um das nachstehende Codebeispiel zu verwenden, müssen Sie eine Azure-Ressource bereitstellen. Diese Ressource enthält einen Schlüssel und Endpunkt, mit dem Sie die API-Aufrufe authentifizieren, die Sie an den Sprachdienst senden.

1. Verwenden Sie den folgenden Link, um über das Azure-Portal eine Sprachressource zu erstellen. Sie müssen sich mit Ihrem Azure-Abonnement anmelden.

2. Wählen Sie auf dem angezeigten Bildschirm Zusätzliche Funktionen auswählen die Option Fahren Sie fort mit dem Erstellen Ihrer Ressource aus.

   

3. Geben Sie auf dem Bildschirm Sprache erstellen die folgenden Informationen an:

   Detail	Beschreibung
   Subscription	Das Abonnementkonto, mit dem Ihre Ressource verknüpft wird. Wählen Sie im Dropdownmenü Ihr Azure-Abonnement aus.
   Ressourcengruppe	Eine Ressourcengruppe ist ein Container, der die von Ihnen erstellten Ressourcen speichert. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen.
   Region	Der Standort Ihrer Sprachressource Verschiedene Regionen können je nach physischem Standort Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource. Wählen Sie für diesen Schnellstart entweder eine verfügbare Region in Ihrer Nähe oder USA, Osten aus.
   Name	Der Name für Ihre Sprachressource. Dieser Name wird auch zum Erstellen einer Endpunkt-URL verwendet, die Ihre Anwendungen zum Senden von API-Anforderungen verwenden.
   Tarif	Der Tarif für Ihre Sprachressource Sie können den Tarif Free F0 verwenden, um den Dienst zu testen, und später für die Produktion auf einen kostenpflichtigen Tarif upgraden.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen Hinweis zu verantwortungsvoller KI aktiviert ist.

5. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

6. Stellen Sie auf dem angezeigten Bildschirm sicher, dass die Überprüfung erfolgreich war und dass Sie Ihre Informationen ordnungsgemäß eingegeben haben. Klicken Sie anschließend auf Erstellen.

Abrufen Ihres Schlüssels und Endpunkts

Als Nächstes benötigen Sie den Schlüssel und Endpunkt der Ressource, um Ihre Anwendung mit der API zu verbinden. Der Schlüssel und der Endpunkt werden später in der Schnellstartanleitung in den Code eingefügt.

1. Klicken Sie nach erfolgreicher Bereitstellung der Sprachressource unter Nächste Schritte auf die Schaltfläche Zu Ressource wechseln.

   

2. Wählen Sie auf dem Bildschirm für Ihre Ressource im linken Navigationsmenü die Option Schlüssel und Endpunkt aus. Sie verwenden einen Ihrer Schlüssel und Ihren Endpunkt in den folgenden Schritten.

   

Erstellen von Umgebungsvariablen

Ihre Anwendung muss authentifiziert werden, um API-Anforderungen senden zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. In diesem Beispiel schreiben Sie Ihre Anmeldeinformationen in Umgebungsvariablen auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Um die Umgebungsvariable für Ihren Sprachressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster und befolgen die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung.

• Zum Festlegen der Umgebungsvariablen LANGUAGE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.
• Zum Festlegen der Umgebungsvariablen LANGUAGE_ENDPOINT ersetzen Sie your-endpoint durch den Endpunkt für Ihre Ressource.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

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 Umgebungsvariablen hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, die die Umgebungsvariablen lesen müssen, 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.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bashrc aus, damit die Änderungen wirksam werden.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bash_profile aus, damit die Änderungen wirksam werden.

Xcode

Für die iOS- und macOS-Entwicklung legen Sie die Umgebungsvariablen in Xcode fest. Führen Sie zum Beispiel die folgenden Schritte aus, um die Umgebungsvariable in Xcode 13.4.1 festzulegen.

1. Wählen Sie Produkt>Schema>Schema bearbeiten aus.
2. Wählen Sie auf der Seite Ausführen (Debugausführung) die Option Argumente aus.
3. Klicken Sie unter Umgebungsvariablen auf das Pluszeichen (+), um eine neue Umgebungsvariable hinzuzufügen.
4. Geben Sie als Name den Wert LANGUAGE_KEY und für Wert den Schlüssel Ihrer Sprachressource ein.
5. Führen Sie diese Schritte für Ihren Ressourcenendpunkt aus. Geben Sie der neuen Umgebungsvariablen den Namen LANGUAGE_ENDPOINT.

Weitere Konfigurationsoptionen finden Sie in der Xcode-Dokumentation.

Hinzufügen der Clientbibliothek

Erstellen Sie ein Maven-Projekt in Ihrer bevorzugten IDE oder Entwicklungsumgebung. Fügen Sie anschließend der Datei pom.xml Ihres Projekts die folgende Abhängigkeit hinzu. Die Implementierungssyntax für andere Buildtools ist online verfügbar.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

Codebeispiel

Erstellen Sie eine Java-Datei mit dem Namen Example.java. Öffnen Sie die Datei, und kopieren Sie den folgenden Code. Führen Sie dann den Code aus.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;


public class Example {

    // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
    private static String languageKey = System.getenv("LANGUAGE_KEY");
    private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
        extractKeyPhrasesExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }
    // Example method for extracting key phrases from text
    static void extractKeyPhrasesExample(TextAnalyticsClient client)
    {
        // The text to be analyzed
        String text = "Dr. Smith has a very modern medical office, and she has great staff.";

        System.out.printf("Recognized phrases: %n");
        for (String keyPhrase : client.extractKeyPhrases(text)) {
            System.out.printf("%s%n", keyPhrase);
        }
    }
}

Output

Recognized phrases: 

modern medical office
Dr. Smith
great staff

Referenzdokumentation | Weitere Beispiele | Paket (npm) | Quellcode der Bibliothek

Verwenden Sie diese Schnellstartanleitung, um eine Anwendung zur Schlüsselbegriffserkennung mit der Clientbibliothek für Node.js zu erstellen. Im folgenden Beispiel erstellen Sie eine JavaScript-Anwendung, die Schlüsselwörter und -begriffe erkennen kann, die in Text gefunden werden.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Node.js v14 LTS oder höher

Einrichten

Erstellen einer Azure-Ressource

Um das nachstehende Codebeispiel zu verwenden, müssen Sie eine Azure-Ressource bereitstellen. Diese Ressource enthält einen Schlüssel und Endpunkt, mit dem Sie die API-Aufrufe authentifizieren, die Sie an den Sprachdienst senden.

1. Verwenden Sie den folgenden Link, um über das Azure-Portal eine Sprachressource zu erstellen. Sie müssen sich mit Ihrem Azure-Abonnement anmelden.

2. Wählen Sie auf dem angezeigten Bildschirm Zusätzliche Funktionen auswählen die Option Fahren Sie fort mit dem Erstellen Ihrer Ressource aus.

   

3. Geben Sie auf dem Bildschirm Sprache erstellen die folgenden Informationen an:

   Detail	Beschreibung
   Subscription	Das Abonnementkonto, mit dem Ihre Ressource verknüpft wird. Wählen Sie im Dropdownmenü Ihr Azure-Abonnement aus.
   Ressourcengruppe	Eine Ressourcengruppe ist ein Container, der die von Ihnen erstellten Ressourcen speichert. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen.
   Region	Der Standort Ihrer Sprachressource Verschiedene Regionen können je nach physischem Standort Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource. Wählen Sie für diesen Schnellstart entweder eine verfügbare Region in Ihrer Nähe oder USA, Osten aus.
   Name	Der Name für Ihre Sprachressource. Dieser Name wird auch zum Erstellen einer Endpunkt-URL verwendet, die Ihre Anwendungen zum Senden von API-Anforderungen verwenden.
   Tarif	Der Tarif für Ihre Sprachressource Sie können den Tarif Free F0 verwenden, um den Dienst zu testen, und später für die Produktion auf einen kostenpflichtigen Tarif upgraden.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen Hinweis zu verantwortungsvoller KI aktiviert ist.

5. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

6. Stellen Sie auf dem angezeigten Bildschirm sicher, dass die Überprüfung erfolgreich war und dass Sie Ihre Informationen ordnungsgemäß eingegeben haben. Klicken Sie anschließend auf Erstellen.

Abrufen Ihres Schlüssels und Endpunkts

Als Nächstes benötigen Sie den Schlüssel und Endpunkt der Ressource, um Ihre Anwendung mit der API zu verbinden. Der Schlüssel und der Endpunkt werden später in der Schnellstartanleitung in den Code eingefügt.

1. Klicken Sie nach erfolgreicher Bereitstellung der Sprachressource unter Nächste Schritte auf die Schaltfläche Zu Ressource wechseln.

   

2. Wählen Sie auf dem Bildschirm für Ihre Ressource im linken Navigationsmenü die Option Schlüssel und Endpunkt aus. Sie verwenden einen Ihrer Schlüssel und Ihren Endpunkt in den folgenden Schritten.

   

Erstellen von Umgebungsvariablen

Ihre Anwendung muss authentifiziert werden, um API-Anforderungen senden zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. In diesem Beispiel schreiben Sie Ihre Anmeldeinformationen in Umgebungsvariablen auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Um die Umgebungsvariable für Ihren Sprachressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster und befolgen die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung.

• Zum Festlegen der Umgebungsvariablen LANGUAGE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.
• Zum Festlegen der Umgebungsvariablen LANGUAGE_ENDPOINT ersetzen Sie your-endpoint durch den Endpunkt für Ihre Ressource.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

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 Umgebungsvariablen hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, die die Umgebungsvariablen lesen müssen, 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.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bashrc aus, damit die Änderungen wirksam werden.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bash_profile aus, damit die Änderungen wirksam werden.

Xcode

Für die iOS- und macOS-Entwicklung legen Sie die Umgebungsvariablen in Xcode fest. Führen Sie zum Beispiel die folgenden Schritte aus, um die Umgebungsvariable in Xcode 13.4.1 festzulegen.

1. Wählen Sie Produkt>Schema>Schema bearbeiten aus.
2. Wählen Sie auf der Seite Ausführen (Debugausführung) die Option Argumente aus.
3. Klicken Sie unter Umgebungsvariablen auf das Pluszeichen (+), um eine neue Umgebungsvariable hinzuzufügen.
4. Geben Sie als Name den Wert LANGUAGE_KEY und für Wert den Schlüssel Ihrer Sprachressource ein.
5. Führen Sie diese Schritte für Ihren Ressourcenendpunkt aus. Geben Sie der neuen Umgebungsvariablen den Namen LANGUAGE_ENDPOINT.

Weitere Konfigurationsoptionen finden Sie in der Xcode-Dokumentation.

Erstellen einer neuen Node.js-Anwendung

Erstellen Sie in einem Konsolenfenster (etwa cmd, PowerShell oder Bash) ein neues Verzeichnis für Ihre App, und rufen Sie es auf.

mkdir myapp 

cd myapp

Führen Sie den Befehl npm init aus, um eine Knotenanwendung mit der Datei package.json zu erstellen.

npm init

Installieren der Clientbibliothek

Installieren des npm-Pakets:

npm install @azure/ai-language-text

Codebeispiel

Öffnen Sie die Datei, und kopieren Sie den folgenden Code. Führen Sie dann den Code aus.

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");

// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;

//example sentence for performing key phrase extraction
const documents = ["Dr. Smith has a very modern medical office, and she has great staff."];

//example of how to use the client to perform entity linking on a document
async function main() {
    console.log("== key phrase extraction sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const results = await client.analyze("KeyPhraseExtraction", documents);
  
    for (const result of results) {
      console.log(`- Document ${result.id}`);
      if (!result.error) {
        console.log("\tKey phrases:");
        for (const phrase of result.keyPhrases) {
          console.log(`\t- ${phrase}`);
        }
      } else {
        console.error("  Error:", result.error);
      }
    }
  }
  
  main().catch((err) => {
    console.error("The sample encountered an error:", err);
  });
  

Output

== key phrase extraction sample ==
- Document 0
    Key phrases:
    - modern medical office
    - Dr. Smith
    - great staff

Referenzdokumentation | Weitere Beispiele | Paket (PyPi) | Quellcode der Bibliothek

Verwenden Sie diese Schnellstartanleitung, um eine Anwendung zur Schlüsselbegriffserkennung mit der Clientbibliothek für Python zu erstellen. Im folgenden Beispiel erstellen Sie eine Python-Anwendung, die Schlüsselwörter und -begriffe erkennen kann, die in Text gefunden werden.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Python 3.8 oder höher

Einrichten

Erstellen einer Azure-Ressource

Um das nachstehende Codebeispiel zu verwenden, müssen Sie eine Azure-Ressource bereitstellen. Diese Ressource enthält einen Schlüssel und Endpunkt, mit dem Sie die API-Aufrufe authentifizieren, die Sie an den Sprachdienst senden.

1. Verwenden Sie den folgenden Link, um über das Azure-Portal eine Sprachressource zu erstellen. Sie müssen sich mit Ihrem Azure-Abonnement anmelden.

2. Wählen Sie auf dem angezeigten Bildschirm Zusätzliche Funktionen auswählen die Option Fahren Sie fort mit dem Erstellen Ihrer Ressource aus.

   

3. Geben Sie auf dem Bildschirm Sprache erstellen die folgenden Informationen an:

   Detail	Beschreibung
   Subscription	Das Abonnementkonto, mit dem Ihre Ressource verknüpft wird. Wählen Sie im Dropdownmenü Ihr Azure-Abonnement aus.
   Ressourcengruppe	Eine Ressourcengruppe ist ein Container, der die von Ihnen erstellten Ressourcen speichert. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen.
   Region	Der Standort Ihrer Sprachressource Verschiedene Regionen können je nach physischem Standort Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource. Wählen Sie für diesen Schnellstart entweder eine verfügbare Region in Ihrer Nähe oder USA, Osten aus.
   Name	Der Name für Ihre Sprachressource. Dieser Name wird auch zum Erstellen einer Endpunkt-URL verwendet, die Ihre Anwendungen zum Senden von API-Anforderungen verwenden.
   Tarif	Der Tarif für Ihre Sprachressource Sie können den Tarif Free F0 verwenden, um den Dienst zu testen, und später für die Produktion auf einen kostenpflichtigen Tarif upgraden.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen Hinweis zu verantwortungsvoller KI aktiviert ist.

5. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

6. Stellen Sie auf dem angezeigten Bildschirm sicher, dass die Überprüfung erfolgreich war und dass Sie Ihre Informationen ordnungsgemäß eingegeben haben. Klicken Sie anschließend auf Erstellen.

Abrufen Ihres Schlüssels und Endpunkts

Als Nächstes benötigen Sie den Schlüssel und Endpunkt der Ressource, um Ihre Anwendung mit der API zu verbinden. Der Schlüssel und der Endpunkt werden später in der Schnellstartanleitung in den Code eingefügt.

1. Klicken Sie nach erfolgreicher Bereitstellung der Sprachressource unter Nächste Schritte auf die Schaltfläche Zu Ressource wechseln.

   

2. Wählen Sie auf dem Bildschirm für Ihre Ressource im linken Navigationsmenü die Option Schlüssel und Endpunkt aus. Sie verwenden einen Ihrer Schlüssel und Ihren Endpunkt in den folgenden Schritten.

   

Erstellen von Umgebungsvariablen

Ihre Anwendung muss authentifiziert werden, um API-Anforderungen senden zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. In diesem Beispiel schreiben Sie Ihre Anmeldeinformationen in Umgebungsvariablen auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Um die Umgebungsvariable für Ihren Sprachressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster und befolgen die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung.

• Zum Festlegen der Umgebungsvariablen LANGUAGE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.
• Zum Festlegen der Umgebungsvariablen LANGUAGE_ENDPOINT ersetzen Sie your-endpoint durch den Endpunkt für Ihre Ressource.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

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 Umgebungsvariablen hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, die die Umgebungsvariablen lesen müssen, 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.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bashrc aus, damit die Änderungen wirksam werden.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bash_profile aus, damit die Änderungen wirksam werden.

Xcode

Für die iOS- und macOS-Entwicklung legen Sie die Umgebungsvariablen in Xcode fest. Führen Sie zum Beispiel die folgenden Schritte aus, um die Umgebungsvariable in Xcode 13.4.1 festzulegen.

1. Wählen Sie Produkt>Schema>Schema bearbeiten aus.
2. Wählen Sie auf der Seite Ausführen (Debugausführung) die Option Argumente aus.
3. Klicken Sie unter Umgebungsvariablen auf das Pluszeichen (+), um eine neue Umgebungsvariable hinzuzufügen.
4. Geben Sie als Name den Wert LANGUAGE_KEY und für Wert den Schlüssel Ihrer Sprachressource ein.
5. Führen Sie diese Schritte für Ihren Ressourcenendpunkt aus. Geben Sie der neuen Umgebungsvariablen den Namen LANGUAGE_ENDPOINT.

Weitere Konfigurationsoptionen finden Sie in der Xcode-Dokumentation.

Installieren der Clientbibliothek

Nach der Installation von Python, können Sie die Clientbibliothek mit Folgendem installieren:

pip install azure-ai-textanalytics==5.2.0

Codebeispiel

Erstellen Sie eine neue Python-Datei, und kopieren Sie den folgenden Code. Führen Sie dann den Code aus.

# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
language_key = os.environ.get('LANGUAGE_KEY')
language_endpoint = os.environ.get('LANGUAGE_ENDPOINT')

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

# Authenticate the client using your key and endpoint 
def authenticate_client():
    ta_credential = AzureKeyCredential(language_key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=language_endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

def key_phrase_extraction_example(client):

    try:
        documents = ["Dr. Smith has a very modern medical office, and she has great staff."]

        response = client.extract_key_phrases(documents = documents)[0]

        if not response.is_error:
            print("\tKey Phrases:")
            for phrase in response.key_phrases:
                print("\t\t", phrase)
        else:
            print(response.id, response.error)

    except Exception as err:
        print("Encountered exception. {}".format(err))
        
key_phrase_extraction_example(client)

Ausgabe

Key Phrases:
    modern medical office
    Dr. Smith
    great staff

Referenzdokumentation

Verwenden Sie diese Schnellstartanleitung, um Anforderungen für die Schlüsselbegriffserkennung mithilfe der REST-API zu senden. Im folgenden Beispiel verwenden Sie cURL zum Erkennen von Schlüsselwörtern und -begriffen, die in Text gefunden werden.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos

Einrichten

Erstellen einer Azure-Ressource

Um das nachstehende Codebeispiel zu verwenden, müssen Sie eine Azure-Ressource bereitstellen. Diese Ressource enthält einen Schlüssel und Endpunkt, mit dem Sie die API-Aufrufe authentifizieren, die Sie an den Sprachdienst senden.

1. Verwenden Sie den folgenden Link, um über das Azure-Portal eine Sprachressource zu erstellen. Sie müssen sich mit Ihrem Azure-Abonnement anmelden.

2. Wählen Sie auf dem angezeigten Bildschirm Zusätzliche Funktionen auswählen die Option Fahren Sie fort mit dem Erstellen Ihrer Ressource aus.

   

3. Geben Sie auf dem Bildschirm Sprache erstellen die folgenden Informationen an:

   Detail	Beschreibung
   Subscription	Das Abonnementkonto, mit dem Ihre Ressource verknüpft wird. Wählen Sie im Dropdownmenü Ihr Azure-Abonnement aus.
   Ressourcengruppe	Eine Ressourcengruppe ist ein Container, der die von Ihnen erstellten Ressourcen speichert. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen.
   Region	Der Standort Ihrer Sprachressource Verschiedene Regionen können je nach physischem Standort Wartezeiten verursachen, haben aber keinen Einfluss auf die Laufzeitverfügbarkeit Ihrer Ressource. Wählen Sie für diesen Schnellstart entweder eine verfügbare Region in Ihrer Nähe oder USA, Osten aus.
   Name	Der Name für Ihre Sprachressource. Dieser Name wird auch zum Erstellen einer Endpunkt-URL verwendet, die Ihre Anwendungen zum Senden von API-Anforderungen verwenden.
   Tarif	Der Tarif für Ihre Sprachressource Sie können den Tarif Free F0 verwenden, um den Dienst zu testen, und später für die Produktion auf einen kostenpflichtigen Tarif upgraden.

   

4. Vergewissern Sie sich, dass das Kontrollkästchen Hinweis zu verantwortungsvoller KI aktiviert ist.

5. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

6. Stellen Sie auf dem angezeigten Bildschirm sicher, dass die Überprüfung erfolgreich war und dass Sie Ihre Informationen ordnungsgemäß eingegeben haben. Klicken Sie anschließend auf Erstellen.

Abrufen Ihres Schlüssels und Endpunkts

Als Nächstes benötigen Sie den Schlüssel und Endpunkt der Ressource, um Ihre Anwendung mit der API zu verbinden. Der Schlüssel und der Endpunkt werden später in der Schnellstartanleitung in den Code eingefügt.

1. Klicken Sie nach erfolgreicher Bereitstellung der Sprachressource unter Nächste Schritte auf die Schaltfläche Zu Ressource wechseln.

   

2. Wählen Sie auf dem Bildschirm für Ihre Ressource im linken Navigationsmenü die Option Schlüssel und Endpunkt aus. Sie verwenden einen Ihrer Schlüssel und Ihren Endpunkt in den folgenden Schritten.

   

Erstellen von Umgebungsvariablen

Ihre Anwendung muss authentifiziert werden, um API-Anforderungen senden zu können. In der Produktionsumgebung sollten Sie eine sichere Methode zum Speichern Ihrer Anmeldeinformationen sowie zum Zugriff darauf verwenden. In diesem Beispiel schreiben Sie Ihre Anmeldeinformationen in Umgebungsvariablen auf dem lokalen Computer, auf dem die Anwendung ausgeführt wird.

Um die Umgebungsvariable für Ihren Sprachressourcenschlüssel festzulegen, öffnen Sie ein Konsolenfenster und befolgen die Anweisungen für Ihr Betriebssystem und Ihre Entwicklungsumgebung.

• Zum Festlegen der Umgebungsvariablen LANGUAGE_KEY ersetzen Sie your-key durch einen der Schlüssel für Ihre Ressource.
• Zum Festlegen der Umgebungsvariablen LANGUAGE_ENDPOINT ersetzen Sie your-endpoint durch den Endpunkt für Ihre Ressource.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Windows

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

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 Umgebungsvariablen hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, die die Umgebungsvariablen lesen müssen, 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.

Linux

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bashrc aus, damit die Änderungen wirksam werden.

macOS

Bash

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Führen Sie nach dem Hinzufügen der Umgebungsvariablen im Konsolenfenster source ~/.bash_profile aus, damit die Änderungen wirksam werden.

Xcode

Für die iOS- und macOS-Entwicklung legen Sie die Umgebungsvariablen in Xcode fest. Führen Sie zum Beispiel die folgenden Schritte aus, um die Umgebungsvariable in Xcode 13.4.1 festzulegen.

1. Wählen Sie Produkt>Schema>Schema bearbeiten aus.
2. Wählen Sie auf der Seite Ausführen (Debugausführung) die Option Argumente aus.
3. Klicken Sie unter Umgebungsvariablen auf das Pluszeichen (+), um eine neue Umgebungsvariable hinzuzufügen.
4. Geben Sie als Name den Wert LANGUAGE_KEY und für Wert den Schlüssel Ihrer Sprachressource ein.
5. Führen Sie diese Schritte für Ihren Ressourcenendpunkt aus. Geben Sie der neuen Umgebungsvariablen den Namen LANGUAGE_ENDPOINT.

Weitere Konfigurationsoptionen finden Sie in der Xcode-Dokumentation.

Erstellen einer JSON-Datei mit dem Beispielanforderungstext

Erstellen Sie in einem Code-Editor eine neue Datei namens test_kpe_payload.json, und kopieren Sie das folgende JSON-Beispiel. Diese Beispielanforderung wird im nächsten Schritt an die API gesendet.

{
    "kind": "KeyPhraseExtraction",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language":"en",
                "text": "Dr. Smith has a very modern medical office, and she has great staff."
            }
        ]
    }
}

Speichern Sie test_kpe_payload.json irgendwo auf Ihrem Computer. Beispielsweise auf Ihrem Desktop.

Senden einer API-Anforderung für die Schlüsselbegriffserkennung

Verwenden Sie die folgenden Befehle, um die API-Anforderung mithilfe des von Ihnen genutzten Programms zu senden. Kopieren Sie den Befehl in Ihr Terminal, und führen Sie ihn aus.

parameter	BESCHREIBUNG
-X POST <endpoint>	Gibt den Endpunkt für den Zugriff auf die API an
-H Content-Type: application/json	Der Inhaltstyp zum Senden von JSON-Daten
-H "Ocp-Apim-Subscription-Key:<key>	Gibt den Schlüssel für den Zugriff auf die API an
-d <documents>	Die JSON-Datei, die die zu sendenden Dokumente enthält

Windows

Ersetzen Sie C:\Users\<myaccount>\Desktop\test_kpe_payload.json durch den Speicherort der im vorherigen Schritt erstellten JSON-Anforderungsdatei.

Eingabeaufforderung

curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2022-05-01" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_kpe_payload.json"

PowerShell

curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_kpe_payload.json"

Linux

Verwenden Sie die folgenden Befehle, um die API-Anforderung mithilfe des von Ihnen genutzten Programms zu senden. Ersetzen Sie /home/mydir/test_kpe_payload.json durch den Speicherort der im vorherigen Schritt erstellten JSON-Anforderungsdatei.

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_kpe_payload.json"

macOS

Verwenden Sie die folgenden Befehle, um die API-Anforderung mithilfe des von Ihnen genutzten Programms zu senden. Ersetzen Sie /home/mydir/test_kpe_payload.json durch den Speicherort der im vorherigen Schritt erstellten JSON-Anforderungsdatei.

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_kpe_payload.json"

JSON-Antwort

{
	"kind": "KeyPhraseExtractionResults",
	"results": {
		"documents": [{
			"id": "1",
			"keyPhrases": ["modern medical office", "Dr. Smith", "great staff"],
			"warnings": []
		}],
		"errors": [],
		"modelVersion": "2021-06-01"
	}
}

Voraussetzungen

• Erstellen eines Projekts in Foundry im Azure AI Foundry-Portal

Navigieren Sie zum Playground in Azure AI Foundry

Wählen Sie im linken Bereich Playgrounds aus. Wählen Sie dann die Schaltfläche Sprach-Playground testen aus.

Verwenden der Schlüsselbegriffserkennung im Playground von Azure AI Foundry

Der Sprach-Playground besteht aus vier Abschnitten:

• Oberes Banner: Hier können Sie einen der derzeit verfügbaren Sprachdienste auswählen.
• Rechter Bereich: In diesem Bereich finden Sie die Optionen zur Konfiguration für den Dienst, z. B. die API und Modellversion, sowie Features, die für den Dienst spezifisch sind.
• Mittlerer Bereich: In diesem Bereich geben Sie Ihren Text zur Verarbeitung ein. Nachdem der Vorgang ausgeführt wurde, werden hier Ergebnisse angezeigt.
• Rechter Bereich: In diesem Bereich werden Details zum Ausführungsvorgang angezeigt.

Hier können Sie über die Bannerkachel oben Schlüsselbegriffe extrahieren die Funktion „Schlüsselbegriffserkennung“ auswählen.

Verwenden der Option „Schlüsselbegriffe extrahieren“

Die Option Schlüsselbegriffe extrahieren dient dem Extrahieren von Schlüsselbegriffen aus Text.

Unter Konfiguration stehen folgende Optionen zur Verfügung:

Option	Beschreibung
Auswählen der API-Version	Wählen Sie aus, welche Version der API verwendet werden soll.
Auswählen der Modellversion	Wählen Sie aus, welche Version des Modells verwendet werden soll.
Textsprache auswählen	Wählen Sie die Sprache des Eingabetexts aus.

Nach Abschluss des Vorgangs ist jede Entität im mittleren Bereich unterstrichen. Der Abschnitt Details enthält die folgenden Felder für die allgemeine Stimmung und die Stimmung der einzelnen Sätze:

Feld	BESCHREIBUNG
Extrahierte Schlüsselbegriffe	Eine Liste der extrahierten Schlüsselbegriffe.

Bereinigen von Ressourcen

Wenn Sie ein Azure KI 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 Ressourcen gelöscht, die ihr zugeordnet sind.

• Azure portal
• Azure-Befehlszeilenschnittstelle

Nächste Schritte

• Übersicht über die Schlüsselbegriffserkennung