Dela via

Så här använder du språktjänstfunktioner asynkront

  • Artikel

Med language-tjänsten kan du skicka API-begäranden asynkront med hjälp av antingen REST-API:et eller klientbiblioteket. Du kan också inkludera flera olika språktjänstfunktioner i din begäran, som ska utföras på dina data samtidigt.

För närvarande är följande funktioner tillgängliga för användning asynkront:

  • Entitetslänkning
  • Dokumentsammanfattning
  • Konversationssammanfattning
  • Extrahering av diskussionsämne
  • Språkidentifiering
  • Igenkänning av namngiven enhet (NER)
  • Identifiering av kundinnehåll
  • Attitydanalys och åsiktsutvinning
  • Text Analytics for Health
  • Personlig identifierbar information (PII)

När du skickar asynkrona begäranden debiteras du baserat på antalet textposter som du inkluderar i din begäran för varje funktionsanvändning. Om du till exempel skickar en textpost för attitydanalys och NER räknas den som att två textposter skickas och du debiteras för båda enligt prisnivån.

Skicka ett asynkront jobb med hjälp av REST-API:et

Om du vill skicka ett asynkront jobb läser du referensdokumentationen för JSON-brödtexten som du skickar i din begäran.

  1. Lägg till dina dokument i analysisInput objektet.
  2. tasks I objektet inkluderar du de åtgärder som du vill utföra på dina data. Om du till exempel vill utföra attitydanalys skulle du inkludera objektet SentimentAnalysisLROTask .
  3. Du kan också:
    1. Välj en specifik version av modellen som används för dina data.
    2. Inkludera ytterligare språktjänstfunktioner i tasks objektet som ska utföras på dina data samtidigt.

När du har skapat JSON-brödtexten för din begäran lägger du till nyckeln i Ocp-Apim-Subscription-Key rubriken. Skicka sedan din API-begäran till slutpunkten för att skapa jobb. Till exempel:

POST https://your-endpoint.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-05-01

Ett lyckat anrop returnerar en 202-svarskod. I operation-location svarshuvudet kommer att vara den URL som du ska använda för att hämta API-resultaten. Värdet ser ut ungefär så här:

GET {Endpoint}/language/analyze-text/jobs/12345678-1234-1234-1234-12345678?api-version=2022-05-01

Om du vill hämta statusen och hämta resultatet av begäran skickar du en GET-begäran till den URL som du fick i operation-location huvudet från föregående API-svar. Kom ihåg att inkludera din nyckel i Ocp-Apim-Subscription-Key. Svaret innehåller resultatet av ditt API-anrop.

Skicka asynkrona API-begäranden med hjälp av klientbiblioteket

Kontrollera först att du har klientbiblioteket installerat för valfritt språk. Anvisningar om hur du installerar klientbiblioteket finns i snabbstartsartikeln för den funktion som du vill använda.

Därefter använder du klientobjektet för att skicka asynkrona anrop till API:et. Vilka metodanrop som ska användas varierar beroende på ditt språk. Använd de tillgängliga exemplen och referensdokumentationen för att komma igång.

Resultattillgänglighet

När du använder den här funktionen asynkront är API-resultaten tillgängliga i 24 timmar från den tidpunkt då begäran matades in och anges i svaret. Efter den här tidsperioden rensas resultaten och är inte längre tillgängliga för hämtning.

Automatisk språkidentifiering

Från och med versionen 2022-07-01-preview av REST-API:et kan du begära automatisk språkidentifiering i dina dokument. Genom att ange parametern language till autoreturneras den identifierade språkkoden för texten som ett språkvärde i svaret. Den här språkidentifieringen medför inte extra avgifter för språkresursen.

Databegränsningar

Kommentar

  • Om du behöver analysera större dokument än vad gränsen tillåter kan du dela upp texten i mindre textsegment innan du skickar dem till API:et.
  • Ett dokument är en enda sträng med texttecken.

Du kan skicka upp till 125 000 tecken i alla dokument som finns i den asynkrona begäran, mätt med StringInfo.LengthInTextElements. Den här teckengränsen är högre än gränsen för synkrona begäranden för att aktivera högre dataflöde.

Om ett dokument överskrider teckengränsen avvisar API:et hela begäran och returnerar ett 400 bad request fel om något dokument inom det överskrider den maximala storleken.

Se även