Come rilevare e correggere le informazioni personali (PII) nelle conversazioni

Articolo
10/16/2024

La funzionalità PII conversazionali può valutare le conversazioni per estrarre informazioni riservate (PII) dei contenuti di diverse categorie predefinite e offuscarle. Questa API opera su testo trascritto, a cui si fa riferimento come trascrizioni, e chat. Per le trascrizioni, l'API consente anche di offuscare i segmenti audio, i quali contengono le informazioni personali, fornendo le informazioni sulla tempistica dell'audio per tali segmenti.

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 nell'input. È anche possibile configurare le richieste API per l'uso di una versione del modello specifica.

Supporto di versioni in lingue diverse

Per altri dettagli, vedere la pagina Supporto linguistico delle informazioni personali. Attualmente, il modello disponibilità generale delle informazioni personali di conversazione supporta solo la lingua inglese. Il modello di anteprima e l'API supportano le stesse lingue di elenco degli altri servizi linguistici.

Supporto di area

L'API delle informazioni personali di conversazione supporta tutte le aree di Azure supportate dal servizio di linguaggio.

Invio di dati

Nota

Per informazioni sulla formattazione del testo della conversazione da inviare tramite Language Studio, vedere l'articolo Language Studio.

È possibile inviare l'input all'API come elenco di elementi di conversazione. Al momento della ricezione della richiesta viene eseguita l'analisi. Poiché l'API è asincrona, potrebbe verificarsi un ritardo tra l'invio di una richiesta API e la ricezione dei risultati. Per informazioni sulle dimensioni e sul numero di richieste che è possibile inviare al minuto e al secondo, vedere i limiti dei dati riportati di seguito.

Quando si usa la funzionalità asincrona, i risultati dell'API sono disponibili per 24 ore dal momento in cui la richiesta è stata inserita e viene indicata nella risposta. Dopo questo periodo di tempo, i risultati vengono rimossi e non sono più disponibili per il recupero.

Quando si inviano dati alle informazioni personali di conversazione, è possibile inviare una conversazione (chat o parlato) per ciascuna richiesta.

L'API tenterà di rilevare tutte le categorie di entità definite per un determinato input di conversazione. Se si desidera specificare quali entità verranno rilevate e restituite, usare il parametro facoltativo piiCategories con le categorie di entità appropriate.

Per le trascrizioni del parlato, le entità rilevate verranno restituite sul valore redactionSource del parametro specificato. Attualmente, i valori supportati per redactionSource sono text, lexical, itn e maskedItn, che corrispondono rispettivamente ai formati display\displayText, lexical, itn e maskedItn dell'API REST Riconoscimento vocale. Inoltre, per l'input di trascrizione del parlato, questa API fornirà anche informazioni sulla tempistica audio per consentire l'offuscamento audio. Per usare la funzionalità audioRedaction, utilizzare il flag facoltativo includeAudioRedaction con il valore true. L'offuscamento audio viene eseguito in base al formato di input lessicale.

Nota

Le informazioni personali di conversazione supportano ora 40.000 caratteri come dimensioni del documento.

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.

Passare alla pagina di panoramica della risorsa nel portale di Azure
Dal menu a sinistra selezionare Chiavi ed endpoint. Per autenticare le richieste API, è necessaria una delle chiavi e l'endpoint.
Scaricare e installare il pacchetto della libreria client per la lingua preferita:

Lingua Versione pacchetto

.NET 1.0.0

Python 1.0.0
Per altre informazioni sul client e l’oggetto di ritorno, vedere la documentazione di riferimento seguente:
- C#
- Python

Lingua	Versione pacchetto
.NET	1.0.0
Python	1.0.0

Inviare trascrizioni usando il riconoscimento vocale

Utilizzare il seguente esempio se sono presenti conversazioni trascritte mediante la funzionalità riconoscimento vocale del servizio Riconoscimento vocale:

curl -i -X POST https://your-language-endpoint-here/language/analyze-conversations/jobs?api-version=2024-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: your-key-here" \
-d \
' 
{
    "displayName": "Analyze conversations from xxx",
    "analysisInput": {
        "conversations": [
            {
                "id": "23611680-c4eb-4705-adef-4aa1c17507b5",
                "language": "en",
                "modality": "transcript",
                "conversationItems": [
                    {
                        "participantId": "agent_1",
                        "id": "8074caf7-97e8-4492-ace3-d284821adacd",
                        "text": "Good morning.",
                        "lexical": "good morning",
                        "itn": "good morning",
                        "maskedItn": "good morning",
                        "audioTimings": [
                            {
                                "word": "good",
                                "offset": 11700000,
                                "duration": 2100000
                            },
                            {
                                "word": "morning",
                                "offset": 13900000,
                                "duration": 3100000
                            }
                        ]
                    },
                    {
                        "participantId": "agent_1",
                        "id": "0d67d52b-693f-4e34-9881-754a14eec887",
                        "text": "Can I have your name?",
                        "lexical": "can i have your name",
                        "itn": "can i have your name",
                        "maskedItn": "can i have your name",
                        "audioTimings": [
                            {
                                "word": "can",
                                "offset": 44200000,
                                "duration": 2200000
                            },
                            {
                                "word": "i",
                                "offset": 46500000,
                                "duration": 800000
                            },
                            {
                                "word": "have",
                                "offset": 47400000,
                                "duration": 1500000
                            },
                            {
                                "word": "your",
                                "offset": 49000000,
                                "duration": 1500000
                            },
                            {
                                "word": "name",
                                "offset": 50600000,
                                "duration": 2100000
                            }
                        ]
                    },
                    {
                        "participantId": "customer_1",
                        "id": "08684a7a-5433-4658-a3f1-c6114fcfed51",
                        "text": "Sure that is John Doe.",
                        "lexical": "sure that is john doe",
                        "itn": "sure that is john doe",
                        "maskedItn": "sure that is john doe",
                        "audioTimings": [
                            {
                                "word": "sure",
                                "offset": 5400000,
                                "duration": 6300000
                            },
                            {
                                "word": "that",
                                "offset": 13600000,
                                "duration": 2300000
                            },
                            {
                                "word": "is",
                                "offset": 16000000,
                                "duration": 1300000
                            },
                            {
                                "word": "john",
                                "offset": 17400000,
                                "duration": 2500000
                            },
                            {
                                "word": "doe",
                                "offset": 20000000,
                                "duration": 2700000
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "tasks": [
        {
            "taskName": "analyze 1",
            "kind": "ConversationalPIITask",
            "parameters": {
                "modelVersion": "2023-04-15-preview",
                "redactionSource": "text",
                "includeAudioRedaction": true,
                "piiCategories": [
                    "all"
                ]
            }
        }
    ]
}
`

Inviare chat di testo

Usare l'esempio seguente se sono presenti conversazioni che hanno avuto origine nel testo. Ad esempio, conversazioni tramite un client di chat basato su testo.

curl -i -X POST https://your-language-endpoint-here/language/analyze-conversations/jobs?api-version=2024-05-01 \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: your-key-here" \
-d \
' 
{
    "displayName": "Analyze conversations from xxx",
    "analysisInput": {
        "conversations": [
            {
                "id": "23611680-c4eb-4705-adef-4aa1c17507b5",
                "language": "en",
                "modality": "text",
                "conversationItems": [
                    {
                        "participantId": "agent_1",
                        "id": "8074caf7-97e8-4492-ace3-d284821adacd",
                        "text": "Good morning."
                    },
                    {
                        "participantId": "agent_1",
                        "id": "0d67d52b-693f-4e34-9881-754a14eec887",
                        "text": "Can I have your name?"
                    },
                    {
                        "participantId": "customer_1",
                        "id": "08684a7a-5433-4658-a3f1-c6114fcfed51",
                        "text": "Sure that is John Doe."
                    }
                ]
            }
        ]
    },
    "tasks": [
        {
            "taskName": "analyze 1",
            "kind": "ConversationalPIITask",
            "parameters": {
                "modelVersion": "2023-04-15-preview"
            }
        }
    ]
}
`

Ottenere il risultato

Ottenere operation-location dall'intestazione della risposta. Il valore sarà simile all'URL seguente:

https://your-language-endpoint/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678

Per ottenere i risultati della richiesta, usare il comando cURL seguente. Assicurarsi di sostituire my-job-id con il valore ID numerico ricevuto dall'intestazione della risposta operation-location precedente:

curl -X GET    https://your-language-endpoint/language/analyze-conversations/jobs/my-job-id \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: your-key-here"

Limiti relativi al servizio e ai 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.

Condividi tramite