Share via

إرشادات التنسيق للمستندات وعناوين URL المستوردة

  • مقالة

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

اعتبارات التنسيق

بعد استيراد ملف أو عنوان URL، يحول QnA Maker المحتوى ويخزنه بتنسيق markdown. تضيف عملية التحويل سطوراً جديدة في النص، مثل \n\n. تساعدك معرفة تنسيق markdown على فهم المحتوى المحول وإدارة محتوى قاعدة المعارف.

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

راجع القائمة الكاملة لأنواع المحتويات والأمثلة.

تنسيق المستند الأساسي

يحدد QnA Maker الأقسام والأقسام الفرعية والعلاقات في الملف استناداً إلى أدلة مرئية مثل:

  • حجم الخط
  • نمط الخط
  • الترقيم
  • الألوان

إشعار

لا ندعم استخراج الصور من المستندات التي تم تحميلها حالياً.

كتيبات المنتج

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

فيما يلي مثال على دليل يتضمن صفحة فهرس ومحتوى هرمي

Product Manual example for a knowledge base

إشعار

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

الكتيبات والإرشادات والأوراق والملفات الأخرى

يمكن أيضاً معالجة العديد من أنواع المستندات الأخرى لإنشاء إقران QA، بشرط أن يكون لها بنية وتخطيط واضحين. وتشمل: الكتيبات والأدلة الإرشادية والتقارير والمستندات التقنية والأوراق العلمية والنُهج والكتب وما إلى ذلك. راجع مثالاً هنا.

فيما يلي مثال على مستند شبه منظم دون فهرس:

Azure Blob storage semi-structured Doc

دعم المستندات غير المنظمة

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

فيما يلي مثال على مستند PDF غير مهيكل:

Unstructured document example for a knowledge base

تتوفر هذه الوظيفة حالياً فقط عبر تحميل المستند وتنسيقات ملفات PDF وDOC فقط.

هام

يتم دعم الملف/المحتوى غير المهيكل فقط في الإجابة عن الأسئلة.

مستند QnA مهيكل

تنسيق Question-Answers المهيكل في ملفات DOC، هو في شكل أسئلة وأجوبة بالتناوب لكل سطر، سؤال واحد لكل سطر متبوعاً بإجابته في السطر التالي، كما هو موضح أدناه:

Question1

Answer1

Question2

Answer2

فيما يلي مثال على مستند كلمة QnA مهيكل:

Structured QnA document example for a knowledge base

ملفات TXTوTSVوXLS مهيكلة

يمكن أيضا تحميل QnAs في شكل ملفات .txtأو .tsv أو .xls مهيكلة إلى QnA Maker لإنشاء قاعدة معارف أو زيادتها. يمكن أن تكون هذه إما نصاً عادياً، أو يمكن أن تحتوي على محتوى في RTF أو HTML. تحتوي إقران السؤال والجواب على حقل بيانات تعريف اختياري يمكن استخدامه لتجميع أزواج QnA في فئات.

السؤال الإجابة بيانات التعريف (1 مفتاح: 1 قيمة)
Question1 الإجابة1 Key1:Value1 | Key2:Value2
Question2 الإجابة2 Key:Value

يتم تجاهل أي أعمدة إضافية في الملف المصدر.

مثال على ملف Excel مهيكل

فيما يلي مثال على ملف QnA .xls مهيكل، مع محتوى HTML:

Structured QnA excel example for a knowledge base

مثال على أسئلة بديلة لإجابة واحدة في ملف Excel

فيما يلي مثال على ملف QnA .xls مهيكل، مع عدة أسئلة بديلة لإجابة واحدة:

Example of alternate questions for single answer in Excel file

بعد استيراد الملف، يكون إقران السؤال والجواب في قاعدة معارف كما هو موضح أدناه:

Screenshot of alternate questions for single answer imported into knowledge base

تنسيق البيانات المهيكلة من خلال الاستيراد

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

السؤال الإجابة المصدر بيانات التعريف (1 مفتاح: 1 قيمة)
Question1 الإجابة1 Url1 Key1:Value1 | Key2:Value2
Question2 الإجابة2 قابل للتحرير Key:Value

تنسيق المستند متعدد الأدوار

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

نماذج المستندات:
Surface Pro (docx)
مزايا Contoso (docx)
مزايا Contoso (pdf)

عناوين URL للأسئلة المتداولة

يمكن أن يدعم QnA Maker صفحات ويب الأسئلة المتداولة في 3 نماذج مختلفة:

  • صفحات الأسئلة المتداولة العادية
  • صفحات الأسئلة المتداولة ذات الارتباطات
  • صفحات الأسئلة المتداولة مع الصفحة الرئيسية للمواضيع

صفحات الأسئلة المتداولة العادية

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

فيما يلي مثال على صفحة الأسئلة المتداولة العادية:

Plain FAQ page example for a knowledge base

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

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

Section Link FAQ page example for a knowledge base

ارتباطات صفحة الموضوعات الأصل إلى صفحات إجابات تابعة

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

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

Deep link FAQ page example for a knowledge base

دعم عناوين URL

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

إشعار

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

QnA Maker supports extraction from semi-structured web pages where a clear structure is presented with hierarchical headings

استيراد وتصدير قاعدة معارف

لا يمكن استخدام ملفات TSV وXLS، من قواعد المعارف المصدرة، إلا عن طريق استيراد الملفات من صفحة الإعدادات في مدخل QnA Maker. لا يمكن استخدامها كمصادر بيانات أثناء إنشاء قاعدة معارف أو من ميزة + إضافة ملف أو + إضافة عنوان URL في صفحة الإعدادات.

عند استيراد قاعدة المعارف من خلال ملفات TSV وXLS هذه، يُضاف إقران السؤال والجواب إلى المصدر التحريري وليس المصادر التي تم استخراج QnAs منها في قاعدة المعارف المصدرة.

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

الاطلاع على قائمة كاملة لأنواع المحتويات والأمثلة