A Language Service funkcióinak aszinkron használata

  • Cikk

A Nyelvi szolgáltatás lehetővé teszi az API-kérések aszinkron küldését a REST API vagy az ügyfélkódtár használatával. A kérésben több különböző nyelvi szolgáltatás is szerepelhet, amelyeket egyszerre kell elvégeznie az adatain.

Jelenleg az alábbi funkciók használhatók aszinkron módon:

  • Entitáskapcsolás
  • Dokumentumok összegzése
  • Beszélgetések összegzése
  • Kulcsszókeresés
  • Nyelvfelismerés
  • Nevesített entitások felismerése (NER)
  • Ügyféloldali tartalomészlelés
  • Hangulatelemzés és véleménybányászat
  • Egészségügyi Text Analytics
  • Személyes azonosításra alkalmas adatok (PII)

Ha aszinkron kéréseket küld, a kérésben szereplő szövegrekordok száma alapján díjakat kell fizetnie az egyes funkciók használata esetén. Ha például egy szöveges rekordot küld hangulatelemzéshez és NER-hez, az két szöveges rekord elküldésének számít, és mindkettőért díjat kell fizetnie a tarifacsomag szerint.

Aszinkron feladat elküldése a REST API használatával

Az aszinkron feladat elküldéséhez tekintse át a kérelemben elküldendő JSON-törzs referenciadokumentációját .

  1. Adja hozzá a dokumentumokat az analysisInput objektumhoz.
  2. Az objektumban tasks adja meg az adatokon végrehajtandó műveleteket. Ha például hangulatelemzést szeretne végezni, az objektumot SentimentAnalysisLROTask is belefoglalná.
  3. Igény szerint:
    1. Válassza ki az adatokhoz használt modell egy adott verzióját.
    2. Adjon hozzá további nyelvi szolgáltatási funkciókat az tasks objektumhoz, amelyeket az adatokon egyszerre kell elvégeznie.

Miután létrehozta a JSON-törzset a kéréshez, adja hozzá a kulcsot a Ocp-Apim-Subscription-Key fejléchez. Ezután küldje el az API-kérést a feladatlétrehozás végpontjához. Példa:

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

Egy sikeres hívás egy 202-ben küldött válaszkódot ad vissza. A operation-location válasz fejlécében az API-eredmények lekéréséhez használt URL-cím lesz. Az érték a következő URL-címhez hasonlóan fog kinézni:

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

Az állapot lekéréséhez és a kérés eredményeinek lekéréséhez küldjön EGY GET kérést az operation-location előző API-válasz fejlécében kapott URL-címre. Ne felejtse el belefoglalni a kulcsot a Ocp-Apim-Subscription-Key. A válasz tartalmazza az API-hívás eredményét.

Aszinkron API-kérések küldése az ügyfélkódtár használatával

Először győződjön meg arról, hogy telepítve van az ügyfélkódtár a választott nyelvhez. Az ügyféloldali kódtár telepítésének lépéseit a használni kívánt szolgáltatás rövid útmutatója tartalmazza.

Ezután az ügyfélobjektum használatával aszinkron hívásokat küldhet az API-nak. A használni kívánt metódushívások a nyelvtől függően változnak. Az első lépésekhez használja az elérhető mintákat és referenciadokumentációt.

Eredmény rendelkezésre állása

Ha ezt a funkciót aszinkron módon használja, az API-eredmények a kérelem betöltésétől számítva 24 órán át érhetők el, és a válasz jelzi. Ez után az idő elteltével az eredmények törlődnek, és már nem érhetők el a lekéréshez.

Automatikus nyelvfelismerés

A REST API verziójától 2022-07-01-preview kezdve kérheti a dokumentumok automatikus nyelvfelismerését . A paraméter autobeállításával language a szöveg észlelt nyelvi kódja nyelvi értékként jelenik meg a válaszban. Ez a nyelvfelismerés nem jár többletköltséggel a nyelvi erőforrás számára.

Adatkorlátok

Feljegyzés

  • Ha nagyobb dokumentumokat kell elemeznie, mint amennyit a korlát megenged, a szöveget kisebb szövegtömbökre bonthatja, mielőtt elküldené őket az API-nak.
  • A dokumentum egy szöveges karaktersorozat.

Legfeljebb 125 000 karaktert küldhet az aszinkron kérelemben szereplő összes dokumentumra a StringInfo.LengthInTextElements által mért módon. Ez a karakterkorlát nagyobb, mint a szinkron kérések korlátja, így nagyobb átviteli sebesség érhető el.

Ha egy dokumentum túllépi a karakterkorlátot, az API elutasítja a teljes kérést 400 bad request , és hibát ad vissza, ha a benne lévő dokumentumok mérete meghaladja a maximális méretet.

Lásd még