Erkennen und Redigieren personenbezogener Informationen (PII) in Unterhaltungen

Artikel
11/19/2024

Das Gesprächs-PII-Feature kann Unterhaltungen auswerten, um vertrauliche Informationen (PII) aus den Inhalten in mehrere vordefinierte Kategorien zu extrahieren und sie zu redigieren. Diese API funktioniert sowohl für transkribierten Text, auf den in Form von Transkripten verwiesen wird, als auch für Chats. Für Transkripte ermöglicht die API auch das Redigieren von Audiosegmenten, die PII enthalten, indem sie die Informationen zur Dauer dieser Audiosegmente bereitstellen.

Festlegen der Art der Datenverarbeitung (optional)

Angeben des PII-Erkennungsmodells

Standardmäßig verwendet dieses Feature das neueste verfügbare KI-Modell für Ihre Eingabe. Sie können Ihre API-Anforderungen auch für die Verwendung einer bestimmten Modellversion konfigurieren.

Sprachunterstützung

Weitere Details finden Sie auf der Seite zur PII-Sprachunterstützung. Derzeit unterstützt das allgemein verfügbare PII-Modell für Konversationen nur die englische Sprache. Das Vorschaumodell und die API unterstützen die gleichen Listensprachen wie die anderen Sprachdienste.

Unterstützung für Regionen

Die PII-API für Konversationen unterstützt alle Azure-Regionen, die vom Sprachdienst unterstützt werden.

Übermitteln der Daten

Hinweis

Informationen zum Formatieren von Konversationstext, der mit Language Studio übermittelt werden soll, finden Sie im Artikel zu Language Studio.

Sie können die Eingabe als Liste von Unterhaltungselementen an die API übermitteln. Die Analyse erfolgt, wenn die Anforderung eingeht. Da es sich um eine asynchrone API handelt, kann es zu einer Verzögerung zwischen dem Senden einer API-Anforderung und dem Erhalt der Ergebnisse kommen. Informationen zur Größe und Anzahl von Anforderungen, die Sie pro Minute und Sekunde senden können, finden Sie in den nachstehend aufgeführten Datengrenzwerten.

Wenn Sie das asynchrone Feature verwenden, sind die API-Ergebnisse ab Erfassen der Anforderung wie in der Antwort angegeben 24 Stunden lang verfügbar. Nach diesem Zeitraum werden die Ergebnisse endgültig gelöscht und stehen nicht mehr zum Abruf zur Verfügung.

Wenn Sie Daten an die Unterhaltungs-PII übermitteln, kann eine Unterhaltung (Chat oder gesprochen) pro Anforderung gesendet werden.

Die API versucht, alle definierten Entitätskategorien für eine bestimmte Unterhaltungseingabe zu erkennen. Wenn Sie angeben möchten, welche Entitäten erkannt und zurückgegeben werden sollen, verwenden Sie den optionalen Parameter piiCategories mit den entsprechenden Entitätskategorien.

Bei gesprochenen Transkripten werden die erkannten Entitäten im angegebenen redactionSource-Parameterwert zurückgegeben. Derzeit lauten die für redactionSource unterstützten Werte text, lexical, itn und maskedItn (die den Formaten display\displayText, lexical, itn und maskedItn der Spracherkennungs-REST-API entsprechen). Darüber hinaus stellt diese API für die gesprochene Transkripteingabe auch Informationen zur Audiodauer bereit, um das Maskieren von Audios zu ermöglichen. Verwenden Sie das optionale includeAudioRedaction-Flag mit dem Wert true, um das Feature „audioRedaction“ zu nutzen. Das Redigieren des Audios wird auf der Basis des lexikalischen Eingabeformats durchgeführt.

Hinweis

Unterhaltung mit personenbezogenen Informationen unterstützt jetzt 40.000 Zeichen als Dokumentgröße.

Abrufen von PII-Ergebnissen

Wenn Sie Ergebnisse von der PII-Erkennung erhalten, können Sie diese an eine App streamen oder die Ausgabe in einer Datei im lokalen System speichern. Die API-Antwort enthält erkannte Entitäten, einschließlich ihrer Kategorien und Unterkategorien sowie Konfidenzbewertungen. Die Textzeichenfolge mit den maskierten PII-Entitäten wird ebenfalls zurückgegeben.

Navigieren Sie im Azure-Portal zur Übersichtsseite Ihrer Ressource.
Wählen Sie im Menü auf der linken Seite Schlüssel und Endpunkt aus. Sie benötigen einen der Schlüssel und den Endpunkt, um Ihre API-Anforderungen zu authentifizieren.
Laden Sie das Clientbibliothekspaket für die Sprache Ihrer Wahl herunter, und installieren Sie es:

Sprache Paketversion

.NET 1.0.0

Python 1.0.0
Weitere Informationen zum Client und zum Rückgabeobjekt finden Sie in der folgenden Referenzdokumentation:
- C#
- Python

Sprache	Paketversion
.NET	1.0.0
Python	1.0.0

Maskierungsrichtlinie (nur Version 2024-11-15-preview)

Bei der Version 2024-11-15-preview können Sie den redactionPolicy-Parameter definieren, um die Maskierungsrichtlinie widerzuspiegeln, die bei der Maskierung des Dokuments in der Antwort verwendet werden soll. Das Richtlinienfeld unterstützt drei Richtlinientypen:

noMask
characterMask (Standard)
entityMask

Mit der noMask-Richtlinie kann der Benutzer die Antwort ohne das Feld redactedText zurückgeben.

Mit der characterMask-Richtlinie kann redactedText mit einem Zeichen maskiert werden, wobei die Länge und das Offset des ursprünglichen Texts beibehalten werden. Dies ist das vorhandene Verhalten.

Es gibt auch ein optionales Feld namens redactionCharacter, in dem Sie das Zeichen eingeben können, das für die Maskierung verwendet werden soll, wenn Sie die characterMask-Richtlinie verwenden

Mit der entityMask-Richtlinie können Sie den erkannten Text der PII-Entität mit dem erkannten Entitätstyp maskieren

Verwenden Sie das folgende Beispiel, wenn Sie die Maskierungsrichtlinie ändern möchten.

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

Übermitteln von Transkripten mithilfe von Spracherkennung

Verwenden Sie das folgende Beispiel, wenn Sie Unterhaltungen mit dem Spracherkennungs-Feature von Speech transkribiert haben:

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

Senden von Textchats

Verwenden Sie das folgende Beispiel, wenn Sie über Unterhaltungen verfügen, die aus Text stammen. Dabei kann es sich beispielsweise um Unterhaltungen über einen textbasierten Chatclient handeln.

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

Abrufen des Ergebnisses

Rufen Sie operation-location aus dem Antwortheader ab. Der Wert ähnelt der folgenden URL:

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

Verwenden Sie den folgenden cURL-Befehl, um die Ergebnisse der Anforderung abzurufen. Ersetzen Sie my-job-id durch den numerischen ID-Wert, den Sie aus dem vorherigen operation-location-Antwortheader erhalten haben:

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"

Grenzwerte für Dienste und Daten

Informationen zur Größe und Anzahl der Anforderungen, die Sie pro Minute und pro Sekunde senden können, finden Sie im Artikel Diensteinschränkungen.

Freigeben über