Személyazonosítási információk (PII) észlelése és újbóli megadása
A PII-funkció számos előre definiált kategóriában képes kiértékelni a strukturálatlan szöveget, kinyerni és újraközölni a bizalmas információkat (PII) és az állapotinformációkat (PHI).
Fejlesztési lehetőségek
A PII-észlelés használatához szöveget kell küldenie az 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 testreszabása nélkül. A PII-észlelé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álja a PII-észlelé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 PII-észlelési rövid útmutatót. |
Az adatok feldolgozásának meghatározása (nem kötelező)
A PII-észlelési modell megadása
Ez a funkció alapértelmezés szerint a legújabb elérhető AI-modellt fogja használni a szövegen. Az API-kéréseket egy adott modellverzió használatára is konfigurálhatja.
Beviteli nyelvek
Amikor feldolgozandó dokumentumokat küld be, megadhatja, hogy a támogatott nyelvek közül melyikben vannak megírva. ha nem ad meg nyelvet, a kinyerés 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 PII-észlelési 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.
Válassza ki a visszaadni kívánt entitásokat
Az API megkísérli észlelni egy adott dokumentumnyelv definiált entitáskategóriáit . Ha meg szeretné adni, hogy mely entitásokat észleli és adja vissza, használja az opcionális piiCategories paramétert a megfelelő entitáskategóriákkal. Ez a paraméter lehetővé teszi az olyan entitások észlelését is, amelyek alapértelmezés szerint nem engedélyezettek a dokumentum nyelvéhez. Az alábbi példa csak Persona következőt észleli. Megadhat egy vagy több visszaadandó entitástípust .
Tipp.
Ha nem adja meg default az entitáskategóriákat, az API csak a megadott entitáskategóriákat adja vissza.
Bemenet:
Feljegyzés
Ebben a példában csak a személy entitástípusát adja vissza:
https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01
{
"kind": "PiiEntityRecognition",
"parameters":
{
"modelVersion": "latest",
"piiCategories" :
[
"Person"
]
},
"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!"
}
]
}
}
Kimeneti:
{
"kind": "PiiEntityRecognitionResults",
"results": {
"documents": [
{
"redactedText": "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 ********) 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!",
"id": "1",
"entities": [
{
"text": "John Doe",
"category": "Person",
"offset": 226,
"length": 8,
"confidenceScore": 0.98
}
],
"warnings": []
}
],
"errors": [],
"modelVersion": "2021-01-15"
}
}
PII-eredmények lekérése
A PII-észlelés eredményeinek lekérése után 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. A rendszer a PII-entitásokat tartalmazó szöveges sztringet is visszaadja.
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.