التشغيل السريع: التعرف على الكيان المخصص المسمى(معاينة)

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

في هذه المقالة، نستخدم استوديو اللغة لإظهار المفاهيم الأساسية للتعرف على الكيانات المسماة المخصصة (NER). على سبيل المثال ، سنقوم ببناء نموذج NER مخصص لاستخراج الكيانات ذات الصلة من اتفاقيات القروض.

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجانًا

إنشاء مورد Azure جديد وحساب تخزين Azure Blob

قبل أن تتمكن من استخدام NER مخصص، ستحتاج إلى إنشاء مورد لغة Azure، والذي سيمنحك بيانات الاعتماد التي تحتاجها لإنشاء مشروع وبدء تدريب نموذج. ستحتاج أيضا إلى حساب تخزين Azure، حيث يمكنك تحميل مجموعة البيانات التي سيتم استخدامها لإنشاء نموذجك.

هام

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

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

1. انتقل إلى مدخل Azure لإنشاء مورد جديد لـAzure Language. إذا طلب منك تحديد ميزات إضافية، فحدد NER مخصص لتصنيف & النص المخصص. عند إنشاء المورد الخاص بك، تأكد من أنه يحتوي على المعلمات التالية.

   متطلبات المورد Azure	القيمة المطلوبة
   ‏‏الموقع	"غرب الولايات المتحدة 2" أو "أوروبا الغربية"
   مستوى الأسعار	معايير (S) مستويات التسعير

2. في القسم التصنيف المخصص (معاينة) & التعرف على الكيانات المسماة (NER)، حدد حساب تخزين موجود أو حدد إنشاء حساب تخزين جديد. لاحظ أن هذه القيم مخصصة لهذا التشغيل السريع، وليس بالضرورة قيم حساب التخزين التي ستحتاج إلى استخدامها في بيئات الإنتاج.

   أهمية حساب التخزين	القيمة الموصى بها
   الاسم	أي اسم
   الأداء	Standard
   نوع الحساب	التخزين (الغرض العام v1)
   النسخ المتماثل	التخزين المتكرر محليًا (LRS)
   ‏‏الموقع	أي موقع أقرب إليك، لأفضل زمن انتقال.

تحميل عينة البيانات إلي حاوية البيانات

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

1. قم بتحميل بيانات المثال لهذا quickstart من GitHub. افتح ملف .zip، واستخرج المجلد الذي يحتوي على ملفات نصية داخله.

2. في مدخل Azure، انتقل إلى حساب التخزين الذي أنشأته، وحدده.

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

   

4. بعد إنشاء الحاوية الخاصة بك ، انقر فوقها. ثم حدد الزر Upload لتحديد ملفات .txt و .json التي قمت بتنزيلها مسبقا.

   

   تلميح

   عند تحديد ملفات لتحميلها، سيتم فتح مستكشف ملفات على الكمبيوتر. لتحديد كافة الملفات الموجودة في المجلد، اضغط على ctrl + a.

تحتوي مجموعة البيانات المقدمة على 20 اتفاقية قرض، ويشمل كل اتفاق طرفين: المقرض والمقترض. يمكنك استخدام ملف العينة المتوفر لاستخراج المعلومات ذات الصلة لكلا الطرفين وتاريخ الاتفاقية ومبلغ القرض ومعدل الفائدة.

إنشاء مشروع مخصص للتعرف على الكيان المسمى

بمجرد تهيئة حاوية الموارد والتخزين خاصتك، أنشئ مشروع مخصص جديد للتعرف على الكيانات المسماة. يُعد المشروع منطقة العمل المستخدمة لإنشاء نماذج الذكاء الاصطناعي المخصصة استناداً إلى بياناتك. لا يمكن الوصول إلى مشروعك إلا من قبلك ومن قبل الآخرين الذين لديهم حق الوصول إلى مورد Azure المستخدم.

1. تسجيل الدخول إلى بوابة Language Studio. ستظهر نافذة تتيح لك تحديد الاشتراك ومورد اللغة. حدد المورد الذي أنشأته في الخطوة أعلاه.

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

   

3. حدد إنشاء مشروع جديد من القائمة العليا في صفحة المشاريع. إن إنشاء مشروع سيسمح لك بوضع علامة على البيانات وتدريب النماذج الخاصة بك وتقييمها وتحسينها ونشرها.

   

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

   ملاحظة

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

   

5. أدخل معلومات المشروع، بما في ذلك الاسم والوصف ولغة الملفات في المشروع. لن تتمكن من تغيير اسم مشروعك لاحقا.

6. حدد الحاوية التي حملت بياناتك إليها.

ضمن هل ملفاتك موسومة بالفعل بالكيانات، حدد نعم واختر الملف المتوفر. ثم انقر فوق ⁧⁩التالي⁧⁩. راجع البيانات التي أدخلتها وحدد إنشاء مشروع.

درّب نموذجك

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

النموذج هو كائن التعلم الآلي الذي سيتم تدريبه على تصنيف النص. سيتعلم نموذجك من بيانات المثال ، وسيكون قادرا على تصنيف اتفاقيات القروض بعد ذلك.

لبدء تدريب النموذج الخاص بك:

1. حدد قطار من القائمة في الجانب الأيسر.

2. حدد تجريب طراز جديد واكتب اسم الطراز في مربع النص أدناه.

   

3. انقر على زر التدريب في أسفل الصفحة.

   ملاحظة

   • أثناء التدريب ، سيتم نقل البيانات إلى مجموعات 2 للتدريب واختبار النموذج. تعرف على كيفية تدريب نموذج لمزيد من المعلومات.
   • قد يستغرق التدريب بضع ساعات.

نشر النموذج الخاص بك

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

بعد تدريب النموذج الخاص بك، يمكنك نشره. يتيح لك نشر الطراز الخاص بك البدء في استخدامه لاستخراج كيانات مسماة، باستخدام تحليل API.

1. انتقل إلى مشروعك في استوديو اللغة.

2. من اللوحة اليمنى، حدد نشر النموذج.

3. انقر فوق إضافة نشر لإرسال مهمة نشر جديدة.

   

4. في النافذة التي تظهر، يمكنك إنشاء اسم نشر جديد أو تجاوز اسم موجود. بعد ذلك، يمكنك إضافة نموذج مدرب إلى اسم النشر هذا.

   

اختبار النموذج الخاص بك

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

1. حدد اختبار الطراز من القائمة الجانب الأيسر.

2. حدد النموذج الذي تريد اختباره.

3. باستخدام أحد الملفات التي قمت بتنزيلها مسبقا، أضف نص الملف إلى مربع النص. يمكنك أيضا تحميل .txt ملف.

4. انقر على تشغيل الاختبار.

5. في علامة تبويب النتيجة، يمكنك مشاهدة الكيانات المستخرجة من النص وأنواعها. يمكنك أيضاً عرض استجابة JSON ضمن علامة التبويب JSON.

   

تنظيف الموارد

عندما لا تحتاج إلى مشروعك بعد الآن، يمكنك حذف مشروعك باستخدام Language Studio. حدد التعرف على الكيان المسمى المخصص (NER) في قائمة التنقل اليسرى، وحدد المشروع الذي تريد حذفه وانقر على حذف.

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجانًا

إنشاء مورد Azure جديد وحساب تخزين Azure Blob

قبل أن تتمكن من استخدام NER مخصص، ستحتاج إلى إنشاء مورد لغة Azure، والذي سيمنحك بيانات الاعتماد التي تحتاجها لإنشاء مشروع وبدء تدريب نموذج. ستحتاج أيضا إلى حساب تخزين Azure، حيث يمكنك تحميل مجموعة البيانات التي سيتم استخدامها لإنشاء نموذجك.

هام

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

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

1. انتقل إلى مدخل Azure لإنشاء مورد جديد لـAzure Language. إذا طلب منك تحديد ميزات إضافية، فحدد NER مخصص لتصنيف & النص المخصص. عند إنشاء المورد الخاص بك، تأكد من أنه يحتوي على المعلمات التالية.

   متطلبات المورد Azure	القيمة المطلوبة
   ‏‏الموقع	"غرب الولايات المتحدة 2" أو "أوروبا الغربية"
   مستوى الأسعار	معايير (S) مستويات التسعير

2. في القسم التصنيف المخصص (معاينة) & التعرف على الكيانات المسماة (NER)، حدد حساب تخزين موجود أو حدد إنشاء حساب تخزين جديد. لاحظ أن هذه القيم مخصصة لهذا التشغيل السريع، وليس بالضرورة قيم حساب التخزين التي ستحتاج إلى استخدامها في بيئات الإنتاج.

   أهمية حساب التخزين	القيمة الموصى بها
   الاسم	أي اسم
   الأداء	Standard
   نوع الحساب	التخزين (الغرض العام v1)
   النسخ المتماثل	التخزين المتكرر محليًا (LRS)
   ‏‏الموقع	أي موقع أقرب إليك، لأفضل زمن انتقال.

تحميل عينة البيانات إلي حاوية البيانات

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

1. قم بتحميل بيانات المثال لهذا quickstart من GitHub. افتح ملف .zip، واستخرج المجلد الذي يحتوي على ملفات نصية داخله.

2. في مدخل Azure، انتقل إلى حساب التخزين الذي أنشأته، وحدده.

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

   

4. بعد إنشاء الحاوية الخاصة بك ، انقر فوقها. ثم حدد الزر Upload لتحديد ملفات .txt و .json التي قمت بتنزيلها مسبقا.

   

   تلميح

   عند تحديد ملفات لتحميلها، سيتم فتح مستكشف ملفات على الكمبيوتر. لتحديد كافة الملفات الموجودة في المجلد، اضغط على ctrl + a.

تحتوي مجموعة البيانات المقدمة على 20 اتفاقية قرض، ويشمل كل اتفاق طرفين: المقرض والمقترض. يمكنك استخدام ملف العينة المتوفر لاستخراج المعلومات ذات الصلة لكلا الطرفين وتاريخ الاتفاقية ومبلغ القرض ومعدل الفائدة.

احصل على نقطة نهاية مفاتيح الموارد

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

• من القائمة على الجانب الأيسر، اخترالمفاتيح ونقطة النهاية. استخدم نقطة النهاية لطلبات واجهة برمجة التطبيقات وستحتاج إلى مفتاح Ocp-Apim-Subscription-Key الرأس.

إنشاء مشروع مخصص للتعرف على الكيانات المسماة

بمجرد تهيئة حاوية الموارد والتخزين خاصتك، أنشئ مشروع مخصص جديد للتعرف على الكيانات المسماة. يُعد المشروع منطقة العمل المستخدمة لإنشاء نماذج الذكاء الاصطناعي المخصصة استناداً إلى بياناتك. لا يمكن الوصول إلى مشروعك إلا من قبلك ومن قبل الآخرين الذين لديهم حق الوصول إلى مورد Azure المستخدم.

ملاحظة

اسم المشروع حساس لحالة الأحرف في جميع العمليات.

أنشئ طلب منشور باستخدام عناوين URL التالية ونص بلغة JSON لإنشاء مشروعك واستيراد ملف العلامات.

استخدم عنوان URL التالي لإنشاء مشروع واستيراد ملف العلامات. استبدل قيم العنصر النائب أدناه بقيمك الخاصة.

{YOUR-ENDPOINT}/language/analyze-text/projects/{projectName}/:import?api-version=2021-11-01-preview

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

النص الأساسي

استخدم لغة JSON التالية في طلبك. استبدل قيم العنصر النائب أدناه بقيمك الخاصة. استخدم ملف العلامات المتاح في علامة التبويب البيانات النموذجية

{
    "api-version": "2021-11-01-preview",
    "metadata": {
        "name": "MyProject",
        "multiLingual": true,
        "description": "Trying out custom NER",
        "modelType": "Extraction",
        "language": "string",
        "storageInputContainerName": "YOUR-CONTAINER-NAME",
        "settings": {}
    },
    "assets": {
        "extractors": [
        {
            "name": "Entity1"
        },
        {
            "name": "Entity2"
        }
    ],
    "documents": [
        {
            "location": "doc1.txt",
            "language": "en-us",
            "dataset": "Train",
            "extractors": [
                {
                    "regionOffset": 0,
                    "regionLength": 500,
                    "labels": [
                        {
                            "extractorName": "Entity1",
                            "offset": 25,
                            "length": 10
                        },                    
                        {
                            "extractorName": "Entity2",
                            "offset": 120,
                            "length": 8
                        }
                    ]
                }
            ]
        },
        {
            "location": "doc2.txt",
            "language": "en-us",
            "dataset": "Test",
            "extractors": [
                {
                    "regionOffset": 0,
                    "regionLength": 100,
                    "labels": [
                        {
                            "extractorName": "Entity2",
                            "offset": 20,
                            "length": 5
                        }
                    ]
                }
            ]
        }
    ]
    }
}

بالنسبة لمفتاح بيانات التعريف:

المفتاح	القيمة	مثال
modelType	نوع النموذج.	الاستخراج
storageInputContainerName	اسم حاوية تخزين كائن البيانات الثنائية في Azure.	myContainer

بالنسبة لمفتاح المستندات:

المفتاح	القيمة	مثال
location	اسم المستند في متجر blob.	doc2.txt
language	لغة الوثيقة.	en-us
dataset	حقل اختياري لتحديد مجموعة البيانات التي سينتمي إليها هذا المستند.	Train أو Test

سيُظهر هذا الطلب خطأ إذا:

• لا يملك المورد المحدد الإذن المناسب لحساب التخزين.

ابدأ في تدريب نموذجك

بعد إنشاء مشروعك، يمكنك البدء في تدريب نموذج التعرف على الكيانات المسماة المخصص. أنشئ طلب نشر باستخدام عناوين URL التالية والنص بلغة JSON لبدء تدريب نموذج التعرف على الكيانات المسماة. أنشئ طلب نشر باستخدام عناوين URL التالية والنص بلغة JSON لبدء تدريب نموذج تصنيف النص.

URL للطلب

استخدم عنوان URL التالي عند إنشاء طلب واجهة برمجة التطبيقات. استبدل قيم العنصر النائب أدناه بقيمك الخاصة.

{YOUR-ENDPOINT}/language/analyze-text/projects/{PROJECT-NAME}/:train?api-version=2021-11-01-preview

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

نص الطلب

استخدم لغة JSON التالية في طلبك. سيتم تسمية النموذج MyModel فور انتهاء التدريب.

{
  "modelLabel": "MyModel",
  "runValidation": true,
  "evaluationOptions":
    {
        "type":"percentage",
        "testingSplitPercentage":"30",
        "trainingSplitPercentage":"70"
    }
}

المفتاح	القيمة	مثال
modelLabel	اسم النموذج الخاص بك.	نموذجي
runValidation	القيمة المنطقية لتشغيل التحقق من الصحة على مجموعة الاختبار.	True أو False
evaluationOptions	يحدد خيارات التقييم.
type	يحدد نوع تقسيم البيانات.	تعيين أو نسبة مئوية
testingSplitPercentage	حقل عدد صحيح مطلوب إذا كان typeالنسبة المئوية. يحدد تقسيم الاختبار.	30
trainingSplitPercentage	حقل عدد صحيح مطلوب إذا كان typeالنسبة المئوية. يحدد تقسيم التدريب.	70

بمجرد إرسال طلب واجهة برمجة التطبيقات، ستتلقى 202 ردا يشير إلى النجاح. في عناوين الرد، استخرج location القيمة. سيُنسق على النحو التالي:

{YOUR-ENDPOINT}/language/analyze-text/projects/{YOUR-PROJECT-NAME}/train/jobs/{JOB-ID}?api-version=2021-11-01-preview

JOB-IDيُستخدم لتعريف طلبك، حيث إن هذه العملية غير متزامنة. ستستخدم عنوان URL هذا في الخطوة التالية للحصول على حالة التدريب.

الحصول على حالة التدريب

استخدم طلب "GET" التالي للاستعلام عن حالة عملية تدريب نموذجك. يمكنك استخدام عنوان URL الذي تلقيته من الخطوة السابقة، أو استبدال قيم العنصر النائب أدناه بقيمك الخاصة.

{YOUR-ENDPOINT}/language/analyze-text/projects/{YOUR-PROJECT-NAME}/train/jobs/{JOB-ID}?api-version=2021-11-01-preview

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{JOB-ID}	معرف تحديد موقع حالة تدريب نموذجك يرد ذلك في قيمة العنوان location التي تلقيتها في الخطوة السابقة.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

نص الرد

بمجرد إرسال الطلب ، ستحصل على الرد التالي.

{
  "jobs": [
    {
      "result": {
        "trainedModelLabel": "MyModel",
        "trainStatus": {
          "percentComplete": 0,
          "elapsedTime": "string"
        },
        "evaluationStatus": {
          "percentComplete": 0,
          "elapsedTime": "string"
        }
      },
      "jobId": "string",
      "createdDateTime": "2021-10-19T23:24:41.572Z",
      "lastUpdatedDateTime": "2021-10-19T23:24:41.572Z",
      "expirationDateTime": "2021-10-19T23:24:41.572Z",
      "status": "unknown",
      "errors": [
        {
          "code": "unknown",
          "message": "string"
        }
      ]
    }
  ],
  "nextLink": "string"
}

نشر نموذجك

أنشئ طلب إدراج باستخدام عناوين URL التالي والنص بلغة JSON لبدء نشر النموذج المخصص للتعرف على الكيانات المسماة.

{YOUR-ENDPOINT}/language/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version=2021-11-01-preview

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{DEPLOYMENT-NAME}	اسم النشر الخاص بك. هذه القيمة حساسة لحالة الأحرف.	prod

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

نص الطلب

استخدم لغة JSON التالية في طلبك. استخدم اسم النموذج الذي تريد نشره.

{
  "trainedModelLabel": "MyModel",
  "deploymentName": "prod"
}

بمجرد إرسال طلب واجهة برمجة التطبيقات، ستتلقى 202 ردا يشير إلى النجاح. في عناوين الرد، استخرج location القيمة. سيُنسق على النحو التالي:

{YOUR-ENDPOINT}/language/analyze-text/projects/{YOUR-PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version=2021-11-01-preview

يُستخدم JOB-ID لتعريف طلبك، حيث إن هذه العملية غير متزامنة. ستستخدم عنوان URL هذا في الخطوة التالية للحصول على حالة النشر.

احصل على حالة النشر

استخدم طلب الحصول التالي للاستعلام عن حالة عملية نشر نموذجك. يمكنك استخدام عنوان URL الذي تلقيته من الخطوة السابقة، أو استبدال قيم العنصر النائب أدناه بقيمك الخاصة.

{YOUR-ENDPOINT}/language/analyze-text/projects/{YOUR-PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version=2021-11-01-preview

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{DEPLOYMENT-NAME}	اسم النشر الخاص بك. هذه القيمة حساسة لحالة الأحرف.	prod
{JOB-ID}	معرف تحديد موقع حالة تدريب نموذجك يرد ذلك في قيمة العنوان location التي تلقيتها في الخطوة السابقة.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

إرسال مهمة مخصصة للتعرف على الكيانات المسماة

الآن بعد نشر النموذج الخاص بك، يمكنك البدء في إرسال مهام التعرف على الكيانات إليه.

ملاحظة

أسماء المشروع حساسة لحالة الأحرف.

استخدم طلب نشر لبدء مهمة استخراج وحدة. استبدل {projectName} باسم المشروع في المكان الذي يوجد فيه النموذج الذي تريد استخدامه.

{YOUR-ENDPOINT}/text/analytics/v3.2-preview.2/analyze

الرؤوس

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح الاشتراك الذي يوفر الوصول إلى واجهة برمجة التطبيقات هذه.

النص الأساسي

    {
    "displayName": "MyJobName",
    "analysisInput": {
        "documents": [
            {
                "id": "doc1", 
                "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc tempus, felis sed vehicula lobortis, lectus ligula facilisis quam, quis aliquet lectus diam id erat. Vivamus eu semper tellus. Integer placerat sem vel eros iaculis dictum. Sed vel congue urna."
            },
            {
                "id": "doc2",
                "text": "Mauris dui dui, ultricies vel ligula ultricies, elementum viverra odio. Donec tempor odio nunc, quis fermentum lorem egestas commodo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos."
            }
        ]
    },
    "tasks": {
        "customEntityRecognitionTasks": [      
            {
                "parameters": {
                      "project-name": "MyProject",
                      "deployment-name": "MyDeploymentName"
                      "stringIndexType": "TextElements_v8"
                }
            }
        ]
    }
}

المفتاح	قيمة النموذج	الوصف
اسم المستخدم	"MyJobName"	اسم وظيفتك
المستندات	[{},{}]	قائمة بالمستندات لتشغيل المهام على
المعرف	"doc1"	معرف مستند سلسلة
نص	"Lorem ipsum dolor sit amet"	مستندك بتنسيق سلسلة
المهام	[]	قائمة بالمهام التي نريد تنفيذها.
--	مهام التعرف على الكيانات المخصصة	مُعرف مهمة للمهمة التي نريد تنفيذها.
المعلمات	[]	قائمة المعلمات المقرر نقلها إلى المهمة
اسم- المشروع	"MyProject"	اسم مشروعك. اسم المشروع حساس لحالة الأحرف.
deployment-name	"MyDeploymentName"	اسم النشر

الاستجابة

سوف تتلقى 202 رداً يُشير إلى نجاح العملية. في عناوين الرد، استخرج قيمةoperation-location. operation-location منسق على النحو التالي:

{YOUR-ENDPOINT}/text/analytics/v3.2-preview.2/analyze/jobs/<jobId>

ستستخدم نقطة النهاية هذه في الخطوة التالية للحصول على نتائج مهمة التعرف المخصصة.

احصل على حالة المهمة ونتائجها

استخدم طلب الحصول التالي للاستعلام عن حالة أو نتائج مهمة التعرف المخصصة. يمكنك استخدام نقطة النهاية التي تلقيتها من الخطوة السابقة.

{YOUR-ENDPOINT}/text/analytics/v3.2-preview.2/analyze/jobs/<jobId>.

الرؤوس

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح الاشتراك الذي يوفر الوصول إلى واجهة برمجة التطبيقات هذه.

نص الرد

سيُقدم الرد في مستند بلغة JSON مع المعلمات التالية

{
    "createdDateTime": "2021-05-19T14:32:25.578Z",
    "displayName": "MyJobName",
    "expirationDateTime": "2021-05-19T14:32:25.578Z",
    "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
    "status": "completed",
    "errors": [],
    "tasks": {
        "details": {
            "name": "MyJobName",
            "lastUpdateDateTime": "2021-03-29T19:50:23Z",
            "status": "completed"
        },
        "completed": 1,
        "failed": 0,
        "inProgress": 0,
        "total": 1,
        "tasks": {
    "customEntityRecognitionTasks": [
        {
            "lastUpdateDateTime": "2021-05-19T14:32:25.579Z",
            "name": "MyJobName",
            "status": "completed",
            "results": {
                "documents": [
                    {
                        "id": "doc1",
                        "entities": [
                            {
                                "text": "Government",
                                "category": "restaurant_name",
                                "offset": 23,
                                "length": 10,
                                "confidenceScore": 0.0551877357
                            }
                        ],
                        "warnings": []
                    },
                    {
                        "id": "doc2",
                        "entities": [
                            {
                                "text": "David Schmidt",
                                "category": "artist",
                                "offset": 0,
                                "length": 13,
                                "confidenceScore": 0.8022353
                            }
                        ],
                        "warnings": []
                    }
                ],
                "errors": [],
                "statistics": {
                    "documentsCount":0,
                    "validDocumentsCount":0,
                    "erroneousDocumentsCount":0,
                    "transactionsCount":0
                }
                    }
                }
            ]
        }
    }

تنظيف الموارد

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

{YOUR-ENDPOINT}/language/text/authoring/v1.0-preview.2/projects/{PROJECT-NAME}

العنصر النائب	القيمة	مثال
{YOUR-ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject

الرؤوس

استخدم العنوان التالي للمصادقة على طلبك.

المفتاح	القيمة
Ocp-Apim-Subscription-Key	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

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

بعد إنشاء نموذج استخراج الكيان، يمكنك:

• استخدام واجهة برمجة تطبيقات وقت التشغيل لاستخراج الكيانات

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

• اختيار البيانات وتصميم المخطط
• بيانات العلامة
• تدريب نموذج
• عرض تقييم النموذج
• تحسين نموذج