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

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à usa il modello di intelligenza artificiale disponibile più recente 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 tenta di rilevare tutte le categorie di entità definite per un determinato input di conversazione. Se si desidera specificare quali entità vengono rilevate e restituite, usare il parametro facoltativo piiCategories con le categorie di entità appropriate.

Per le trascrizioni parlate, le entità rilevate vengono restituite sul valore del redactionSource 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 della trascrizione parlata, questa API fornisce anche informazioni sulla tempistica audio per consentire la ridistribuzione 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 include entità riconosciute, incluse le relative categorie e sottocategorie e punteggi di attendibilità. Viene restituita anche la stringa di testo con le entità PII elaborate.

Esempi

Librerie client (Azure SDK)

1. Passare alla pagina di panoramica della risorsa nel portale di Azure

2. Dal menu a sinistra selezionare Chiavi ed endpoint. Per autenticare le richieste API, è necessaria una delle chiavi e l'endpoint.

3. Scaricare e installare il pacchetto della libreria client per la lingua preferita:

   Lingua	Versione pacchetto
   .NET	1.0.0
   Python	1.0.0

4. Per altre informazioni sul client e l’oggetto di ritorno, vedere la documentazione di riferimento seguente:

   • C#
   • Python

REST API

Criteri di rollforward (solo versione 2024-11-15-preview)

Nella versione 2024-11-15-preview è possibile definire il redactionPolicy parametro in modo da riflettere i criteri di redazione da usare quando si scrive il documento nella risposta. Il campo criteri supporta 3 tipi di criteri:

• noMask
• characterMask (predefinito)
• entityMask

Il noMask criterio consente all'utente di restituire la risposta senza il redactedText campo .

Il characterMask criterio consente di redactedText mascherare con un carattere, mantenendo la lunghezza e l'offset del testo originale. Si tratta del comportamento esistente.

È anche disponibile un campo facoltativo denominato redactionCharacter in cui è possibile immettere il carattere da usare in fase di rollforward se si usano i characterMask criteri

Il entityMask criterio consente di mascherare il testo dell'entità PII rilevata con il tipo di entità rilevato

Usare l'esempio seguente se si desidera modificare i criteri di rollforward.

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": "1", 
                        "text": "Good morning." 
                    }, 
                    { 
                        "participantId": "agent_1", 
                        "id": "2", 
                        "text": "Can I have your name?" 
                    }, 
                    { 
                        "participantId": "customer_1", 
                        "id": "3", 
                        "text": "Sure that is John Doe." 
                    } 
                ] 
            } 
        ] 
    }, 
    "tasks": [ 
        { 
            "taskName": "analyze 1", 
            "kind": "ConversationalPIITask", 
            "parameters": { 
                "modelVersion": "2023-04-15-preview", 
                “redactionCharacter” 
                "redactionPolicy": { 
                    "policyKind": "characterMask", 
                    //characterMask|entityMask|noMask 
                    "redactionCharacter": "*" 
                } 
            } 
        } 
    ] 
} 
`

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 sembra 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.