طريقة اكتشاف معلومات التعريف الشخصية (PII) وتنقيحها

يمكن لميزة PII تقييم النص غير المهيكل واستخراج المعلومات الحساسة (PII) والمعلومات الصحية (PHI) في نص عبر عدة فئات محددة سابقًا.

خيارات التطوير

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

خيار التطوير	‏‏الوصف
استوديو اللغة	Language Studio هو نظام أساسي مستند إلى الويب يتيح لك محاولة ربط الكيان بأمثلة نصية بدون حساب Azure، وبياناتك الخاصة عند التسجيل. لمزيد من المعلومات، راجع موقع ويب Language Studio أو التشغيل السريع لاستوديو اللغة.
واجهة برمجة تطبيقات REST أو مكتبة العميل (Azure SDK)	دمج الكشف عن PII في تطبيقاتك باستخدام واجهة برمجة تطبيقات REST، أو مكتبة العميل المتوفرة بلغات مختلفة. لمزيد من المعلومات، راجع التشغيل السريع للكشف عن PII.

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

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

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

لغات الإدخال

عند إرسال المستندات لتُعالج لغرض المعالجة، يمكنك تحديد لغتها من اللغات المدعومة. إن لم تحدد لغة، فسيُعيّن استخراج العبارة الرئيسية افتراضيًا إلى اللغة الإنجليزية. قد ترجع API الإزاحات في الاستجابة لدعم ترميزات متعددة اللغات وذات رموز تعبيريةمختلفة.

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

يتم إجراء التحليل عند استلام الطلب. إن استخدام ميزة الكشف عن PII بشكل متزامن هو أمر عديم الحالة. لا يتم تخزين أي بيانات في حسابك، ويتم إرجاع النتائج على الفور في الرد.

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

تحديد الكيانات التي سيتم إرجاعها

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

تلميح

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

الإدخال:

إشعار

في هذا المثال، سيعيد نوع كيان الشخص فقط:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

{
    "kind": "PiiEntityRecognition",
    "parameters": 
    {
        "modelVersion": "latest",
        "piiCategories" :
        [
            "Person"
        ]
    },
    "analysisInput":
    {
        "documents":
        [
            {
                "id":"1",
                "language": "en",
                "text": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is John Doe) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!"
            }
        ]
    }
}

إخراج:

{
    "kind": "PiiEntityRecognitionResults",
    "results": {
        "documents": [
            {
                "redactedText": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is ********) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!",
                "id": "1",
                "entities": [
                    {
                        "text": "John Doe",
                        "category": "Person",
                        "offset": 226,
                        "length": 8,
                        "confidenceScore": 0.98
                    }
                ],
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2021-01-15"
    }
}

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

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

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

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

الخطوات التالية

نظرة عامة على التعرف على الكيانات المسماة