كيفية اكتشاف PII وتنقيحها في المحادثات

يمكن لميزة المحادثة PII تقييم المحادثات لاستخراج المعلومات الحساسة (PII) في المحتوى عبر عدة فئات محددة مسبقاً وتنقيحها. تعمل واجهة برمجة التطبيقات هذه على كل من النصوص المكتوبة (المشار إليها بالنصوص) والـ دردشة. بالنسبة للنصوص، تتيح API أيضاً تنقيح مقاطع الصوت، والتي تحتوي على معلومات PII من خلال توفير معلومات توقيت الصوت لمقاطع الصوت تلك.

تحديد كيفية معالجة البيانات (اختياري)

تحديد نموذج للكشف عن PII

بشكل افتراضي، ستستخدم هذه الميزة أحدث نموذج متاح من AI في الإدخال الخاص بك. يمكنك أيضًا تكوين طلبات واجهة برمجة التطبيقات لاستخدام إصدار نموذج معين.

دعم اللغة

حالياً، تدعم واجهة برمجة تطبيقات معاينة PII للمحادثة اللغة الإنجليزية فقط.

دعم المنطقة

تدعم واجهة برمجة تطبيقات معاينة PII للمحادثة حاليًا جميع مناطق Azure المدعومة من قبل خدمة Language.

إرسال البيانات

ملاحظة

راجع مقالة Language Studio للحصول على معلومات حول تنسيق نص المحادثة لإرساله باستخدام Language Studio.

يمكنك إرسال المدخلات إلى API كقائمة لعناصر المحادثة. يتم إجراء التحليل عند استلام الطلب. نظراً لأن واجهة برمجة التطبيقات غير متزامنة، فقد يكون هناك تأخير بين إرسال طلب واجهة برمجة التطبيقات واستلام النتائج. للحصول على معلومات حول حجم وعدد الطلبات التي يمكنك إرسالها في الدقيقة والثانية، راجع حدود البيانات أدناه.

عند استخدام ميزة غير متزامن، تكون نتائج واجهة برمجة التطبيقات متاحة لمدة 24 ساعة من وقت تقديم الطلب، ويتم الإشارة إليها في الاستجابة. بعد هذه الفترة الزمنية، تُزال النتائج ولا تصبح متاحة للاسترجاع.

عند إرسال البيانات إلى معلومات التعريف الشخصية للمحادثة، يمكنك إرسال محادثة واحدة (دردشة أو منطوقة) لكل طلب.

ستحاول واجهة برمجة التطبيقات اكتشاف جميع فئات الكيانات المحددة لإدخال محادثة معين. إن كنت تريد تحديد الكيانات التي يتم الكشف عنها وإرجاعها، فاستخدم المعلمة الاختيارية piiCategories مع فئات الكيان المناسبة.

بالنسبة إلى النصوص المنطوقة، سيتم إرجاع الكيانات التي تم اكتشافها في قيمة المعلمة redactionSource المقدمة. حاليا، القيم المدعومة ل redactionSource هي textو lexicalitnو maskedItn و (التي تعين الكلام إلى نص واجهة برمجة تطبيقات\displayTextlexicaldisplayitn REST وتنسيقها maskedItn على التوالي). بالإضافة إلى ذلك، بالنسبة لإدخال النص المنطوق، ستوفر واجهة برمجة التطبيقات هذه أيضاً معلومات توقيت الصوت لتمكين تنقيح الصوت. لاستخدام ميزة audioRedaction، استخدم علامة اختيارية includeAudioRedaction بقيمة true. يتم إجراء تنقيح الصوت بناءً على تنسيق الإدخال المعجمي.

ملاحظة

يدعم PII المحادثة الآن 40000 حرف كحجم مستند.

الحصول على نتائج PII

عندما تحصل على نتائج من الكشف عن PII، يمكنك دفق النتائج إلى تطبيق ما أو حفظ المخرج في ملف على النظام المحلي. ستتضمن استجابة واجهة برمجة التطبيقات كيانات معترف بها، بما في ذلك فئاتها وفئاتها الفرعية ودرجات الثقة. يتم أيضا إرجاع السلسلة النصية مع كيانات PII التي تم تنقيحها.

أمثلة

المكتبات الخاصة بالعملاء Azure SDK

1. انتقل إلى صفحة نظرة عامة على المورد في مدخل Microsoft Azure

2. من القائمة على الجانب الأيسر، حدد Keys and Endpoint. ستحتاج إلى أحد المفاتيح ونقطة النهاية لمصادقة طلبات واجهة برمجة التطبيقات.

3. قم بتنزيل وتثبيت حزمة مكتبة العميل للغة الخاصة بك التي تختارها:

   اللغة	إصدار الحزمة.
   .NET	1.0.0
   Python	1.0.0

4. راجع المستندات المرجعية التالية للحصول على مزيد من المعلومات حول العميل، وإرجاع العنصر:

   • C#‎
   • Python

REST API

إرسال النصوص باستخدام الكلام إلى نص

استخدم المثال التالي إذا كانت لديك محادثات منسوخة باستخدام ميزة الكلام إلى نص لخدمة الكلام:

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

إرسال الدردشات النصية

استخدم المثال التالي إذا كانت لديك محادثات نشأت في النص. على سبيل المثال، المحادثات من خلال برنامج دردشة نصي.

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

احصل على النتيجة

الحصول على ⁧operation-location⁩ من رأس الاستجابة. ستبدو القيمة مشابهة لـ URL التالي:

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

للحصول على نتائج الطلب، استخدم الأمر cURL التالي. تأكد من استبدال ⁧my-job-id⁩ بقيمة المعرف الرقمي التي تلقيتها من رأس الاستجابة السابقة ⁧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"

حدود الخدمة والبيانات

للحصول على معلومات حول حجم الطلبات التي يمكنك إرسالها في الدقيقة والثانية وعددها، راجع مقال حدود البيانات.