Share via

Quickstart: de taaldetectieclientbibliotheek en REST API gebruiken

  • Artikel

Referentiedocumentatie Meer voorbeeldenpakket | (NuGet) | -bibliotheekbroncode |

Gebruik deze quickstart om een taaldetectietoepassing te maken met de clientbibliotheek voor .NET. In het volgende voorbeeld maakt u een C#-toepassing waarmee de taal kan worden geïdentificeerd waarin een tekstvoorbeeld is geschreven.

Tip

U kunt Language Studio gebruiken om taalservicefuncties te proberen zonder code te hoeven schrijven.

Vereisten

  • Azure-abonnement: Krijg een gratis abonnement
  • De Visual Studio IDE
  • Zodra u uw Azure-abonnement hebt, maakt u een taalresource in Azure Portal om uw sleutel en eindpunt op te halen. Nadat de app is geïmplementeerd, selecteert u Ga naar resource.
    • U hebt de sleutel en het eindpunt nodig van de resource die u maakt om uw toepassing te verbinden met de API. U plakt uw sleutel en eindpunt verderop in de code in de quickstart.
    • U kunt de gratis prijscategorie (Free F0) gebruiken om de service uit te proberen, en later upgraden naar een betaalde laag voor productie.
  • Als u de functie Analyseren wilt gebruiken, hebt u een taalresource nodig met de prijscategorie Standard (S).

Instellen

Een nieuwe .NET Core-app maken

Maak een nieuwe console-app in .NET Core met behulp van de Visual Studio IDE. Hiermee maakt u een project 'Hallo wereld' met één C#-bronbestand: program.cs.

Installeer de clientbibliotheek door met de rechtermuisknop op de oplossing te klikken in Solution Explorer en NuGet-pakketten beheren te selecteren. Selecteer in Package Manager dat wordt geopend de optie Bladeren en zoek naar Azure.AI.TextAnalytics. Selecteer versie 5.2.0 en vervolgens Installeren. U kunt ook de Package Manager-console gebruiken.

Voorbeeld van code

Kopieer de volgende code naar uw program.cs-bestand . Vergeet niet om de key variabele te vervangen door de sleutel voor uw resource en vervang de endpoint variabele door het eindpunt voor uw resource. Voer de code vervolgens uit.

Belangrijk

Ga naar de Azure Portal. Als de taalresource die u in de sectie Vereisten hebt gemaakt, is geïmplementeerd, klikt u op de knop Naar de resource gaan onder Volgende stappen. U vindt uw sleutel en eindpunt door te navigeren naar de pagina Sleutels en eindpunt van uw resource, onder Resourcebeheer.

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en maak deze sleutel nooit openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het beveiligingsartikel over Azure AI-services voor meer informatie.

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

namespace LanguageDetectionExample
{
    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");

        // Example method for detecting the language of text
        static void LanguageDetectionExample(TextAnalyticsClient client)
        {
            DetectedLanguage detectedLanguage = client.DetectLanguage("Ce document est rédigé en Français.");
            Console.WriteLine("Language:");
            Console.WriteLine($"\t{detectedLanguage.Name},\tISO-6391: {detectedLanguage.Iso6391Name}\n");
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(languageEndpoint, languageKey);
            LanguageDetectionExample(client);

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

    }
}

Uitvoer

Language:
    French, ISO-6391: fr

Referentiedocumentatie | Meer voorbeelden | pakket (Maven) | Bibliotheek broncode

Gebruik deze quickstart om een taaldetectietoepassing te maken met de clientbibliotheek voor Java. In het volgende voorbeeld maakt u een Java-toepassing waarmee de taal kan worden geïdentificeerd waarin een tekstvoorbeeld is geschreven.

Tip

U kunt Language Studio gebruiken om taalservicefuncties te proberen zonder code te hoeven schrijven.

Vereisten

  • Azure-abonnement: Krijg een gratis abonnement
  • Java Development Kit (JDK) met versie 8 of hoger
  • Zodra u uw Azure-abonnement hebt, maakt u een taalresource in Azure Portal om uw sleutel en eindpunt op te halen. Nadat de app is geïmplementeerd, selecteert u Ga naar resource.
    • U hebt de sleutel en het eindpunt nodig van de resource die u maakt om uw toepassing te verbinden met de API. U plakt uw sleutel en eindpunt verderop in de onderstaande code in de quickstart.
    • U kunt de gratis prijscategorie (Free F0) gebruiken om de service uit te proberen, en later upgraden naar een betaalde laag voor productie.
  • Als u de functie Analyseren wilt gebruiken, hebt u een taalresource nodig met de prijscategorie Standard (S).

Instellen

De clientbibliotheek toevoegen

Maak een Maven-project in uw favoriete IDE of ontwikkelomgeving. Voeg vervolgens de volgende afhankelijkheid toe aan het pom.xml-bestand van uw project. U kunt de implementatiesyntaxis voor andere compilatieprogramma's online vinden.

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

Voorbeeld van code

Maak een Java-bestand met de naam Example.java. Open het bestand en kopieer de onderstaande code. Vergeet niet om de key variabele te vervangen door de sleutel voor uw resource en vervang de endpoint variabele door het eindpunt voor uw resource. Voer de code vervolgens uit.

Belangrijk

Ga naar de Azure Portal. Als de taalresource die u in de sectie Vereisten hebt gemaakt, is geïmplementeerd, klikt u op de knop Naar de resource gaan onder Volgende stappen. U vindt uw sleutel en eindpunt door te navigeren naar de pagina Sleutels en eindpunt van uw resource, onder Resourcebeheer.

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en maak deze sleutel nooit openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het beveiligingsartikel over Azure AI-services voor meer informatie.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
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);
        detectLanguageExample(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 detecting the language of text
    static void detectLanguageExample(TextAnalyticsClient client)
    {
        // The text to be analyzed.
        String text = "Ce document est rédigé en Français.";

        DetectedLanguage detectedLanguage = client.detectLanguage(text);
        System.out.printf("Detected primary language: %s, ISO 6391 name: %s, score: %.2f.%n",
                detectedLanguage.getName(),
                detectedLanguage.getIso6391Name(),
                detectedLanguage.getConfidenceScore());
    }
}

Uitvoer

Detected primary language: French, ISO 6391 name: fr, score: 1.00.

Referentiedocumentatie | Meer voorbeelden | pakket (npm) | bibliotheek broncode

Gebruik deze quickstart om een taaldetectietoepassing te maken met de clientbibliotheek voor Node.js. In het volgende voorbeeld maakt u een JavaScript-toepassing waarmee de taal kan worden geïdentificeerd waarin een tekstvoorbeeld is geschreven.

Tip

U kunt Language Studio gebruiken om taalservicefuncties te proberen zonder code te hoeven schrijven.

Vereisten

  • Azure-abonnement: Krijg een gratis abonnement
  • Node.js v14 LTS of hoger
  • Zodra u uw Azure-abonnement hebt, maakt u een taalresource in Azure Portal om uw sleutel en eindpunt op te halen. Nadat de app is geïmplementeerd, selecteert u Ga naar resource.
    • U hebt de sleutel en het eindpunt nodig van de resource die u maakt om uw toepassing te verbinden met de API. U plakt uw sleutel en eindpunt verderop in de onderstaande code in de quickstart.
    • U kunt de gratis prijscategorie (Free F0) gebruiken om de service uit te proberen, en later upgraden naar een betaalde laag voor productie.
  • Als u de functie Analyseren wilt gebruiken, hebt u een taalresource nodig met de prijscategorie Standard (S).

Instellen

Een nieuwe Node.js-toepassing maken

Maak in een consolevenster (zoals cmd, PowerShell of Bash) een nieuwe map voor de app, en navigeer naar deze map.

mkdir myapp 

cd myapp

Voer de opdracht npm init uit om een knooppunttoepassing te maken met een package.json-bestand.

npm init

De clientbibliotheek installeren

Installeer het npm-pakket:

npm install @azure/ai-language-text

Voorbeeld van code

Open het bestand en kopieer de onderstaande code. Vergeet niet om de key variabele te vervangen door de sleutel voor uw resource en vervang de endpoint variabele door het eindpunt voor uw resource. Voer de code vervolgens uit.

Belangrijk

Ga naar de Azure Portal. Als de taalresource die u in de sectie Vereisten hebt gemaakt, is geïmplementeerd, klikt u op de knop Naar de resource gaan onder Volgende stappen. U vindt uw sleutel en eindpunt door te navigeren naar de pagina Sleutels en eindpunt van uw resource, onder Resourcebeheer.

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en maak deze sleutel nooit openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het beveiligingsartikel over Azure AI-services voor meer informatie.

"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 sentences in different languages to be analyzed
const documents = [
    "This document is written in English.",
    "这是一个用中文写的文件",
];

//Example of how to use the client library to detect language
async function main() {
    console.log("== Language detection sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const result = await client.analyze("LanguageDetection", documents);
  
    for (const doc of result) {
      if (!doc.error) {
        console.log(
          `ID ${doc.id} - Primary language: ${doc.primaryLanguage.name} (iso6391 name: ${doc.primaryLanguage.iso6391Name})`
        );
      }
    }
}

main().catch((err) => {
    console.error("The sample encountered an error:", err);
});

Uitvoer

== Language detection sample ==
ID 0 - Primary language: English (iso6391 name: en)
ID 1 - Primary language: Chinese_Simplified (iso6391 name: zh_chs)

Referentiedocumentatie Meer voorbeeldenpakket | (PyPi) | Library-broncode |

Gebruik deze quickstart om een taaldetectietoepassing te maken met de clientbibliotheek voor Python. In het volgende voorbeeld maakt u een Python-toepassing waarmee de taal kan worden geïdentificeerd waarin een tekstvoorbeeld is geschreven.

Tip

U kunt Language Studio gebruiken om taalservicefuncties te proberen zonder code te hoeven schrijven.

Vereisten

  • Azure-abonnement: Krijg een gratis abonnement
  • Python 3.8 of hoger
  • Zodra u uw Azure-abonnement hebt, maakt u een taalresource in Azure Portal om uw sleutel en eindpunt op te halen. Nadat de app is geïmplementeerd, selecteert u Ga naar resource.
    • U hebt de sleutel en het eindpunt nodig van de resource die u maakt om uw toepassing te verbinden met de API. U plakt uw sleutel en eindpunt verderop in de onderstaande code in de quickstart.
    • U kunt de gratis prijscategorie (Free F0) gebruiken om de service uit te proberen, en later upgraden naar een betaalde laag voor productie.
  • Als u de functie Analyseren wilt gebruiken, hebt u een taalresource nodig met de prijscategorie Standard (S).

Instellen

De clientbibliotheek installeren

Na de installatie van Python kunt u de clientbibliotheek installeren met:

pip install azure-ai-textanalytics==5.2.0

Voorbeeld van code

Maak een nieuw Python-bestand en kopieer de onderstaande code. Vergeet niet om de key variabele te vervangen door de sleutel voor uw resource en vervang de endpoint variabele door het eindpunt voor uw resource. Voer de code vervolgens uit.

Belangrijk

Ga naar de Azure Portal. Als de taalresource die u in de sectie Vereisten hebt gemaakt, is geïmplementeerd, klikt u op de knop Naar de resource gaan onder Volgende stappen. U vindt uw sleutel en eindpunt door te navigeren naar de pagina Sleutels en eindpunt van uw resource, onder Resourcebeheer.

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en maak deze sleutel nooit openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het beveiligingsartikel over Azure AI-services voor meer informatie.


# 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()

# Example method for detecting the language of text
def language_detection_example(client):
    try:
        documents = ["Ce document est rédigé en Français."]
        response = client.detect_language(documents = documents, country_hint = 'us')[0]
        print("Language: ", response.primary_language.name)

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

Uitvoer

Language:  French

Referentiedocumentatie

Gebruik deze quickstart om taaldetectieaanvragen te verzenden met behulp van de REST API. In het volgende voorbeeld gebruikt u cURL om de taal te identificeren waarin een tekstvoorbeeld is geschreven.

Vereisten

Instellen

Een Azure-resource maken

Als u het onderstaande codevoorbeeld wilt gebruiken, moet u een Azure-resource implementeren. Deze resource bevat een sleutel en eindpunt dat u gebruikt voor het verifiëren van de API-aanroepen die u naar de Taalservice verzendt.

  1. Gebruik de volgende koppeling om een taalresource te maken met behulp van Azure Portal. U moet zich aanmelden met uw Azure-abonnement.

  2. Selecteer doorgaan om uw resource te maken in het scherm Aanvullende functies selecteren dat wordt weergegeven.

    Een schermopname met extra functieopties in Azure Portal.

  3. Geef in het scherm Taal maken de volgende informatie op:

    Details Beschrijving
    Abonnement Het abonnementsaccount waaraan uw resource wordt gekoppeld. Selecteer uw Azure-abonnement in de vervolgkeuzelijst.
    Resourcegroep Een resourcegroep is een container waarin de resources die u maakt, worden opgeslagen. Selecteer Nieuwe maken om een nieuwe resourcegroep te maken.
    Regio De locatie van uw taalresource. Verschillende regio's kunnen latentie veroorzaken, afhankelijk van uw fysieke locatie, maar hebben geen invloed op de runtime-beschikbaarheid van uw resource. Voor deze quickstart selecteert u een beschikbare regio bij u in de buurt of kiest u VS - oost.
    Naam De naam voor uw taalresource. Deze naam wordt ook gebruikt om een eindpunt-URL te maken die uw toepassingen gebruiken om API-aanvragen te verzenden.
    Prijscategorie De prijscategorie voor uw taalresource. U kunt de gratis F0-laag gebruiken om de service uit te proberen en later een upgrade uit te voeren naar een betaalde laag voor productie.

    Een schermopname van details over het maken van resources in Azure Portal.

  4. Zorg ervoor dat het selectievakje Verantwoordelijke AI-kennisgeving is ingeschakeld.

  5. Selecteer Controleren en maken onderaan de pagina.

  6. Controleer in het scherm dat wordt weergegeven of de validatie is geslaagd en of u de gegevens correct hebt ingevoerd. Selecteer vervolgens Maken.

Uw sleutel en eindpunt ophalen

Vervolgens hebt u de sleutel en het eindpunt van de resource nodig om uw toepassing te verbinden met de API. Verderop in de quickstart plakt u uw sleutel en eindpunt in de code.

  1. Nadat de taalresource is geïmplementeerd, klikt u onder Volgende stappen op de knop Naar de resource gaan.

    Een schermopname van de volgende stappen nadat een resource is geïmplementeerd.

  2. Selecteer sleutels en eindpunt in het linkernavigatiemenu op het scherm voor uw resource. U gebruikt een van uw sleutels en uw eindpunt in de onderstaande stappen.

    Een schermopname van de sectie sleutels en eindpunten voor een resource.

Omgevingsvariabelen maken

Uw toepassing moet worden geverifieerd om API-aanvragen te verzenden. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen. In dit voorbeeld schrijft u uw referenties naar omgevingsvariabelen op de lokale computer waarop de toepassing wordt uitgevoerd.

Tip

Neem de sleutel niet rechtstreeks op in uw code en plaats deze nooit openbaar. Zie het beveiligingsartikel over Azure AI-services voor meer verificatieopties, zoals Azure Key Vault.

Als u de omgevingsvariabele voor uw taalresourcesleutel wilt instellen, opent u een consolevenster en volgt u de instructies voor uw besturingssysteem en ontwikkelomgeving.

  1. Als u de LANGUAGE_KEY omgevingsvariabele wilt instellen, vervangt u deze door your-key een van de sleutels voor uw resource.
  2. Als u de LANGUAGE_ENDPOINT omgevingsvariabele wilt instellen, vervangt your-endpoint u het eindpunt voor uw resource.
setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

Notitie

Als u alleen toegang nodig hebt tot de omgevingsvariabelen in de huidige actieve console, kunt u de omgevingsvariabele instellen in set plaats van setx.

Nadat u de omgevingsvariabelen hebt toegevoegd, moet u mogelijk alle actieve programma's opnieuw opstarten die de omgevingsvariabelen moeten lezen, inclusief het consolevenster. Als u bijvoorbeeld Visual Studio als editor gebruikt, start u Visual Studio opnieuw voordat u het voorbeeld uitvoert.

Een JSON-bestand maken met de voorbeeldtekst van de aanvraag

Maak in een code-editor een nieuw bestand met de naam test_detection_payload.json en kopieer het volgende JSON-voorbeeld. Deze voorbeeldaanvraag wordt in de volgende stap naar de API verzonden.

Notitie

  • U kunt taalspecifieke voorbeelden vinden op GitHub (Engelstalig).
{
    "kind": "LanguageDetection",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "text": "This is a document written in English."
            }
        ]
    }
}

Sla test_detection_payload.json ergens op uw computer op. Bijvoorbeeld uw bureaublad.

Een aanvraag voor taaldetectie verzenden

Gebruik de volgende opdrachten om de API-aanvraag te verzenden met behulp van het programma dat u gebruikt. Kopieer de opdracht naar uw terminal en voer deze uit.

parameter Description
-X POST <endpoint> Hiermee geeft u het eindpunt voor toegang tot de API op.
-H Content-Type: application/json Het inhoudstype voor het verzenden van JSON-gegevens.
-H "Ocp-Apim-Subscription-Key:<key> Hiermee geeft u de sleutel voor toegang tot de API op.
-d <documents> De JSON met de documenten die u wilt verzenden.

Vervang C:\Users\<myaccount>\Desktop\test_detection_payload.json door de locatie van het voorbeeld-JSON-aanvraagbestand dat u in de vorige stap hebt gemaakt.

Opdrachtprompt

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

Powershell

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

JSON-antwoord

{
    "kind": "LanguageDetectionResults",
    "results": {
        "documents": [
            {
                "id": "1",
                "detectedLanguage": {
                    "name": "English",
                    "iso6391Name": "en",
                    "confidenceScore": 1.0,
                    "script": "Latin",
                    "scriptCode": "Latn"
                },
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2023-12-01"
    }
}

Gebruik de volgende opdrachten om de omgevingsvariabelen te verwijderen die u voor deze quickstart hebt gemaakt.

reg delete "HKCU\Environment" /v LANGUAGE_KEY /f

reg delete "HKCU\Environment" /v LANGUAGE_ENDPOINT /f

Resources opschonen

Als u een Azure AI-servicesabonnement wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle bijbehorende resources verwijderd.

Volgende stappen