Comment détecter et masquer les informations d’identification personnelle (PII) dans les conversations

La fonctionnalité PII conversationnelle peut évaluer les conversations pour extraire des informations sensibles (PII) dans le contenu dans plusieurs catégories prédéfinies et les masquer. Cette API fonctionne sur le texte transcrit (référencé en tant que transcriptions) et les conversations. Pour les transcriptions, l’API permet également la réaction des segments audio, qui contient les informations de piI en fournissant les informations de minutage audio pour ces segments audio.

Déterminer le mode de traitement des données (facultatif)

Spécifier le modèle de détection des informations d’identification personnelle

Par défaut, cette fonctionnalité utilise le dernier modèle IA disponible sur votre entrée. Vous pouvez également configurer vos requêtes d’API pour utiliser une version de modèle spécifique.

Support multilingue

Pour découvrir plus de détails, consultez la page Prise en charge des langages pour la détection des informations d’identification personnelle. Actuellement, le modèle en disponibilité générale des informations d’identification personnelle (PII) conversationnelles prend uniquement en charge la langue anglaise. L’API et le modèle en préversion prennent en charge la même liste de langues que les autres services Langue.

Prise en charge de la région

L’API des informations d’identification personnelle conversationnelles prend en charge toutes les régions Azure prises en charge par le service Langue.

Envoi de données

Remarque

Consultez l’article Language Studio pour plus d’informations sur la mise en forme du texte conversationnel à envoyer à l’aide de Language Studio.

Vous pouvez soumettre l’entrée à l’API en tant que liste d’éléments de conversation. L’analyse est effectuée à la réception de la demande. Étant donné que l’API est asynchrone, il peut y avoir un délai entre l’envoi d’une demande d’API et la réception des résultats. Pour connaître la taille et le nombre de requêtes que vous pouvez envoyer par minute et seconde, consultez les limites de données ci-dessous.

Lorsque vous utilisez la fonctionnalité asynchrone, les résultats de l’API sont disponibles pendant 24 heures à partir du moment où la demande a été ingérée, et sont indiqués dans la réponse. Après cette période, les résultats sont purgés et ne sont plus disponibles pour récupération.

Lorsque vous envoyez des données à des informations personnelles conversationnelles, vous pouvez envoyer une conversation (écrite ou parlée) par demande.

L’API tente de détecter toutes les catégories d’entités définies pour une entrée de conversation donnée. Si vous souhaitez spécifier les entités détectées et retournées, utilisez le paramètre piiCategories facultatif avec les catégories d’entités appropriées.

Pour les transcriptions parlées, les entités détectées sont retournées sur la valeur redactionSource de paramètre fournie. Actuellement, les valeurs prises en charge pour redactionSource sont text, lexical, itn et maskedItn (qui mappe aux formats d’API REST de reconnaissance vocale display\displayText, lexical, itn et maskedItn respectivement). En outre, pour l’entrée de transcription parlée, cette API fournit également des informations de minutage audio pour permettre la rédaction audio. Pour utiliser la fonctionnalité audioRedaction, utilisez l’indicateur facultatif includeAudioRedaction avec la valeur true. La réaction audio est effectuée en fonction du format d’entrée lexical.

Remarque

Les informations d’identification personnelle de conversation prennent désormais en charge une taille de document de 40 000 caractères.

Obtention des résultats sur les informations d’identification personnelle

Lorsque vous recevez des résultats de la détection des informations d’identification personnelle, vous pouvez diffuser les résultats dans une application ou enregistrer la sortie dans un fichier sur le système local. La réponse de l’API inclut entités reconnues, y compris leurs catégories et sous-catégories, et les scores de confiance. La chaîne de texte avec les entités d’identification personnelle est également retournée.

Exemples

Bibliothèques clientes (SDK Azure)

1. Accédez à la page de vue d’ensemble de votre ressource dans le portail Azure

2. Dans le menu de gauche, sélectionnez Clés et point de terminaison. Vous aurez besoin de l’une des clés et du point de terminaison pour authentifier vos demandes d’API.

3. Téléchargez et installez le package de bibliothèque de clients pour le langage de votre choix :

   Langage	Version du package
   .NET	1.0.0
   Python	1.0.0

4. Consultez la documentation de référence suivante pour plus d’informations sur le client et l’objet retourné :

   • C#
   • Python

REST API

Stratégie de rédaction (version 2024-11-15-preview uniquement)

Dans la version 2024-15-11-preview, vous pouvez définir le paramètre redactionPolicy pour refléter la stratégie de rédaction à utiliser lors de la rédaction du document dans la réponse. Le champ de stratégie prend en charge 3 types de stratégies :

• noMask
• characterMask (valeur par défaut)
• entityMask

La stratégie noMask permet à l’utilisateur de retourner la réponse sans le champ redactedText.

La stratégie characterMask permet au redactedText d’être masqué avec un caractère, en conservant la longueur et le décalage du texte d’origine. Il s’agit du comportement existant.

Il existe également un champ facultatif appelé redactionCharacter où vous pouvez entrer le caractère à utiliser dans la rédaction si vous utilisez la stratégie de characterMask

La stratégie entityMask vous permet de masquer le texte de l’entité PII détectée avec le type d’entité détecté

Utilisez l’exemple suivant si vous souhaitez modifier la stratégie de rédaction.

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": "*" 
                } 
            } 
        } 
    ] 
} 
`

Envoyer des transcriptions à l’aide de la reconnaissance vocale

Utilisez l’exemple suivant si vous avez des conversations transcrites à l’aide de la fonctionnalité reconnaissance vocale du service Speech :

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"
                ]
            }
        }
    ]
}
`

Envoyer des conversations texte

Utilisez l’exemple suivant si vous avez des conversations qui proviennent du texte. Par exemple, les conversations via un client de conversation texte.

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"
            }
        }
    ]
}
`

Obtenir le résultat

Obtenez l’emplacement de l’opération (operation-location) de l’en-tête de la réponse. La valeur ressemble à l’URL suivante :

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

Pour obtenir les résultats de la requête, utilisez la commande cURL suivante. Veillez à remplacer my-job-id par la valeur d’ID numérique que vous avez reçue de l’en-tête de réponse operation-location précédent :

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"

Limites du service et des données

Pour connaître la taille et le nombre de demandes que vous pouvez envoyer par minute et seconde, consultez l’article Limites de service.