Come rilevare e correggere le informazioni identificative personali (PII)
La funzionalità PII può valutare testo non strutturato, estrarre e redigere informazioni sensibili (PII) e informazioni sulla salute (PHI) nel testo in diverse categorie predefinite.
Opzioni di sviluppo
Per usare il rilevamento delle informazioni personali, inviare testo non strutturato e non elaborato per l'analisi e gestire l'output dell'API nell'applicazione. L'analisi viene eseguita così come è, senza alcuna personalizzazione del modello usato nei dati. Esistono due modi per usare il rilevamento delle informazioni personali:
| Opzione di sviluppo | Descrizione |
|---|---|
| Language Studio | Language Studio è una piattaforma basata sul Web che consente di provare a collegare entità con esempi di testo senza un account Azure e usando i propri dati quando si effettua l'iscrizione. Per altre informazioni, vedere il sito Web di Language Studio o la guida introduttiva di Language Studio. |
| API REST o libreria client (SDK di Azure) | Integrare il rilevamento delle informazioni personali nelle applicazioni usando l'API REST o la libreria client disponibile in varie lingue. Per altre informazioni, vedere la guida introduttiva al rilevamento delle informazioni personali. |
Determinare come elaborare i dati (facoltativo)
Specificare il modello di rilevamento delle informazioni personali
Per impostazione predefinita, questa funzionalità userà il modello di intelligenza artificiale più recente disponibile nel testo. È anche possibile configurare le richieste API per l'uso di una versione del modello specifica.
Lingue di input
Quando si inviano documenti da elaborare, è possibile specificare le lingue supportate in cui sono scritti. Se non si specifica una lingua, per impostazione predefinita l'estrazione verrà impostata sull'inglese. L'API può restituire offset nella risposta per supportare diverse codifiche multilingue ed emoji.
Invio di dati
Al momento della ricezione della richiesta viene eseguita l'analisi. L'uso della funzionalità di rilevamento delle informazioni personali in modo sincrono è senza stato. Non vengono archiviati dati nell'account e i risultati vengono restituiti immediatamente nella risposta.
Quando si usa questa funzionalità in modo asincrono, i risultati dell'API sono disponibili per 24 ore dal momento in cui la richiesta è stata inserita e ciò viene indicato nella risposta. Dopo questo periodo di tempo, i risultati vengono rimossi e non sono più disponibili per il recupero.
Selezionare le entità da restituire
L'API tenterà di rilevare le categorie di entità definite per una determinata lingua del documento. Se si desidera specificare quali entità verranno rilevate e restituite, usare il parametro facoltativo piiCategories con le categorie di entità appropriate. Questo parametro può anche consentire di rilevare le entità non abilitate per impostazione predefinita per la lingua del documento. Nell'esempio seguente viene rilevato solo Person. È possibile specificare uno o più tipi di entità da restituire.
Suggerimento
Senza immettere default quando si specificano l e categorie di entità, l'API restituirà solo le categorie di entità specificate.
Input:
Nota
In questo esempio, restituirà solo il tipo di entità persona:
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!"
}
]
}
}
Output:
{
"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"
}
}
Ottenere i risultati delle informazioni personali
Quando si ottengono risultati dal rilevamento delle informazioni personali, è possibile trasmettere i risultati a un'applicazione o salvare l'output in un file nel sistema locale. La risposta API includerà entità riconosciute, incluse le relative categorie e sottocategorie, e punteggi di attendibilità. Verrà restituita anche la stringa di testo con le entità PII elaborate.
Limiti relativi a servizi e dati
Vedere l'articolo sui limiti del servizio per informazioni sulle dimensioni e il numero di richieste che è possibile inviare al minuto e al secondo.