Személyazonosítási információk (PII) észlelése és újbóli megadása beszélgetésekben

A Beszélgetési PII funkció kiértékeli a beszélgetéseket, hogy bizalmas információkat (PII) nyerjen ki a tartalomban több előre meghatározott kategóriából, és újra ki tudja őket terjeszteni. Ez az API átírt szövegeken (átiratként hivatkozva) és csevegéseken is működik. Az átiratok esetében az API lehetővé teszi a hangszegmensek újbóli használatát is, amely tartalmazza a PII-információkat az adott hangszegmensek hangidőzítési információinak megadásával.

Az adatok feldolgozásának meghatározása (nem kötelező)

A PII-észlelési modell megadása

Alapértelmezés szerint ez a funkció a legújabb elérhető AI-modellt fogja használni a bemeneten. Az API-kéréseket konfigurálhatja egy adott modellverzió használatára is.

Nyelvi támogatás

A beszélgetési PII előzetes API jelenleg csak az angol nyelvet támogatja.

Régiós támogatás

A beszélgetési PII előzetes API jelenleg a Language szolgáltatás által támogatott összes Azure-régiót támogatja.

Adatok elküldése

Megjegyzés

A Language Studio cikkből megtudhatja, hogy a Language Studio használatával szeretné-e elküldeni a beszélgetési szöveget.

A bemenetet elküldheti az API-nak beszélgetési elemek listájaként. Az elemzés a kérelem megkapásakor történik meg. Mivel az API aszinkron, előfordulhat, hogy egy API-kérés küldése és az eredmények fogadása között késés tapasztalható. A percenként és másodpercenként küldhető kérelmek méretével és számával kapcsolatos információkért lásd az alábbi adatkorlátokat.

Az aszinkron funkció használatakor az API-eredmények a kérés betöltésétől számítva 24 órán át érhetők el, és a válasz jelzi. Ezt az időtartamot követően az eredmények törlődnek, és már nem érhetők el lekérésre.

Amikor adatokat küld a beszélgetési PII-nek, kérésenként egy beszélgetést (csevegést vagy beszéltet) küldhet.

Az API megpróbálja észlelni az adott beszélgetési bemenet összes definiált entitáskategóriát . Ha meg szeretné adni, hogy mely entitásokat észleli és adja vissza, használja a választható piiCategories paramétert a megfelelő entitáskategóriákkal.

A beszélt átiratok esetében az észlelt entitások a redactionSource megadott paraméterértéken lesznek visszaadva. Jelenleg a támogatott értékek redactionSource a következők: text, lexical, itn, és maskedItn (amelyek a Speech-ra vannak leképezve a szöveg REST API-jának , lexicalés itnmaskedItn formátumának display\displayTextmegfelelően). Emellett a beszélt átirat bemenetéhez ez az API hangidőzítési információkat is biztosít a hang újraeladásának elősegítéséhez. Az audioRedaction funkció használatához használja az opcionális includeAudioRedaction jelzőt értékekkel true . A hang újraírása a lexikális bemeneti formátum alapján történik.

Megjegyzés

A beszélgetési PII mostantól 40 000 karaktert támogat dokumentumméretként.

PII-eredmények lekérése

A PII-észlelés eredményeinek lekérése után streamelheti az eredményeket egy alkalmazásba, vagy mentheti a kimenetet egy fájlba a helyi rendszeren. Az API-válasz tartalmazza a felismert entitásokat, köztük a kategóriákat és alkategóriákat, valamint a megbízhatósági pontszámokat. A rendszer a PII-entitásokat tartalmazó szöveges sztringet is visszaadja.

Példák

Ügyfélkódtárak (Azure SDK)

1. Nyissa meg az erőforrás áttekintési lapját a Azure Portal

2. A bal oldali menüben válassza a Kulcsok és végpont lehetőséget. Az API-kérések hitelesítéséhez szüksége lesz az egyik kulcsra és a végpontra.

3. Töltse le és telepítse az ügyféloldali kódtárcsomagot a választott nyelvhez:

   Nyelv	Csomag verziója
   .NET	1.0.0
   Python	1.0.0

4. Az ügyfélről és a visszatérési objektumról az alábbi referenciadokumentációban talál további információt:

   • C#
   • Python

REST API

Átiratok küldése beszédből szövegbe

Használja az alábbi példát, ha a Speech szolgáltatás beszédfelismerési funkciójával átírt beszélgetéseket használ:

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

Szöveges csevegések küldése

Használja az alábbi példát, ha szövegből származó beszélgetések vannak. Például egy szöveges csevegőügyfélen keresztüli beszélgetések.

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

Az eredmény lekérése

Kérje le a operation-location választ a fejlécből. Az érték a következő URL-címhez hasonlóan fog kinézni:

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

A kérés eredményeinek lekéréséhez használja az alábbi cURL-parancsot. Mindenképpen cserélje le a helyére my-job-id az előző operation-location válaszfejlécből kapott numerikus azonosítót:

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"

Szolgáltatási és adatkorlátok

A percenként és másodpercenként küldhető kérelmek méretével és számával kapcsolatos információkért tekintse meg a szolgáltatáskorlátokról szóló cikket.