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

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

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

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

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

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

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

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

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

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

2. حدد Add deployment لبدء تشغيل معالج Add deployment .

   

3. حدد Create a new deployment name لإنشاء نشر جديد وتعيين نموذج مدرب من القائمة المنسدلة أدناه. يمكنك بخلاف ذلك تحديد الكتابة فوق اسم نشر موجود لاستبدال النموذج المستخدم من قبل نشر موجود بشكل فعال.

   إشعار

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

   

4. حدد نموذجا مدربا من القائمة المنسدلة Model .

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

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

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

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

قم بإنشاء طلب PUT باستخدام عنوان URL والعناوين وجسم JSON التالي لبدء نشر نموذج فهم لغة المحادثة.

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}

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

الرؤوس

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

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

نص الطلب

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

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

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

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

يمكنك استخدام عنوان URL هذا للحصول على حالة التوزيع.

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

عند إرسال طلب نشر ناجح، يتم تضمين عنوان URL للطلب الكامل للتحقق من حالة المهمة (بما في ذلك نقطة النهاية واسم المشروع ومعرف المهمة) في عنوان الاستجابة operation-location .

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

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

{ENDPOINT}/language/authoring/analyze-conversations/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}	معرف تحديد موقع حالة تدريب نموذجك	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	إصدار واجهة برمجة التطبيقات التي تتصل بها.	2023-04-01

الرؤوس

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

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

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

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

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

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

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

• أخذ النموذج المخصص للتوزيع الأول، وتعيينه إلى التوزيع الثاني.
• أخذ النموذج المعين للتوزيع الثاني وتعيينه إلى التوزيع الأول.

يمكن استخدام هذا لمبادلة عمليات التوزيع production وstaging عندما تريد أخذ النموذج المعين إلى staging وتعيينه إلى production.

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

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

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

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

   

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

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

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

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

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

حذف النشر

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

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

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

إنشاء طلب DELETE باستخدام عنوان URL والعناوين ونص JSON التالي لحذف نشر فهم لغة المحادثة.

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

{ENDPOINT}/language/authoring/analyze-conversations/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}	إصدار واجهة برمجة التطبيقات التي تتصل بها.	2023-04-01

الرؤوس

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

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

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

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

يمكنك نشر مشروعك في مناطق متعددة عن طريق تعيين موارد 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-conversations/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/12345678-0000-0000-0000-0000abcd1234/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-conversations/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	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

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

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

{
    "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-conversations/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-conversations/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"
}

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

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