Konuşmalarda Kişisel Kimlik Bilgilerini (PII) algılama ve yeniden uygulama

Makale
12/19/2023

Konuşma PII özelliği, önceden tanımlanmış çeşitli kategorilerdeki içerikteki hassas bilgileri (PII) ayıklamak ve bunları yeniden uygulamak için konuşmaları değerlendirebilir. Bu API hem dökümü alınmış metin (transkript olarak başvurulur) hem de sohbetlerde çalışır. Transkriptler için API, bu ses segmentleri için ses zamanlama bilgilerini sağlayarak PII bilgilerini içeren ses segmentlerinin yeniden tadilini de etkinleştirir.

Verilerin nasıl işleneceğini belirleme (isteğe bağlı)

PII algılama modelini belirtme

Varsayılan olarak, bu özellik girişinizde en son kullanılabilir yapay zeka modelini kullanır. API isteklerinizi belirli bir model sürümünü kullanacak şekilde de yapılandırabilirsiniz.

Dil desteği

Şu anda konuşma PII önizleme API'si yalnızca İngilizce dilini destekler.

Bölge desteği

Şu anda konuşma PII önizleme API'si, Dil hizmeti tarafından desteklenen tüm Azure bölgelerini destekler.

Veri gönderme

Not

Language Studio kullanarak göndermek üzere konuşma metnini biçimlendirme hakkında bilgi için Language Studio makalesine bakın.

Girişi API'ye konuşma öğeleri listesi olarak gönderebilirsiniz. İstek alındığında analiz gerçekleştirilir. API zaman uyumsuz olduğundan, API isteği gönderme ve sonuçları alma arasında bir gecikme olabilir. Dakika ve saniye başına gönderebileceğiniz isteklerin boyutu ve sayısı hakkında bilgi için aşağıdaki veri sınırlarına bakın.

Zaman uyumsuz özelliği kullanırken API sonuçları, isteğin alındığı andan itibaren 24 saat boyunca kullanılabilir ve yanıtta belirtilir. Bu sürenin sonunda sonuçlar temizlenir ve artık alınamayacaktır.

Konuşma PII'sine veri gönderdiğinizde, istek başına bir konuşma (sohbet veya konuşulan) gönderebilirsiniz.

API, belirli bir konuşma girişi için tüm tanımlı varlık kategorilerini algılamaya çalışır. Hangi varlıkların algılanıp döndürüleceğini belirtmek istiyorsanız, uygun varlık kategorileriyle isteğe bağlı piiCategories parametresini kullanın.

Konuşulan transkriptler için, algılanan varlıklar sağlanan parametre değerinde döndürülür redactionSource . Şu anda için desteklenen değerler , , ve 'redactionSourcetir text(konuşma ile metin REST API'sinin\displaydisplayText , itnlexicalve maskedItn biçimine eşlenir).maskedItnitnlexical Ayrıca, konuşulan transkript girişi için bu API ses redaksiyonunu güçlendirmek için ses zamanlama bilgileri de sağlar. audioRedaction özelliğini kullanmak için isteğe bağlı includeAudioRedaction bayrağını değerle birlikte true kullanın. Ses redaksiyon, sözcük temelli giriş biçimine göre gerçekleştirilir.

Not

Konuşma PII artık belge boyutu olarak 40.000 karakteri destekliyor.

PII sonuçlarını alma

PII algılamasından sonuç aldığınızda, sonuçları bir uygulamaya akışla aktarabilir veya çıkışı yerel sistemdeki bir dosyaya kaydedebilirsiniz. API yanıtı, kategorileri ve alt kategorileri ile güvenilirlik puanları da dahil olmak üzere tanınan varlıkları içerir. PII varlıklarının yeniden işlendiği metin dizesi de döndürülür.

Azure portal kaynağınıza genel bakış sayfasına gidin
Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API isteklerinizin kimliğini doğrulamak için anahtarlardan ve uç noktalardan birine ihtiyacınız olacaktır.
seçtiğiniz dil için istemci kitaplığı paketini indirin ve yükleyin:

Dil Paket sürümü

.NET 1.0.0

Python 1.0.0
İstemci ve dönüş nesnesi hakkında daha fazla bilgi için aşağıdaki başvuru belgelerine bakın:
- C#
- Python

Dil	Paket sürümü
.NET	1.0.0
Python	1.0.0

Konuşmayı metne dönüştürmeyi kullanarak dökümleri gönderme

Konuşma tanıma hizmetinin konuşmayı metne dönüştürme özelliği kullanılarak dökümü alınmış konuşmalarınız varsa aşağıdaki örneği kullanın:

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

Metin sohbetleri gönderme

Metinden kaynaklanan konuşmalarınız varsa aşağıdaki örneği kullanın. Örneğin, metin tabanlı sohbet istemcisi aracılığıyla yapılan konuşmalar.

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

Sonucu alma

operation-location Yanıt üst bilgisinden öğesini alın. Değer aşağıdaki URL'ye benzer olacaktır:

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

İsteğin sonuçlarını almak için aşağıdaki cURL komutunu kullanın. değerini önceki operation-location yanıt üst bilgisinden aldığınız sayısal kimlik değeriyle değiştirdiğinizden my-job-id emin olun:

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"

Hizmet ve veri sınırları

Dakika ve saniye başına gönderebileceğiniz isteklerin boyutu ve sayısı hakkında bilgi için hizmet sınırları makalesine bakın.

Share via