استخدام مطالبات المتابعة لإنشاء عدة أدوار للمحادثة

استخدم مطالبات المتابعة والسياق لإدارة المنعطفات المتعددة، والمعروفة باسم متعدد الأدوار، لبرنامج الروبوت الخاص بك من سؤال إلى آخر.

لمعرفة كيفية عمل المنعطفات المتعددة، شاهد الفيديو التوضيحي التالي:

محادثة متعددة الأدوار في QnA Maker

ملاحظة

سيتم إنهاء خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية السؤال والإجابة كجزء من Azure الذكاء الاصطناعي Language. للحصول على قدرات الإجابة على الأسئلة داخل خدمة اللغات، انظر سؤال الإجابة. بدءًا من 1 أكتوبر 2022 لن تتمكن من إنشاء موارد جديدة لـ QnA Maker. للحصول على معلومات بشأن ترحيل قواعد المعرفة الحالية لـ QnA Maker إلى الإجابة عن الأسئلة، راجع دليل الترحيل.

ما هي المحادثة متعددة الأدوار؟

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

عندما يسأل مستخدم سؤالاً، يعرض QnA Maker الإجابة و أي مطالبات متابعة. يتيح لك هذا الرد تقديم أسئلة المتابعة كخيارات.

تنبيه

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

مثال على محادثة متعددة الأدوار مع روبوت الدردشة

باستخدام متعدد الأدوار، يدير روبوت الدردشة محادثة مع مستخدم لتحديد الإجابة النهائية، كما هو موضح في الصورة التالية:

مربع حوار متعدد الأدوار مع مطالبات توجه المستخدم خلال محادثة

في الصورة السابقة، بدأ المستخدم محادثة بإدخال حسابي. تحتوي قاعدة المعارف على ثلاثة أزواج أسئلة وأجوبة مرتبطة. لتحسين الإجابة، يختار المستخدم أحد الخيارات الثلاثة في قاعدة المعارف. يحتوي السؤال (# 1) على ثلاث مطالبات للمتابعة، والتي يتم تقديمها في روبوت الدردشة على شكل ثلاثة خيارات (# 2).

عندما يقوم المستخدم بتحديد خيار (# 3)، يتم تقديم القائمة التالية لخيارات التنقية (# 4). يستمر هذا التسلسل (# 5) حتى يحدد المستخدم الإجابة الصحيحة والنهائية (# 6).

استخدم متعدد الأدوار في الروبوت

بعد نشر KB الخاص بك، يمكنك تحديد الزر Create Bot لنشر روبوت QnA Maker الخاص بك إلى Azure الذكاء الاصطناعي Bot Service. ستظهر المطالبات في برامج الدردشة التي قمت بتمكينها لبرنامج الروبوت الخاص بك.

قم بإنشاء محادثة متعددة الأدوار من بنية المستند

عند إنشاء قاعدة معرفية، يعرض قسم Populate your KB مربع الاختيار تمكين الاستخراج متعدد الأدوار من عناوين URL أو ملفات .pdf أو .docx.

خانة اختيار لتمكين الاستخراج متعدد الأدوار

عند تحديد هذا الخيار، يقوم QnA Maker باستخراج التسلسل الهرمي الموجود في بنية المستند. يتم تحويل التسلسل الهرمي لمتابعة المطالبات ويعمل جذر التسلسل الهرمي باعتباره QnA الأصل. في بعض المستندات، لا يحتوي جذر التسلسل الهرمي على محتوى، والذي يمكن أن يكون بمثابة إجابة. يمكنك توفير "نص الإجابة الافتراضي" لاستخدامه كنص إجابة بديل لاستخراج مثل هذه التسلسلات الهرمية.

يمكن استنتاج البنية متعددة الأدوار فقط من عناوين URL أو ملفات PDF أو ملفات DOCX. للحصول على مثال للهيكل، اعرض صورة دليل مستخدم Microsoft Surface ملف PDF.

تُظهر لقطة الشاشة مثالاً للهيكل في دليل المستخدم.

بناء وثيقة متعددة الأدوار الخاصة بك

إذا كنت تقوم بإنشاء مستند متعدد الأدوار، فضع في اعتبارك الإرشادات التالية:

  • استخدم العناوين والعناوين الفرعية للدلالة على التسلسل الهرمي. على سبيل المثال، استخدم h1 للإشارة إلى الأصل QnA وh2 للإشارة إلى QnA التي يجب أن تؤخذ على أنها موجه. استخدم حجم عنوان صغير للإشارة إلى التسلسل الهرمي اللاحق. لا تستخدم النمط أو اللون أو أي آلية أخرى للإشارة إلى بنية في المستند الخاص بك، لن يقوم QnA Maker باستخراج المطالبات متعددة الأدوار.

  • يجب كتابة الحرف الأول من العنوان بأحرف كبيرة.

  • لا تنهي العنوان بعلامة استفهام، ?.

  • يمكنك استخدام نموذج المستند كمثال لإنشاء مستند متعدد الأدوار.

إضافة ملفات إلى KB متعدد الأدوار

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

  1. في QnA Maker، حدد قاعدة المعارف الحالية التي تم إنشاؤها باستخدام تمكين الاستخراج متعدد الأدوار من عناوين URL أو ملفات .pdf أو .docx.
  2. انتقل إلى صفحة Settings، وحدد الملف أو عنوان URL المراد إضافته.
  3. احفظ وتدرب على قاعدة المعارف.

تنبيه

دعم استخدام ملف قاعدة معارف TSV أو XLS متعدد الأدوار تم تصديره كمصدر بيانات لقاعدة معارف جديدة أو فارغة غير مدعوم. تحتاج إلى استيراد نوع الملف هذا، من صفحة Settings في بوابة QnA Maker، من أجل إضافة مطالبات مُصدرة متعددة الأدوار إلى قاعدة المعارف.

أنشئ قاعدة معرفية بمطالبات متعددة الأدوار باستخدام Create API

يمكنك إنشاء حالة معرفية بمطالبات متعددة الأدوار باستخدام QnA Maker Create API. تتم إضافة المطالبات في صفيف الخاصية contextprompts.

اعرض الأسئلة والأجوبة مع السياق

قم بتقليل أزواج الأسئلة والأجوبة المعروضة إلى الأزواج ذات المحادثات السياقية فقط.

حدد View options، ثم حدد Show context. تعرض القائمة أزواج الأسئلة والأجوبة التي تحتوي على مطالبات للمتابعة.

تصفية أزواج الأسئلة والأجوبة حسب المحادثات السياقية

يتم عرض السياق متعدد الأدوار في العمود الأول.

لقطة شاشة تعرض قسم السياق مميزاً.

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

أضف زوجاً موجوداً من الأسئلة والأجوبة كمطالبة متابعة

يحتوي السؤال الأصلي، حسابي، على رسائل متابعة، مثل الحسابات وتسجيل الدخول.

إجابات

أضف مطالبة متابعة إلى زوج أسئلة وأجوبة موجود غير مرتبط حالياً. نظراً لأن السؤال غير مرتبط بأي زوج من الأسئلة والأجوبة، يجب تغيير إعداد العرض الحالي.

  1. لربط زوج الأسئلة والأجوبة الموجود كموجه متابعة، حدد الصف الخاص بزوج الأسئلة والأجوبة. بالنسبة إلى دليل Surface، ابحث عن تسجيل الخروج لتقليل القائمة.

  2. في صف Signout، في عمود Answer، حدد Add follow-up prompt.

  3. في الحقول الموجودة في النافذة المنبثقة Follow-up prompt، أدخل القيم التالية:

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

    صفحة

  5. بعد إضافة مطالبة المتابعة، حدد Save and train في شريط التنقل العلوي.

قم بتحرير نص العرض

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

  1. لتعديل نص العرض، ابحث عن السؤال وحدده في حقل Context.

  2. في صف هذا السؤال، حدد مطالبة المتابعة في عمود الإجابة.

  3. حدد نص العرض الذي تريد تعديله، ثم حدد Edit.

    أمر تحرير لنص العرض

  4. في النافذة المنبثقة Follow-up prompt، قم بتغيير نص العرض الحالي.

  5. عند الانتهاء من تحرير نص العرض، حدد Save.

  6. في شريط التنقل العلوي، Save and train.

أضف زوجاً جديداً من الأسئلة والأجوبة كمطالبة متابعة

عند إضافة زوج جديد من الأسئلة والأجوبة إلى قاعدة المعارف، يجب ربط كل زوج بسؤال موجود كموجه متابعة.

  1. في شريط أدوات قاعدة المعارف، ابحث عن زوج الأسئلة والأجوبة الحالي وحدده لـ الحسابات وتسجيل الدخول.

  2. في عمود Answer لهذا السؤال، حدد Add follow-up prompt.

  3. ضمن Follow-up prompt (PREVIEW)، أنشئ مطالبة متابعة جديدة بإدخال القيم التالية:

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

    قم بإنشاء سؤال وجواب سريع جديد

  4. حدد Create new، ثم حدد Save.

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

  5. حدد View options، ثم حدد Show context (PREVIEW).

    يوضح السؤال الجديد كيف يتم ربطه.

    قم بإنشاء مطالبة متابعة جديدة

    يعرض السؤال الأصل سؤالاً جديداً كأحد اختياراته.

    تُظهر لقطة الشاشة عمود السياق، لكلا السؤالين، يشير إلى علاقة متابعة فورية.

  6. بعد إضافة مطالبة المتابعة، حدد Save and train في شريط التنقل العلوي.

عرض متعدد الأدوار أثناء اختبار مطالبات المتابعة

عندما تختبر السؤال بمطالبات المتابعة في جزء Test، تتضمن الاستجابة مطالبات المتابعة.

تتضمن الاستجابة مطالبات المتابعة

طلب JSON لإرجاع إجابة أولية ومطالبات المتابعة

استخدم العنصر الفارغ context لطلب إجابة لسؤال المستخدم وتضمين مطالبات المتابعة.

{
  "question": "accounts and signing in",
  "top": 10,
  "userId": "Default",
  "isTest": false,
  "context": {}
}

استجابة JSON لإرجاع إجابة أولية ومطالبات المتابعة

طلب القسم السابق إجابة وأي مطالبات متابعة لـ الحسابات وتسجيل الدخول. تتضمن الاستجابة المعلومات الفورية الموجودة في answers[0].contextوالنص الذي سيتم عرضه للمستخدم.

{
    "answers": [
        {
            "questions": [
                "Accounts and signing in"
            ],
            "answer": "**Accounts and signing in**\n\nWhen you set up your Surface, an account is set up for you. You can create additional accounts later for family and friends, so each person using your Surface can set it up just the way he or she likes. For more info, see All about accounts on Surface.com. \n\nThere are several ways to sign in to your Surface Pro 4: ",
            "score": 100.0,
            "id": 15,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 16,
                        "qna": null,
                        "displayText": "Use the sign-in screen"
                    }
                ]
            }
        },
        {
            "questions": [
                "Sign out"
            ],
            "answer": "**Sign out**\n\nHere's how to sign out: \n\n  Go to Start, and right-click your name. Then select Sign out. ",
            "score": 38.01,
            "id": 18,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 16,
                        "qna": null,
                        "displayText": "Turn off the device"
                    }
                ]
            }
        },
        {
            "questions": [
                "Use the sign-in screen"
            ],
            "answer": "**Use the sign-in screen**\n\n1.  \n\nTurn on or wake your Surface by pressing the power button. \n\n2.  \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3.  \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4.  \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
            "score": 27.53,
            "id": 16,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        }
    ]
}

توفر صفيف prompts نصاً في خاصية displayText وقيمة qnaId. يمكنك إظهار هذه الإجابات كخيارات معروضة تالية في تدفق المحادثة ثم إرسال qnaId المحدد مرة أخرى إلى QnA Maker في الطلب التالي.

طلب JSON لإرجاع إجابة غير أولية ومطالبات المتابعة

املأ العنصر context لتضمين السياق السابق.

في طلب JSON التالي، السؤال الحالي هو استخدام Windows Hello لتسجيل الدخول والسؤال السابق كان الحسابات وتسجيل الدخول.

{
  "question": "Use Windows Hello to sign in",
  "top": 10,
  "userId": "Default",
  "isTest": false,
  "qnaId": 17,
  "context": {
    "previousQnAId": 15,
    "previousUserQuery": "accounts and signing in"
  }
}

استجابة JSON لإرجاع إجابة غير أولية ومطالبات المتابعة

تتضمن استجابة JSON لـ QnA Maker GenerateAnswer مطالبات المتابعة في خاصية context للعنصر الأول في العنصر answers :

{
    "answers": [
        {
            "questions": [
                "Use Windows Hello to sign in"
            ],
            "answer": "**Use Windows Hello to sign in**\n\nSince Surface Pro 4 has an infrared (IR) camera, you can set up Windows Hello to sign in just by looking at the screen. \n\nIf you have the Surface Pro 4 Type Cover with Fingerprint ID (sold separately), you can set up your Surface sign you in with a touch. \n\nFor more info, see What is Windows Hello? on Windows.com. ",
            "score": 100.0,
            "id": 17,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        },
        {
            "questions": [
                "Meet Surface Pro 4"
            ],
            "answer": "**Meet Surface Pro 4**\n\nGet acquainted with the features built in to your Surface Pro 4. \n\nHere's a quick overview of Surface Pro 4 features: \n\n\n\n\n\n\n\nPower button \n\n\n\n\n\nPress the power button to turn your Surface Pro 4 on. You can also use the power button to put it to sleep and wake it when you're ready to start working again. \n\n\n\n\n\n\n\nTouchscreen \n\n\n\n\n\nUse the 12.3" display, with its 3:2 aspect ratio and 2736 x 1824 resolution, to watch HD movies, browse the web, and use your favorite apps. \n\nThe new Surface G5 touch processor provides up to twice the touch accuracy of Surface Pro 3 and lets you use your fingers to select items, zoom in, and move things around. For more info, see Surface touchscreen on Surface.com. \n\n\n\n\n\n\n\nSurface Pen \n\n\n\n\n\nEnjoy a natural writing experience with a pen that feels like an actual pen. Use Surface Pen to launch Cortana in Windows or open OneNote and quickly jot down notes or take screenshots. \n\nSee Using Surface Pen (Surface Pro 4 version) on Surface.com for more info. \n\n\n\n\n\n\n\nKickstand \n\n\n\n\n\nFlip out the kickstand and work or play comfortably at your desk, on the couch, or while giving a hands-free presentation. \n\n\n\n\n\n\n\nWi-Fi and Bluetooth® \n\n\n\n\n\nSurface Pro 4 supports standard Wi-Fi protocols (802.11a/b/g/n/ac) and Bluetooth 4.0. Connect to a wireless network and use Bluetooth devices like mice, printers, and headsets. \n\nFor more info, see Add a Bluetooth device and Connect Surface to a wireless network on Surface.com. \n\n\n\n\n\n\n\nCameras \n\n\n\n\n\nSurface Pro 4 has two cameras for taking photos and recording video: an 8-megapixel rear-facing camera with autofocus and a 5-megapixel, high-resolution, front-facing camera. Both cameras record video in 1080p, with a 16:9 aspect ratio. Privacy lights are located on the right side of both cameras. \n\nSurface Pro 4 also has an infrared (IR) face-detection camera so you can sign in to Windows without typing a password. For more info, see Windows Hello on Surface.com. \n\nFor more camera info, see Take photos and videos with Surface and Using autofocus on Surface 3, Surface Pro 4, and Surface Book on Surface.com. \n\n\n\n\n\n\n\nMicrophones \n\n\n\n\n\nSurface Pro 4 has both a front and a back microphone. Use the front microphone for calls and recordings. Its noise-canceling feature is optimized for use with Skype and Cortana. \n\n\n\n\n\n\n\nStereo speakers \n\n\n\n\n\nStereo front speakers provide an immersive music and movie playback experience. To learn more, see Surface sound, volume, and audio accessories on Surface.com. \n\n\n\n\n",
            "score": 21.92,
            "id": 3,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 4,
                        "qna": null,
                        "displayText": "Ports and connectors"
                    }
                ]
            }
        },
        {
            "questions": [
                "Use the sign-in screen"
            ],
            "answer": "**Use the sign-in screen**\n\n1.  \n\nTurn on or wake your Surface by pressing the power button. \n\n2.  \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3.  \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4.  \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
            "score": 19.04,
            "id": 16,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        }
    ]
}

استعلم عن قاعدة المعارف باستخدام معرف QnA Maker

إذا كنت تنشئ تطبيقاً مخصصاً، في استجابة السؤال الأولي، يتم عرض أي مطالبات متابعة وqnaId المرتبط بها. الآن بعد أن أصبح لديك المعرف، يمكنك تمريره في نص طلب موجه المتابعة. إذا كان نص الطلب يحتوي على qnaId، وعنصر السياق (الذي يحتوي على خصائص QnA Maker السابقة)، فسيعيد GenerateAnswer السؤال الدقيق حسب المعرف، بدلاً من استخدام خوارزمية الترتيب للعثور على الإجابة بنص السؤال.

ترتيب العرض مدعوم في Update API

يتم دعم نص العرض وترتيب العرض، المعروض في استجابة JSON، للتحرير بواسطة واجهة برمجة التطبيقات للتحديث.

إضافة أو حذف المطالبات متعددة الأدوار باستخدام Update API

يمكنك إضافة أو حذف المطالبات متعددة الأدوار باستخدام QnA Maker Update API. تتم إضافة المطالبات في صفيف الخاصية contextpromptsToAdd والصفيف promptsToDelete.

تصدير قاعدة المعارف للتحكم في الإصدار

يدعم QnA Maker التحكم في الإصدار من خلال تضمين خطوات المحادثة متعددة الأدوار في الملف المصدر.

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