Az elnevezett entitásfelismerés (NER) használata
A NER-funkció kiértékelheti a strukturálatlan szöveget, és kinyerheti a névvel ellátott entitásokat a szövegből számos előre definiált kategóriában, például személy, hely, esemény, termék és szervezet.
Fejlesztési lehetőségek
Az elnevezett entitásfelismerés használatához nyers, strukturálatlan szöveget kell küldenie elemzéshez, és kezelnie kell az API-kimenetet az alkalmazásban. Az elemzés az adott módon történik, az adatokon használt modell további testreszabása nélkül. Az elnevezett entitásfelismerés kétféleképpen használható:
| Fejlesztési lehetőség | Leírás |
|---|---|
| Language Studio | A Language Studio egy webes platform, amellyel azure-fiók nélkül próbálhatja ki a szöveges példákkal összekapcsolt entitásokat, valamint a regisztrációkor a saját adatait. További információt a Language Studio webhelyén vagy a Language Studio rövid útmutatójában talál. |
| REST API vagy ügyfélkódtár (Azure SDK) | Integrálhatja az elnevezett entitásfelismerést az alkalmazásokba a REST API vagy a különböző nyelveken elérhető ügyfélkódtár használatával. További információkért tekintse meg a nevesített entitásfelismerési rövid útmutatót. |
Az adatok feldolgozásának meghatározása (nem kötelező)
Beviteli nyelvek
Amikor feldolgozandó dokumentumokat küld be, megadhatja, hogy mely támogatott nyelvekbe vannak beírva. Ha nem ad meg nyelvet, a kulcskifejezések kinyerése alapértelmezés szerint angol lesz. Az API a válaszban eltolásokat adhat vissza a különböző többnyelvű és emoji kódolások támogatása érdekében.
Adatok beküldése
Az elemzés a kérelem megkapásakor történik meg. A NER-funkció szinkron használata állapot nélküli. A rendszer nem tárol adatokat a fiókjában, és az eredményeket a rendszer azonnal visszaadja a válaszban.
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.
Az API megpróbálja észlelni egy adott dokumentumnyelv definiált entitáskategóriáit .
NER-eredmények lekérése
Amikor eredményeket kap a NER-től, streamelheti az eredményeket egy alkalmazásba, vagy mentheti a kimenetet egy fájlba a helyi rendszeren. Az API-válasz magában foglalja a felismert entitásokat, köztük a kategóriákat és alkategóriákat, valamint a megbízhatósági pontszámokat.
Válassza ki a visszaadni kívánt entitásokat (csak előzetes verziójú API)
Az API 2023-04-15-ös előzetes verziójától kezdve az API megpróbálja észlelni egy adott dokumentumnyelv definiált entitástípusait és címkéit. Az entitástípusok és -címkék a korábbi modellek által használt kategóriákat és alkategóriákat helyettesítik az entitások rugalmasabb definiálásához. Megadhatja azt is, hogy mely entitásokat észleli és adja vissza, használja a választható includeList és excludeList a paramétereket a megfelelő entitástípusokkal. Az alábbi példa csak Locationa következőt észleli. Megadhat egy vagy több visszaadandó entitástípust . Az ebben a verzióban bevezetett típusok és címkék hierarchiája miatt rugalmasan szűrhet a különböző részletességi szintekre a következőképpen:
Bemenet:
Megjegyzés:
Ebben a példában csak a Hely entitástípust adja vissza.
{
"kind": "EntityRecognition",
"parameters":
{
"includeList" :
[
"Location"
]
},
"analysisInput":
{
"documents":
[
{
"id":"1",
"language": "en",
"text": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is John Doe) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!"
}
]
}
}
A fenti példák olyan Location entitástípus alá tartozó entitásokat adnának vissza, mint például a GPE, Structural, és Geological címkézett entitások az entitástípusok és címkék szerint. A visszaadott entitásokat úgy is szűrhetjük tovább, hogy az entitástípus egyik entitáscímkéjét Location használjuk, például csak a tagolást szűrjük a GPE körvonalak szerint:
"parameters":
{
"includeList" :
[
"GPE"
]
}
Ez a metódus minden Location olyan entitást ad vissza, amely csak a GPE címke alá tartozik, és figyelmen kívül hagy minden olyan entitást, amely más entitáscímkével, például Structural címkézett Geological entitásokkal címkézett Location típus alá Location tartozik. Az eredmények további részletezése a paraméter használatával excludeList is lehetséges. GPE A címkézett entitások a következő címkékkel címkézhetők: City, State, CountryRegion, Continent. Például kizárhatjuk és CountryRegion címkézhetjük Continent a példánkat:
"parameters":
{
"includeList" :
[
"GPE"
],
"excludeList": :
[
"Continent",
"CountryRegion"
]
}
Ezen paraméterek használatával csak Location az entitástípusokra tudunk sikeresen szűrni, mivel a GPEincludeList paraméterben szereplő entitáscímke a Location típus alá tartozik. Ezután csak geopolitikai entitásokra szűrünk, és kizárjuk a címkével vagy CountryRegion címkével Continent ellátott entitásokat.
A NER-modell megadása
Ez a funkció alapértelmezés szerint a legújabb elérhető AI-modellt használja a szövegen. Az API-kéréseket egy adott modellverzió használatára is konfigurálhatja.
Szolgáltatási és adatkorlátok
A percenként és másodpercenként küldhető kérelmek méretével és számával kapcsolatos információkért tekintse meg a szolgáltatáskorlátokról szóló cikket.