إرسال طلبات التنبؤ للتوزيع

بعد إضافة التوزيع بنجاح، يمكنك الاستعلام عن التوزيع لتوقعات الهدف والكيانات من خلال كلامك استنادًا إلى النموذج الذي قمت بتعيينه للتوزيع. يمكنك الاستعلام عن التوزيع برمجيًا من خلال واجهة برمجة تطبيقات التنبؤ أو من خلال مكتبات العميل (Azure SDK).

اختبار النموذج المنشور

يمكنك استخدام Language Studio لإرسال كلام، والحصول على تنبؤات وتصور النتائج.

لاختبار النماذج المنشورة من داخل Language Studio:

1. حدد Testing deployments من القائمة اليسري.

2. بالنسبة للمشاريع متعددة اللغات، من القائمة المنسدلة تحديد لغة النص ، حدد لغة التعبير الذي تختبره.

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

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

5. في أعلى الصفحة، حدد تشغيل الاختبار.

6. بعد إجراء الاختبار، يجب أن ترى استجابة النموذج في النتيجة. يمكنك عرض النتائج في عرض بطاقات الكيانات أو عرضها بتنسيق JSON.

---

إرسال طلب لفهم لغة المحادثة

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

1. بعد اكتمال مهمة التوزيع بنجاح، حدد التوزيع الذي تريد استخدامه ومن القائمة العلوية حدد الحصول على عنوان URL للتنبؤ.

   

2. في النافذة التي تظهر، انسخ نموذج عنوان URL للطلب والجسم في سطر الأوامر.

3. استبدل <YOUR_QUERY_HERE> بالنص الفعلي الذي تريد إرساله لاستخراج الأهداف والكيانات منه.

4. POST أرسل الطلب الخاص بـ cURL في الوحدة الطرفية أو موجه الأوامر. تتلقى استجابة 202 بنتائج واجهة برمجة التطبيقات إذا كان الطلب ناجحاً.

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

ستحتاج أولا إلى الحصول على المفتاح الخاص بـ المورد ونقطة النهاية:

انتقل إلى صفحة نظرة عامة على المورد في مدخل Azure من القائمة على الجانب الأيسر، حدد "Keys and Endpoint" . ستستخدم نقطة النهاية والمفتاح لطلبات واجهة برمجة التطبيقات

استعلم عن نموذجك

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

URL للطلب

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

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

الرؤوس

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

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

نص الطلب

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

المفتاح	العنصر النائب	القيمة	مثال
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	الكلام الذي تريد توقع هدفه واستخراج الكيانات منه.	"Read Matt's email
projectName	{PROJECT-NAME}	اسم مشروعك. هذه القيمة حساسة لحالة الأحرف.	myProject
deploymentName	{DEPLOYMENT-NAME}	اسم النشر الخاص بك. هذه القيمة حساسة لحالة الأحرف.	staging

بمجرد إرسال الطلب، سوف تحصل على الرد التالي للتنبؤ

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

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

المفتاح	قيمة النموذج	الوصف
استعلام	"قراءة البريد الإلكتروني الخاص بـ Matt"	النص الذي قدمته للاستعلام.
topIntent	"اقرأ"	الهدف المتوقعة مع أعلى درجة ثقة.
الأهداف	[]	قائمة بكل الأهداف التي تم توقعها لنص الاستعلام لكل منها درجة ثقة.
الكيانات	[]	مصفوفة تحتوي على قائمة بالكيانات المستخرجة من نص الاستعلام.

استجابة واجهة برمجة التطبيقات لمشروع محادثات

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

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

المكتبات الخاصة بالعملاء Azure SDK

استخدام مكتبات العميل (Azure SDK)

يمكنك أيضا استخدام مكتبات العميل التي يوفرها Azure SDK لإرسال الطلبات إلى النموذج الخاص بك.

ملاحظة

تتوفر مكتبة العميل لفهم لغة المحادثة فقط من خلال:

• .NET
• Python

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

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

   

3. قم بتنزيل وتثبيت حزمة مكتبة العميل للغة الخاصة بك التي تختارها:

   اللغة	إصدار الحزمة.
   .NET	1.0.0
   Python	1.0.0

4. بعد تركيب مكتبة العميل، استخدام العينات التالية على GitHub لبدء استدعاء واجهة برمجة التطبيقات.

   • ⁧#C⁧
   • Python

5. راجع الوثائق المرجعية للحصول على مزيد من المعلومات.

   • ⁧#C⁧
   • Python

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

• نظرة عامة على فهم لغة المحادثة