كيفية إنشاء مشروع CLU

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

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

قبل البدء في استخدام CLU، ستحتاج إلى عدة أشياء:

• اشتراك Azure - أنشئ اشتراكاً مجاناً.
• مورد لغة الذكاء الاصطناعي Azure

إنشاء مورد Language

قبل البدء في استخدام CLU، ستحتاج إلى مورد Azure الذكاء الاصطناعي Language.

إشعار

• تحتاج إلى تعيين دور مالك في مجموعة الموارد لإنشاء مورد لغة.

إنشاء مورد جديد من مدخل Microsoft Azure

1. سجل الدخول إلى مدخل Microsoft Azure لإنشاء مورد Azure الذكاء الاصطناعي Language جديد.

2. حدد Create a new resource

3. في النافذة التي تظهر، ابحث عن خدمة اللغة

4. حدد إنشاء.

5. إنشاء مورد لغة بالتفاصيل التالية.

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

قم بإنشاء مورد لغة جديد من استوديو اللغة

إذا كانت هذه هي المرة الأولى التي تسجل فيها الدخول، فسترى نافذة في Language Studio تتيح لك اختيار مورد Language موجود أو إنشاء مورد جديد. يمكنك أيضاً إنشاء مورد بالنقر فوق أيقونة الإعدادات في الزاوية العلوية اليمنى، وتحديد Resources، ثم النقر فوق Create a new resource.

إنشاء مورد لغة بالتفاصيل التالية.

تفاصيل المثيل	القيمة المطلوبة
اشتراك Azure	اشتراكك في Azure
مجموعة موارد Azure	مجموعة موارد Azure الخاصة بك
اسم مورد Azure	اسم مورد اللغة
الموقع	مناطق معتمدة لمورد اللغة.
مستوى الأسعار	مستويات تسعير مدعومة لمورد اللغة.

هام

• تأكد من تمكين الهوية المدارة عند إنشاء مورد Language.
• قراءة إشعار الذكاء الاصطناعي المسؤول وتأكيده

تسجيل الدخول إلى إستوديو اللغة

1. انتقل إلى "Language Studio" ثم سجل الدخول باستخدام حساب Azure.

2. في إطار "Choose a language resource" الذي يظهر، ابحث عن اشتراكك في Azure واختر مورد اللغة. إذا لم يكن لديك موارد يُمكنك إنشاء مجموعة موارد جديدة.

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

   

إنشاء مشروع محادثة

بمجرد إنشاء مورد Language، قم بإنشاء مشروع فهم لغة المحادثة.

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

1. في Language Studio، ابحث عن قسم فهم الأسئلة ولغة المحادثة، وحدد فهم لغة المحادثة.
   

2. سيؤدي ذلك إلى نقلك إلى صفحة مشاريع فهم لغة المحادثة. حددCreate new project.

   

لإنشاء مشروع جديد، تحتاج إلى توفير التفاصيل التالية:

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

بمجرد الانتهاء، حدد التالي وراجع التفاصيل. حدد إنشاء لإكمال العملية. يجب أن تشاهد الآن شاشة "Build Schema" في المشروع.

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

أرسل طلب PATCH باستخدام عنوان URL والرؤوس ونص JSON التالي لإنشاء مشروع جديد.

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

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?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	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.
Content-Type	'application/merge-patch+json'

نص الرسالة

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

مفتاح	Placeholder	القيمة‬	مثال
projectName	{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	EmailApp
language	{LANGUAGE-CODE}	سلسلة تحدد رمز اللغة للألفاظ المستخدمة في مشروعك. إذا كان مشروعك متعدد اللغات، فقم باختيار التعليمة البرمجية للغة لغالبية الكلمات.	en-us
multilingual	true	قيمة منطقية تُتيح لك الحصول على مستندات بلغات متعددة في مجموعة البيانات الخاصة بك وعندما يتم توزيع النموذج الخاص بك، يمكنك الاستعلام عن النموذج بأي لغة مدعومة (ليس بالضرورة أن تكون مضمنة في مستندات التدريب الخاصة بك). راجع دعم اللغة لمعرفة المزيد بشأن دعم اللغات المتعددة.	true

استيراد مشروع

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

يمكنك تصدير مشروع فهم لغة المحادثة كملف JSON في أي وقت من خلال الانتقال إلى صفحة مشاريع المحادثة، وتحديد مشروع، والضغط من القائمة العليا على تصدير.

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

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

لاستيراد مشروع، حدد زر السهم بجوار إنشاء مشروع جديد وحدد استيراد، ثم حدد ملف LUIS أو Conversational Language Understanding JSON.

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

يمكنك استيراد CLU JSON إلى الخدمة

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

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

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

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

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

الرؤوس

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

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

نص الرسالة

نص JSON الذي ترسله مشابه للمثال التالي. راجع الوثائق المرجعية لمزيد من التفاصيل حول كائن JSON.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

مفتاح	Placeholder	القيمة‬	مثال
{API-VERSION}	إصدار واجهة برمجة التطبيقات التي تتصل بها.	2023-04-01
projectName	{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	EmailAppDemo
language	{LANGUAGE-CODE}	سلسلة تحدد رمز اللغة للألفاظ المستخدمة في مشروعك. إذا كان مشروعك متعدد اللغات، فقم باختيار التعليمة البرمجية للغة لغالبية الكلمات.	en-us
multilingual	true	قيمة منطقية تمكنك من الحصول على مستندات بلغات متعددة في مجموعة البيانات الخاصة بك. عند نشر النموذج الخاص بك، يمكنك الاستعلام عن النموذج بأي لغة مدعومة بما في ذلك اللغات غير المضمنة في مستندات التدريب الخاصة بك.	true
dataset	{DATASET}	راجع كيفية تدريب نموذج للحصول على معلومات حول تقسيم بياناتك بين مجموعة اختبار وتدريب. القيم المحتملة لهذا الحقل هي Train وTest.	Train

بناء على طلب ناجح، ستحتوي استجابة واجهة برمجة التطبيقات على operation-location عنوان مع عنوان URL يمكنك استخدامه للتحقق من حالة مهمة الاستيراد. تم تنسيقه على النحو التالي:

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

تصدير المشروع

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

يمكنك تصدير مشروع فهم لغة المحادثة كملف JSON في أي وقت من خلال الانتقال إلى صفحة مشاريع المحادثة، وتحديد مشروع، والضغط على تصدير.

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

يمكنك تصدير مشروع فهم لغة محادثة كملف JSON في أي وقت.

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

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

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

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

الرؤوس

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

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

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

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

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

الحصول على تفاصيل المشروع CLU

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

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

2. يمكنك مشاهدة تفاصيل المشروع.

3. في هذه الصفحة، يمكنك تحديث وصف المشروع وتمكين/تعطيل مجموعة البيانات متعددة اللغات في إعدادات المشروع.

4. يمكنك أيضاً استرداد مفتاح المورد الأساسي من هذه الصفحة.

   

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

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?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	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

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

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

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

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

حذف المشروع

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

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

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

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

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

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?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	مفتاح موردك. يُستخدم للمصادقة على طلبات واجهة برمجة التطبيقات.

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

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

مخطط البناء