نشر نموذج وتصنيف النص باستخدام وقت تشغيل API

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

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

• مشروع تصنيف نص مخصص مع حساب تخزين Azure المكوّن،
• البيانات النصية المُحمَّلة إلى حساب التخزين.
• البيانات المسماةوالنموذج المُدرَّب بنجاح
• مراجعة تفاصيل تقييم النموذج لتحديد كيفية أداء النموذج.

راجع دورة حياة تطوير المشروع لمزيد من المعلومات.

توزيع النموذج

بعد مراجعة أداء النموذج والتوصُّل إلى إمكانية استخدامه في بيئتك، تحتاج إلى تعيينه لعملية نشر لتتمكن من الاستعلام عنها. تعيين النموذج إلى عملية نشر يجعله متاحا للاستخدام من خلال واجهة برمجة تطبيقات التنبؤ. من المستحسن إنشاء نشر باسم production يقوم بتعيين أفضل نموذج كوَّنته حتى الآن واستخدمه في نظامك. يمكنك إنشاء نشر آخر يسمى staging، ويمكنك تعيين له النموذج الذي تعمل عليه حالياً لتتمكن من اختباره. يمكنك تكوين 10 عمليات نشر كحد أقصى في مشروعك.

استوديو اللغة

لتوزيع النموذج من داخل Language Studio:

1. حدّدDeploying a model من القائمة الجانبية اليسري.

2. حدد Add deployment لبدء مهمة توزيع جديدة.

   

3. حدد Create new deployment لإنشاء نشر جديد وتعيين نموذج مُدرَّب من القائمة المنسدلة أدناه. يمكنك أيضاً استبدال توزيع موجود عن طريق تحديد هذا الخيار وتحديد النموذج المُدرب الذي تريد تعيينه إليه من القائمة المنسدلة أدناه.

   إشعار

   لا يتطلب استبدال توزيع موجود إجراء تغييرات على استدعاء واجهة برمجة تطبيقات التنبؤ ولكن النتائج التي تحصل عليها ستستند إلى النموذج المُعيّن حديثاً.

   

4. حدد Deploy لبدء مهمة التوزيع.

5. بعد نجاح النشر، سيظهر تاريخ انتهاء صلاحية بجانبه. تنتهي صلاحية النشر عندما يكون النموذج المنشور غير متوفر لاستخدامه للتنبؤ، والذي يحدث عادة بعد اثني عشر شهراً من انتهاء صلاحية تكوين التدريب.

واجهات برمجة تطبيقات REST

قم بإرسال وظيفة التوزيع

قم بإرسال طلب PUT باستخدام عنوان URL والعناوين ونص JSON التالي لإرسال وظيفة التوزيع. استبدل قيم العنصر النائب أدناه بقيمك الخاصة.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

Placeholder	القيمة‬	مثال
{ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{DEPLOYMENT-NAME}	اسم النشر الخاص بك. هذه القيمة حساسة لحالة الأحرف.	staging
{API-VERSION}	إصدار واجهة برمجة التطبيقات التي تستدعيها. القيمة المشار إليها هنا هي لأحدث إصدار تم إصداره. تعرف على المزيد حول إصدارات واجهة برمجة التطبيقات الأخرى المتوفرة	2022-05-01

الرؤوس

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

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

نص الطلب

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

{
  "trainedModelLabel": "{MODEL-NAME}"
}

مفتاح	Placeholder	القيمة‬	مثال
trainedModelLabel	{MODEL-NAME}	اسم النموذج الذي سيتم تعيينه للنشر. يمكنك فقط تعيين نماذج مُدرَّبة بنجاح. هذه القيمة حساسة لحالة الأحرف.	myModel

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

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

الحصول على حالة مهمة النشر

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

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

الرؤوس

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

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

هيئة الاستجابة

بمجرد إرسال الطلب، ستحصل على الرد التالي. احتفظ باقتراع نقطة النهاية هذه حتى تتغير معلمة الحالة إلى "نجح". يجب أن تحصل على التعليمة البرمجية200 للإشارة إلى نجاح الطلب.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

تبديل عمليات التوزيع

يمكنك تبديل عمليات النشر بعد اختبار نموذج معين لعملية نشر واحدة، وتريد تعيينه إلى آخر. يتضمن تبديل عمليات التوزيع أخذ النموذج المُعيَّن للتوزيع الأول وتعيينه إلى التوزيع الثاني. ثم أخذ النموذج المُعيَّن للنشر الثاني وتعيينه إلى النشر الأول. يمكن استخدام هذا لمبادلة عمليات النشر production وstagingعندما تريد أخذ النموذج المعين إلى staging وتعيينه إلى production.

استوديو اللغة

لتبديل عمليات النشر من داخل أستوديو اللغات

1. في صفحة Deploying a model ، حدد التوزيعين اللذين تريد تبديلهما وحدد Swap deployments من القائمة العلوية.

2. من النافذة التي تظهر، حدد أسماء عمليات النشر التي تريد تبديلها.

واجهات برمجة تطبيقات REST

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

عنوان URL الخاص بالطلب

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

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

الرؤوس

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

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

نص الطلب

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

مفتاح	Placeholder	القيمة‬	مثال
firstDeploymentName	{FIRST-DEPLOYMENT-NAME}	اسم النشر الأول لك. هذه القيمة حساسة لحالة الأحرف.	production
secondDeploymentName	{SECOND-DEPLOYMENT-NAME}	اسم النشر الثاني لك. هذه القيمة حساسة لحالة الأحرف.	staging

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

حذف النشر

استوديو اللغة

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

واجهات برمجة تطبيقات REST

أنشئ طلب DELETE باستخدام عنوان URL التالي، والعناوين، ونص المشروع بلغة JSON لحذف النشر.

عنوان URL الخاص بالطلب

{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?api-version={API-VERSION}

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

الرؤوس

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

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

بمجرد إرسال طلب واجهة برمجة التطبيقات، ستتلقى استجابة 202 تشير إلى النجاح، ما يعني أنه تم حذف النشر. ينتج عن الاستدعاء الناجح عنوان Operation-Location يُستخدم للتحقق من حالة الوظيفة.

تعيين موارد التوزيع

يمكنك نشر مشروعك في مناطق متعددة عن طريق تعيين موارد Language مختلفة موجودة في مناطق مختلفة.

استوديو اللغة

لتعيين موارد التوزيع في مناطق أخرى في Language Studio:

1. تأكد من تعيين نفسك كمالك لغة الخدمات المعرفية للمورد الذي استخدمته لإنشاء المشروع.
2. انتقل إلى صفحة Deploying a model في Language Studio.
3. حدد علامة التبويب المناطق.
4. حدد Add deployment resource.
5. حدد مورد Language في منطقة أخرى.

أنت الآن جاهز لنشر مشروعك في المناطق التي قمت بتعيين الموارد فيها.

واجهات برمجة تطبيقات REST

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

تعيين مورد

أرسل طلب POST باستخدام عنوان URL والعناوين والنص الأساسي JSON التالي لتعيين موارد النشر.

عنوان URL الخاص بالطلب

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

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

الرؤوس

استخدم مصادقة Microsoft Entra لمصادقة واجهة برمجة التطبيقات هذه.

نص الرسالة

استخدم العينة التالية JSON كنص مشروعك.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

مفتاح	Placeholder	القيمة‬	مثال
azureResourceId	{AZURE-RESOURCE-ID}	مسار معرف المورد الكامل الذي تريد تعيينه. تم العثور عليه في مدخل Microsoft Azure ضمن علامة التبويب Properties للمورد، في حقل Resource ID .	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource
customDomain	{CUSTOM-DOMAIN}	المجال الفرعي المخصص للمورد الذي تريد تعيينه. تم العثور عليه في مدخل Microsoft Azure ضمن علامة التبويب Keys and Endpoint للمورد، ك حقل Endpoint في عنوان URL https://<your-custom-subdomain>.cognitiveservices.azure.com/	contosoresource
region	{REGION-CODE}	رمز منطقة يحدد منطقة المورد الذي تريد تعيينه. تم العثور عليه في مدخل Microsoft Azure ضمن علامة التبويب Keys and Endpoint للمورد، في حقل Location/Region .	eastus

الحصول على حالة المورد المعين

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

عنوان URL الخاص بالطلب

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}

Placeholder	القيمة‬	مثال
{ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{JOB-ID}	معرف الوظيفة للحصول على حالة توزيع التعيين. هذا في قيمة العنوان التي operation-location تلقيتها من واجهة برمجة التطبيقات استجابة لطلب تعيين مورد التوزيع.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	إصدار واجهة برمجة التطبيقات التي تستدعيها.	2022-10-01-preview

الرؤوس

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

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

هيئة الاستجابة

بمجرد إرسال الطلب، ستحصل على الرد التالي. استمر في التحقق من نقطة النهاية هذه حتى تتغير المعلمة status إلى succeeded.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

إلغاء تعيين موارد التوزيع

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

استوديو اللغة

لإلغاء تعيين موارد النشر أو إزالتها في مناطق أخرى باستخدام Language Studio:

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

واجهات برمجة تطبيقات REST

إلغاء تعيين المورد

أرسل طلب POST باستخدام عنوان URL والرؤوس والنص الأساسي JSON التالي لإلغاء تعيين موارد النشر أو إزالتها من مشروعك.

عنوان URL الخاص بالطلب

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

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

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

الرؤوس

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

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

نص الرسالة

استخدم العينة التالية JSON كنص مشروعك.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

مفتاح	Placeholder	القيمة‬	مثال
assignedResourceIds	{AZURE-RESOURCE-ID}	مسار معرف المورد الكامل الذي تريد إلغاء تعيينه. تم العثور عليه في مدخل Microsoft Azure ضمن علامة التبويب Properties للمورد ك حقل Resource ID .	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource

الحصول على حالة المورد غير المعينة

استخدم طلب GET التالي للحصول على حالة مهمة موارد النشر غير المعينة. استبدل قيم العنصر النائب أدناه بقيمك الخاصة.

عنوان URL الخاص بالطلب

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}

Placeholder	القيمة‬	مثال
{ENDPOINT}	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
{JOB-ID}	معرف الوظيفة للحصول على حالة توزيع التعيين. هذا في قيمة العنوان التي operation-location تلقيتها من واجهة برمجة التطبيقات استجابة لطلب موارد النشر غير المعين.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	إصدار واجهة برمجة التطبيقات التي تستدعيها.	2022-10-01-preview

الرؤوس

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

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

هيئة الاستجابة

بمجرد إرسال الطلب، ستحصل على الرد التالي. احتفظ باقتراع نقطة النهاية هذه حتى تتغير معلمة الحالة إلى "نجح".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

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

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