Sdílet prostřednictvím

Asynchronní používání funkcí služby Jazyk

  • Článek

Služba Language umožňuje posílat požadavky rozhraní API asynchronně pomocí rozhraní REST API nebo klientské knihovny. Do vaší žádosti můžete zahrnout také několik různých funkcí služby jazyka, které se mají provádět na vašich datech současně.

V současné době jsou k dispozici následující funkce, které je možné používat asynchronně:

  • Spojování entit
  • Sumarizace dokumentů
  • Souhrn konverzace
  • Extrakce klíčových frází
  • Rozpoznávání jazyka
  • Rozpoznávání pojmenovaných entit (NER, Named Entity Recognition)
  • Detekce obsahu zákazníka
  • Analýza zabarvení a dolování názorů
  • Analýza textu pro zdravotnictví
  • Identifikovatelné osobní údaje (PII)

Při odesílání asynchronních požadavků se vám budou účtovat poplatky na základě počtu textových záznamů, které do požadavku zahrnete, pro každé použití funkcí. Pokud například odešlete textový záznam pro analýzu mínění a NER, bude se počítat jako odesílání dvou textových záznamů a bude se vám účtovat obojí podle cenové úrovně.

Odeslání asynchronní úlohy pomocí rozhraní REST API

Pokud chcete odeslat asynchronní úlohu, projděte si referenční dokumentaci k textu JSON, který odešlete v požadavku.

  1. Přidejte do objektu analysisInput dokumenty.
  2. Do objektu tasks zahrňte operace, které chcete s daty provést. Pokud byste například chtěli provést analýzu mínění, zahrnuli SentimentAnalysisLROTask byste objekt.
  3. Volitelně můžete:
    1. Zvolte konkrétní verzi modelu použitého pro vaše data.
    2. Do objektu tasks zahrňte další funkce služby jazyka, které se mají provádět na vašich datech ve stejnou dobu.

Po vytvoření textu JSON pro váš požadavek přidejte klíč do hlavičky Ocp-Apim-Subscription-Key . Pak odešlete požadavek rozhraní API do koncového bodu pro vytvoření úlohy. Příklad:

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

Úspěšné volání vrátí kód odpovědi 202. V operation-location hlavičce odpovědi bude adresa URL, kterou použijete k načtení výsledků rozhraní API. Hodnota bude vypadat podobně jako následující adresa URL:

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

Pokud chcete získat stav a načíst výsledky požadavku, odešlete požadavek GET na adresu URL, kterou jste obdrželi v operation-location hlavičce z předchozí odpovědi rozhraní API. Nezapomeňte do souboru Ocp-Apim-Subscription-Key. Odpověď bude obsahovat výsledky volání rozhraní API.

Odesílání asynchronních požadavků rozhraní API pomocí klientské knihovny

Nejprve se ujistěte, že máte nainstalovanou klientskou knihovnu pro jazyk podle vašeho výběru. Postup instalace klientské knihovny najdete v článku rychlý start pro funkci, kterou chcete použít.

Potom pomocí klientského objektu odešlete asynchronní volání do rozhraní API. Volání metody, která se mají použít, se bude lišit v závislosti na vašem jazyce. Využijte dostupné ukázky a referenční dokumentaci, které vám pomůžou začít.

Dostupnost výsledků

Při asynchronním použití této funkce jsou výsledky rozhraní API k dispozici po dobu 24 hodin od doby, kdy se žádost ingestovala, a je uvedena v odpovědi. Po uplynutí tohoto časového období se výsledky vyprázdní a už nejsou k dispozici pro načtení.

Automatická detekce jazyka

Od verze 2022-07-01-preview rozhraní REST API můžete v dokumentech požádat o automatické rozpoznávání jazyka. Nastavením parametru na language auto, zjištěný kód jazyka textu bude vrácen jako hodnota jazyka v odpovědi. Za tuto detekci jazyka se vám nebudou účtovat další poplatky.

Omezení dat

Poznámka:

  • Pokud potřebujete analyzovat větší dokumenty, než umožňuje limit, můžete text před odesláním do rozhraní API rozdělit na menší bloky textu.
  • Dokument je jeden řetězec textových znaků.

Ve všech dokumentech obsažených v asynchronním požadavku můžete odeslat až 125 000 znaků, jak měří StringInfo.LengthInTextElements. Tento limit znaků je vyšší než limit pro synchronní požadavky, aby se povolila vyšší propustnost.

Pokud dokument překročí limit znaků, rozhraní API odmítne celý požadavek a vrátí 400 bad request chybu, pokud některý z dokumentů v něm překročí maximální velikost.

Viz také