Come rilevare e ridistribuire le informazioni personali nelle conversazioni

La funzionalità piI conversazione può valutare le conversazioni per estrarre informazioni riservate (PII) nel contenuto in diverse categorie pre-definite e redarne le operazioni. Questa API opera su testo trascritto (a cui si fa riferimento come trascrizioni) e chat. Per le trascrizioni, l'API abilita anche la ridistribuzione di segmenti audio, che contiene le informazioni sulle informazioni di pii utente fornendo le informazioni sulla tempistica audio per tali segmenti audio.

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.

Lingue supportate

Attualmente l'API di anteprima dell'istanza di conversazione supporta solo la lingua inglese.

Supporto di area

Attualmente l'API di anteprima delle informazioni personali conversazionali supporta tutte le aree di Azure supportate dal servizio Language.

Invio di dati

Nota

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

È 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 seguenti.

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 indicato nella risposta. Dopo questo periodo di tempo, i risultati vengono eliminati e non sono più disponibili per il recupero.

Quando si inviano i dati alle informazioni personali conversazionali, è possibile inviare una conversazione (chat o parlato) per ogni 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 parlate, le entità rilevate verranno restituite sul valore del redactionSource parametro specificato. Attualmente, i valori supportati per sono , , e (che esegue il mapping rispettivamente all'APIdisplayTextlexicaldisplay\itn REST del testo , e maskedItnmaskedItn al formato ). itnlexicaltextredactionSource Inoltre, per l'input della trascrizione parlato, questa API fornirà anche informazioni sulla tempistica audio per consentire la ridistribuzione audio. Per usare la funzionalità audioRedaction, usare il flag facoltativo includeAudioRedaction con true il valore. La ridistribuzione audio viene eseguita in base al formato di input lessicale.

Nota

L'interfaccia utente della conversazione supporta ora 40.000 caratteri come dimensione del documento.

Ottenere i risultati dell'interfaccia utente

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 categorie e le sottocategorie e i punteggi di attendibilità. Verrà restituita anche la stringa di testo con le entità PII redacted.

Esempio

Librerie client (Azure SDK)

1. Passare alla pagina di panoramica delle risorse nella portale di Azure

2. Dal menu a sinistra selezionare Chiavi ed Endpoint. È necessario uno dei tasti e l'endpoint per autenticare le richieste API.

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

   Linguaggio	Versione pacchetto
   .NET	1.0.0
   Python	1.0.0

4. Per altre informazioni sul client e sull'oggetto restituito, vedere la documentazione di riferimento seguente:

   • C#
   • Python

REST API

Inviare trascrizioni usando la voce al testo

Usare l'esempio seguente se si hanno conversazioni trascritte usando la funzionalità voce del servizio Voce per il testo :

curl -i -X POST https://your-language-endpoint-here/language/analyze-conversations/jobs?api-version=2022-05-15-preview \
-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": "2022-05-15-preview",
                "redactionSource": "text",
                "includeAudioRedaction": true,
                "piiCategories": [
                    "all"
                ]
            }
        }
    ]
}
`

Inviare chat di testo

Usare l'esempio seguente se si hanno conversazioni che hanno origine nel testo. Ad esempio, le conversazioni tramite un client chat basato su testo.

curl -i -X POST https://your-language-endpoint-here/language/analyze-conversations/jobs?api-version=2022-05-15-preview \
-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": "2022-05-15-preview"
            }
        }
    ]
}
`

Ottenere il risultato

Ottenere l'oggetto operation-location dall'intestazione di 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 di risposta precedente operation-location :

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 di servizio e dati

Per informazioni sulle dimensioni e sul numero di richieste che è possibile inviare al minuto e al secondo, vedere l'articolo limiti del servizio .