اختبر قاعدة معارفك في QnA Maker

يعد اختبار قاعدة معارف QnA Maker جزءاً مهماً من عملية تكرارية لتحسين دقة الردود التي يتم إرجاعها. يمكنك اختبار قاعدة المعارف من خلال واجهة دردشة محسنة تتيح لك أيضاً إجراء تعديلات.

إشعار

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

اختبار تفاعلي في مدخل QnA Maker

1. قم بالوصول إلى قاعدة المعارف الخاصة بك عن طريق تحديد اسمها في صفحة قواعد المعرفة الخاصة بي.
2. للوصول إلى لوحة الاختبار المنزلق، حدد Test في اللوحة العلوية للتطبيق.
3. أدخل استعلاماً في مربع النص وحدد إدخال.
4. يتم إرجاع أفضل إجابة مطابقة من قاعدة المعارف كاستجابة.

مسح لوحة الاختبار

لمسح جميع استعلامات الاختبار التي تم إدخالها ونتائجها من وحدة تحكم الاختبار، حدد Start over في الزاوية العلوية اليسرى من لوحة الاختبار.

أغلق لوحة الاختبار

لإغلاق لوحة الاختبار، حدد الزر Test مرة أخرى. خلال فتح لوحة الاختبار، لا يمكنك تحرير محتويات قاعدة المعارف.

فحص النتيجة

تستطيع أن تفحص تفاصيل نتيجة الاختبار في لوحة الفحص.

1. مع فتح لوحة الاختبار المنزلق، حدد Inspect لمزيد من التفاصيل بشأن هذه الاستجابة.

   

2. تظهر لوحة الفحص. تشتمل اللوحة على هدف التسجيل الأعلى بالإضافة إلى أي كيانات محددة. تعرض اللوحة نتيجة الكلام المحدد.

تصحيح أعلى الدرجات الإجابة

إذا كانت إجابة أعلى الدرجات غير صحيحة، فحدد الإجابة الصحيحة من القائمة وحدد Save and Train.

إضافة أسئلة بديلة

يمكنك إضافة نماذج بديلة للسؤال إلى إجابة معينة. اكتب الإجابات البديلة في مربع النص وحدد إدخال لإضافتها. حدد Save and Train لتخزين التحديثات.

أضف إجابة جديدة

يمكنك إضافة إجابة جديدة إذا كانت أي من الإجابات الموجودة التي تمت مطابقتها غير صحيحة أو لم تكن الإجابة موجودة في قاعدة المعارف (لم يتم العثور على تطابق جيد في قاعدة المعارف).

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

حدد Save and Train لاستمرار هذه الإجابة. تمت الآن إضافة زوج جديد من الأسئلة والأجوبة إلى قاعدة معارفك.

إشعار

لا يتم حفظ جميع التعديلات التي تم إجراؤها على قاعدة معارفك إلا عند الضغط على الزر Save and Train.

اختبر قاعدة المعارف المنشورة

يمكنك اختبار الإصدار المنشور من قاعدة المعارف في جزء الاختبار. بمجرد نشر قاعدة المعارف، حدد مربع Published KB وأرسل استعلاماً للحصول على نتائج من قاعدة المعارف المنشورة.

اختبار الدفعة مع الأداة

استخدم أداة اختبار الدُفعات عندما تريد:

• تحديد أعلى إجابة ودرجة لمجموعة من الأسئلة
• التحقق من صحة الإجابة المتوقعة لمجموعة من الأسئلة

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

• اشتراك Azure - إنشاء اشتراك مجاني
• إما أن تقوم بإنشاء خدمة QnA Maker أو استخدام خدمة موجودة تستخدم اللغة الإنجليزية.
• قم بتنزيل multi-turn sample .docx file
• قم بتنزيل batch testing tool، واستخرج الملف القابل للتنفيذ من ملف .zip.

قم بتسجيل الدخول إلى مدخل QnA Maker

سجّل الدخول إلى مدخل QnA Maker.

إنشاء قاعدة معرفية جديدة من ملف sample.docx متعدد الدورات

1. حدد Create a knowledge base من شريط الأدوات.

2. تجاوز الخطوة 1 لأنه يجب أن يكون لديك بالفعل مورد QnA Maker، وانتقل إلى الخطوة 2 لتحديد معلومات المورد الحالية:

   • Microsoft Entra ID
   • اسم اشتراك Azure
   • اسم خدمة Azure QnA
   • اللغة - اللغة الإنجليزية

3. أدخل الاسم Multi-turn batch test quickstart كاسم لقاعدة المعارف الخاصة بك.

4. في الخطوة 4، كوِّن الإعدادات باستخدام الجدول التالي:

   الإعداد	القيمة‬
   تمكين الاستخراج متعدد الأدوار من عناوين URL أو ملفات بتنسيق .pdf أو .docx.	محدد
   نص الإجابة الافتراضي	Batch test - default answer not found.
   + Add File	حدد قائمة الملفات التي تم تنزيلها .docx في المتطلبات الأساسية.
   المحادثات التلقائية	حدد Professional

5. في Step 5، حدد Create your KB.

   عند انتهاء عملية الإنشاء، تعرض المدخل قاعدة المعارف القابلة للتحرير.

حفظ وتدريب ونشر قاعدة المعارف

1. حدد Save and train من شريط الأدوات لحفظ قاعدة المعارف.

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

   البيانات المطلوبة	مثال
   المضيف المنشور	https://YOUR-RESOURCE-NAME.azurewebsites.net
   المفتاح المنشور	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX (يتم عرض سلسلة مكونة من 32 حرفاً بعد Endpoint )
   معرف التطبيق	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (يتم عرض سلسلة مكونة من 36 حرفاً كجزء من POST)

إنشاء ملف اختبار دفعي مع معرفات الأسئلة

من أجل استخدام أداة اختبار الدُفعات، قم بإنشاء ملف باسم batch-test-data-1.tsv باستخدام محرر نصوص. يجب أن يكون الملف بتنسيق UTF-8 ويجب أن تكون الأعمدة التالية مفصولة بعلامة تبويب.

حقول ملف الإدخال TSV	الملاحظات	مثال
معرف قاعدة المعرفة	تم العثور على معرف قاعدة المعارف الخاص بك في صفحة النشر. اختبر عدة قواعد معرفية في نفس الخدمة في وقت واحد في ملف واحد باستخدام معرفات قاعدة معرفية مختلفة في ملف واحد.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (يتم عرض سلسلة مكونة من 36 حرفاً كجزء من POST)
السؤال	نص السؤال الذي سيدخله المستخدم. 1000 حرف كحد أقصى.	How do I sign out?
علامات بيانات التعريف	اختياري	topic:power يستخدم تنسيق key:value
أعلى المعلمة	اختياري	25
معرف الإجابة المتوقعة	اختياري	13

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

العمود 2 - الأسئلة
Use Windows Hello to sign in
Charge your Surface Pro 4
Get to know Windows 10

هذه الأسئلة هي الصياغة الدقيقة من قاعدة المعارف ويجب أن تعود 100 على أنها درجة الثقة.

بعد ذلك، أضف بعض الأسئلة، على غرار هذه الأسئلة ولكن ليس بالضبط نفس الشيء في ثلاثة صفوف أخرى، باستخدام نفس معرف قاعدة المعارف:

العمود 2 - الأسئلة
What is Windows Hello?
How do I charge the laptop?
What features are in Windows 10?

تنبيه

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

يبدو ملف الاختبار الدفعي، عند فتحه في Excel، مثل الصورة التالية. تم استبدال معرف قاعدة المعارف بـ xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx للأمان. بالنسبة للاختبار الدُفعي الخاص بك، تأكد من أن العمود يعرض معرف قاعدة المعارف الخاصة بك.

اختبر الملف الدفعي

قم بتشغيل برنامج اختبار الدُفعات باستخدام تنسيق CLI التالي في سطر الأوامر.

استبدل YOUR-RESOURCE-NAME وENDPOINT-KEY بقيمك الخاصة لاسم الخدمة ومفتاح نقطة النهاية. تم العثور على هذه القيم في صفحة Settings في مدخل QnA Maker.

batchtesting.exe batch-test-data-1.tsv https://YOUR-RESOURCE-NAME.azurewebsites.net ENDPOINT-KEY out.tsv

يكتمل الاختبار وينشئ ملف out.tsv:

تم استبدال معرف قاعدة المعارف بـ xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx للأمان. بالنسبة للاختبار الدُفعي الخاص بك، يعرض العمود معرف قاعدة المعارف الخاصة بك.

يُظهر ناتج اختبار درجة الثقة، في العمود الرابع، أن الأسئلة الثلاثة الأولى عادت بدرجة 100 كما هو متوقع لأن كل سؤال هو نفسه تماماً كما يظهر في قاعدة المعارف. الأسئلة الثلاثة الأخيرة، مع صياغة جديدة للسؤال، لا تعيد 100 درجة الثقة. من أجل زيادة النتيجة لكل من الاختبار والمستخدمين، تحتاج إلى إضافة المزيد من الأسئلة البديلة إلى قاعدة المعارف.

اختبار مع الحقول الاختيارية

بمجرد فهم التنسيق والعملية، يمكنك إنشاء ملف اختبار، لتشغيله مقابل قاعدة المعارف الخاصة بك من مصدر بيانات مثل سجلات الدردشات.

نظراً لأن مصدر البيانات والعملية يتم تشغيلهما تلقائياً، يمكن تشغيل ملف الاختبار عدة مرات بإعدادات مختلفة لتحديد القيم الصحيحة.

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

استخدام الحقول الاختيارية في ملف اختبار دفعة الإدخال

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

رقم العمود	عمود اختياري	موقع البيانات
3	بيانات التعريف	تصدير قاعدة المعارف الحالية لأزواج key:value الموجودة.
4	أعلى	يوصى باستخدام القيمة الافتراضية لـ 25.
5	معرف مجموعة السؤال والجواب	تصدير قاعدة المعارف الحالية لقيم المعرفات. لاحظ أيضاً أنه تم إرجاع المعرفات في ملف الإخراج.

أضف بيانات التعريف إلى قاعدة المعارف

1. في مدخل QnA، في صفحة Edit، أضف بيانات التعريف لـ topic:power إلى الأسئلة التالية:

   الأسئلة
   اشحن جهاز Surface Pro 4
   تحقق من مستوى البطارية

   يحتوي زوجان QnA على مجموعة بيانات التعريف.

   تلميح

   لمشاهدة بيانات التعريف ومعرفات QnA لكل مجموعة، قم بتصدير قاعدة المعارف. حدد صفحة Settings، ثم حدد Export كملف .xls. ابحث عن هذا الملف الذي تم تنزيله وافتحه باستخدام Excel لمراجعة بيانات التعريف والمعرف.

2. حدد Save and train، ثم حدد صفحة Publish، ثم حدد الزر Publish. تجعل هذه الإجراءات التغيير متاحاً لاختبار الدُفعة. قم بتنزيل قاعدة المعارف من صفحة Settings.

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

   

قم بإنشاء اختبار دفعة ثانية

هناك سيناريوهان رئيسيان لاختبار الدُفعات:

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

يفترض الإجراء التالي أن السيناريو هو معالجة سجلات الدردشة باستخدام

1. قم بإنشاء ملف اختبار دفعي جديد لتضمين البيانات الاختيارية، batch-test-data-2.tsv. أضف الصفوف الستة من ملف إدخال اختبار الدُفعة الأصلي، ثم أضف بيانات التعريف، ومعرف الزوج العلوي، ومعرف QnA لكل صف.

   لمحاكاة العملية الآلية لفحص النص الجديد من سجلات الدردشة مقابل قاعدة المعارف، قم بتعيين بيانات التعريف لكل عمود على نفس القيمة: topic:power.

   

2. قم بإجراء الاختبار مرة أخرى، وقم بتغيير أسماء ملفات الإدخال والإخراج للإشارة إلى أنه الاختبار الثاني.

   

نتائج الاختبار ونظام اختبار آلي

يمكن تحليل ملف مخرجات الاختبار هذا كجزء من تدفق اختبار مستمر آلي.

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

عرضت جميع الصفوف تسمية غير صحيحة لأنه لا يوجد صف يطابق معرف الإجابة المتوقع.

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

• بيانات التعريف
• معرف QnA
• score

هل كانت التصفية باستخدام بيانات التعريف فكرة جيدة للاختبار؟ نعم ولا. يجب أن يُنشئ نظام الاختبار ملفات اختبار لكل زوج بيانات تعريف بالإضافة إلى اختبار دون أزواج بيانات تعريف.

تنظيف الموارد

إذا كنت لا تريد متابعة اختبار قاعدة المعارف، فاحذف أداة الملفات الدفعية وملفات الاختبار.

إذا كنت لن تستمر في استخدام قاعدة المعارف هذه، فاحذف القاعدة المعرفية من خلال الخطوات التالية:

1. في مدخل QnA Maker، حدد My Knowledge bases من القائمة العلوية.
2. في قائمة قواعد المعرفة، حدد رمز Delete الموجود في صف قاعدة المعارف الخاصة ببداية التشغيل السريع.

تتضمن الوثائق المرجعية بشأن الأداة ما يلي:

• مثال سطر الأوامر للأداة
• تنسيق ملفات الإدخال والإخراج بتنسيق TSV

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

نشر قاعدة معارف