استكشاف الأخطاء وإصلاحها في خدمة QnA Maker
ستساعدك القائمة المنسقة للأسئلة الأكثر تداولاً فيما يتعلق بخدمة QnA Maker على اعتماد الخدمة بشكل أسرع وبنتائج أفضل.
إشعار
ستتوقف خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية السؤال والإجابة كجزء من Azure الذكاء الاصطناعي Language. للحصول على إمكانيات الإجابة على الأسئلة داخل خدمة اللغة، راجع الإجابة على الأسئلة. اعتبارًا من 1 أكتوبر 2022، لن تتمكن من إنشاء موارد QnA Maker جديدة. للحصول على معلومات عن ترحيل قواعد معارف صانع QnA الحالية إلى الإجابة على الأسئلة، راجع دليل الترحيل .
إدارة التنبؤات
كيف يمكنني تحسين أداء معدل النقل لتنبؤات الاستعلام؟
الإجابة: تشير مشكلات أداء معدل النقل إلى أنك بحاجة إلى توسيع نطاق خدمة التطبيق والبحث المعرفي على حدٍّ سواء. ضع في اعتبارك إضافة نسخة طبق الأصل إلى البحث المعرفي لتحسين الأداء.
تعرف على المزيد حول طبقات الأسعار.
كيفية الحصول على نقطة نهاية خدمة QnAMaker
الإجابة: نقطة نهاية خدمة QnAMaker مفيدة لأغراض تصحيح الأخطاء عند الاتصال بدعم خدمة QnAMaker أو UserVoice. نقطة النهاية هي عنوان URL في هذا النموذج: https://your-resource-name.azurewebsites.net.
قم بالانتقال إلى خدمة QnAMaker (مجموعة الموارد) في مدخل Microsoft Azure
حدد خدمة التطبيق المرتبطة بمورد QnA Maker. عادة ما تكون الأسماء هي نفسها.
يتاح عنوان URL لنقطة النهاية في قسم نظرة عامة
إدارة قاعدة المعارف
لقد حذفت عن طريق الخطأ جزءًا من QnA Maker، ماذا يجب أن أفعل؟
الإجابة: لا تحذف أيًا من خدمات Azure التي تم إنشاؤها جنبًا إلى جنب مع مورد QnA Maker مثل البحث أو تطبيق الويب. إنها ضرورية لعمل QnA Maker، إذا قمت بحذف واحدة، فستتوقف QnA Maker عن العمل بشكل صحيح.
جميع عمليات الحذف دائمة، بما في ذلك أزواج الأسئلة والأجوبة، أو الملفات، أو عناوين URL، أو الأسئلة والأجوبة المخصصة، أو قواعد المعارف، أو موارد Azure. تأكد من تصدير قاعدة المعارف من صفحة الإعدادات قبل حذف أي جزء من قاعدة المعارف.
لماذا لا يستخرج عنوان (عناوين) URL/الملف (الملفات) أزواج الأسئلة والأجوبة؟
الإجابة: من المحتمل ألا تتمكن QnA Maker من استخراج بعض محتوى الأسئلة والأجوبة (QnA) تلقائيًا من عناوين URL للأسئلة المتداولة الصالحة. في مثل هذه الحالات، يمكنك لصق محتوى QnA في ملف .txt ومعرفة ما إذا كان بإمكان الأداة استيعابه. بدلاً من ذلك، يمكنك إضافة المحتوى بشكل تحريري إلى قاعدة المعارف من خلال مدخل QnA Maker.
ما حجم قاعدة المعارف التي يمكنني إنشاؤها؟
الإجابة: يعتمد حجم قاعدة المعارف على SKU لبحث Azure الذي تختاره عند إنشاء خدمة QnA Maker. اقرأ here لمزيد من التفاصيل.
لماذا لا يمكنني رؤية أي شيء في القائمة المنسدلة عندما أحاول إنشاء قاعدة معارف جديدة؟
الإجابة: لم تقم بإنشاء أي من خدمات QnA Maker في Azure حتى الآن. اقرأ هنا لتعلم كيفية القيام بذلك.
هل أشارك قاعدة المعارف مع الآخرين؟
الإجابة: المشاركة تعمل على مستوى خدمة QnA Maker، أي أنه ستتم مشاركة جميع قواعد المعارف في الخدمة. اقرأ هنا لمعرفة كيفية التعاون في قاعدة معارف.
هل يمكنك مشاركة قاعدة معارف مع مساهم ليس في نفس مستأجر Microsoft Azure Active Directory، لتعديل قاعدة المعارف؟
الإجابة: تستند المشاركة إلى التحكم في الوصول استنادًا إلى الدور في Azure. إذا كان بإمكانك مشاركة أي مورد في Azure مع مستخدم آخر، فإنه يمكنك أيضًا مشاركة QnA Maker.
إذا كان لديك خطة خدمة التطبيق مع 5 قواعد معارف QnAMaker. هل يمكنك تعيين حقوق القراءة/الكتابة إلى 5 مستخدمين مختلفين حتى يتمكن كل منهم من الوصول فقط إلى قاعدة معارف QnAMaker واحدة؟
الإجابة: يمكنك مشاركة خدمة QnAMaker كاملة، وليس قواعد المعارف الفردية.
كيف يمكنني تغيير الرسالة الافتراضية عندما لا يتم العثور على تطابق جيد؟
الإجابة: الرسالة الافتراضية هي جزء من الإعدادات في خدمة التطبيق الخاصة بك.
- انتقل إلى مورد خدمة التطبيق الخاص بك في مدخل Microsoft Azure
- حدد الخيار الإعدادات
- قم بتغيير قيمة الإعداد الإجابة الافتراضية
- إعادة تشغيل خدمة التطبيق الخاصة بك
لماذا لا يتم استخراج ارتباط SharePoint الخاص بي ؟
الإجابة: انظر مواقع مصادر البيانات لمزيد من المعلومات.
التحديثات التي أجريتها على قاعدة المعارف الخاصة بي لا تنعكس على النشر. لمَ لا؟
الإجابة: يجب حفظ كل عملية تحرير، سواء في تحديث الجدول أو الاختبار أو الإعداد، قبل نشرها. تأكد من تحديد الزر حفظ وتدريب بعد كل عملية تحرير.
هل تدعم قاعدة المعارف البيانات الغنية أو الوسائط المتعددة؟
الإجابة:
الاستخراج التلقائي للوسائط المتعددة للملفات وعناوين URL
- عناوين URL - قدرة تحويل HTML-to-Markdown محدودة.
- الملفات - غير مدعوم
الإجابة عن النص في markdown
بمجرد أن تصبح أزواج QnA متاحة في قاعدة المعارف، يمكنك تحرير نص markdown الخاص بالإجابة لتضمين روابط ارتباطات إلى الوسائط المتاحة من عناوين URL العامة.
هل تدعم QnA Maker اللغات غير الإنجليزية؟
الإجابة: انظر المزيد من التفاصيل حول اللغات المدعومة.
إذا كنت تمتلك محتوى من لغات متعددة، فتأكد من إنشاء خدمة منفصلة لكل لغة.
إدارة الخدمة
متى يجب أن أعيد تشغيل خدمة التطبيق؟
الإجابة: قم بتحديث خدمة التطبيق الخاصة بك عندما تكون أيقونة التحذير بجوار قيمة الإصدار لقاعدة المعارف في جدول مفاتيح نقطة النهاية في صفحةإعدادات المستخدم.
لقد حذفت خدمة البحث الحالية. كيف يمكنني إصلاح ذلك؟
الإجابة: إذا قمت بحذف فهرس Azure الذكاء الاصطناعي Search، تكون العملية نهائية ولا يمكن استرداد الفهرس.
لقد حذفت فهرس «testkb» في خدمة البحث. كيف يمكنني إصلاح ذلك؟
إجابة: في حالة حذف الفهرس testkb في خدمة البحث، يمكنك استعادة البيانات من آخر قاعدة بيانات منشورة. يُرجى استخدام أداة الاسترداد RestoreTestKBIndex المتوفرة على GitHub.
أتلقى الخطأ التالي: يُرجى التحقق مما إذا كانت إعدادات CORS الخاصة بخدمة تطبيق QnA Maker تسمح بـ https://www.qnamaker.ai أو إذا كان هناك قيود شبكة معينة خاصة بالمؤسسة. كيف يمكنني حل ذلك؟
الإجابة: في قسم واجهة برمجة التطبيقات في جزء خدمة التطبيق، قم بتحديث إعداد CORS إلى * أو "https://www.qnamaker.ai"؛. إذا لم يحل ذلك المشكلة، فتحقق من أي قيود خاصة بالمؤسسة.
متى يجب أن أحدث مفاتيح نقطة النهاية الخاصة بي؟
الإجابة: قم بتحديث مفاتيح نقطة النهاية الخاصة بك إذا كنت تشك في أنها قد تعرضت للاختراق.
هل يمكنني استخدام نفس مورد Azure الذكاء الاصطناعي Search قاعدة المعارف (KB) باستخدام لغات متعددة؟
الإجابة: لاستخدام لغات متعددة وقواعد معارف متعددة، يتعين على المستخدم إنشاء مورد QnA Maker لكل لغة. سوف يؤدي ذلك إلى إنشاء خدمة بحث Azure منفصلة لكل لغة. سيؤدي مزج قواعد معارف اللغات المختلفة في خدمة بحث Azure واحدة إلى انخفاض صلة النتائج.
كيف يمكنني تغيير اسم مورد Azure الذكاء الاصطناعي Search المستخدم من قبل QnA Maker؟
الإجابة: اسم مورد Azure الذكاء الاصطناعي Search هو اسم مورد QnA Maker مع إلحاق بعض الأحرف العشوائية في النهاية. هذا يجعل من الصعب التمييز بين موارد البحث المتعددة لخدمة QnA Maker. قم بإنشاء خدمة بحث منفصلة (قم بتسميتها بالطريقة التي ترغب فيها) وقم بتوصيلها بخدمة QnA الخاصة بك. الخطوات مشابهة للخطوات التي تحتاج إلى القيام بها لترقية بحث Azure.
عندما تعيد QnA Maker «ذاكرة وقت التشغيل لم تتم تهيئتها»، كيف يمكنني إصلاحها؟
الإجابة: قد تكون مساحة القرص لخدمة التطبيق ممتلئة. خطوات لإصلاح مساحة القرص الخاصة بك:
في مدخل Microsoft Azure، حدد خدمة تطبيق QnA Maker الخاصة بك، ثم أوقف الخدمة.
بينما لا تزال على خدمة التطبيق، حدد أدوات التطوير، ثم الأدوات المتقدمة، ثم انتقال. يؤدي ذلك إلى فتح نافذة مستعرض جديدة.
حدد وحدة تحكم تتبع الأخطاء، ثم CMD لفتح أداة سطر الأوامر.
انتقل إلى الدليل site/wwwroot/Data/QnAMaker/.
قم بإزالة جميع المجلدات التي يبدأ اسمها بـ
rd.لا تحذف ما يلي:
- ملف KbIdToRankerMappings.txt
- ملف EndpointSettings.json
- مجلد EndpointKeys
ابدأ تشغيل خدمة التطبيق.
قم بالوصول إلى قاعدة المعارف للتحقق من أنها تعمل الآن.
لماذا لا يعمل Application Insights؟
الإجابة: يُرجى مراجعة الخطوات أدناه وتحديثها لإصلاح المشكلة:
في خدمة التطبيق -> مجموعة الإعدادات -> قسم التكوين -> إعدادات التطبيق -> تم تكوين معلمات الاسم «UserAppInsightsKey» بشكل صحيح وضبطها على Guid المعني لعلامة التبويب نظرة عامة على تفاصيل التطبيق («مفتاح الأجهزة»).
في خدمة التطبيق -> مجموعة الإعدادات -> قسم «Application Insights» -> تأكد من تمكين تفاصيل التطبيق واتصالها بمورد تفاصيل التطبيق المعني.
تم تمكين Application Insights ولكن لماذا لا يعمل بشكل صحيح؟
الإجابة: يُرجى اتباع الخطوات التالية:
انسخ قيمة اسم «APPINSIGHTS _ INSTRUMENTATIONKEY» إلى اسم «UserAppInsightsKey» عن طريق تجاوز ما إذا كان هناك بعض القيمة الموجودة بالفعل هناك.
إذا لم يكن مفتاح «UserAppInsightsKey» موجودًا في إعدادات التطبيق، يُرجى إضافة مفتاح جديد بهذا الاسم ونسخ القيمة.
احفظه وسيؤدي ذلك إلى إعادة تشغيل خدمة التطبيق تلقائيًا. يجب أن يؤدي ذلك إلى حل المشكلة.
التكامل مع الخدمات الأخرى بما في ذلك برامج الروبوت
هل أحتاج إلى استخدام Bot Framework لاستخدام QnA Maker؟
الإجابة: لا، لا تحتاج إلى استخدام Bot Framework مع QnA Maker. ومع ذلك، يتم تقديم QnA Maker كأحد عدة قوالب في Azure الذكاء الاصطناعي Bot Service. تتيح Bot Service تطوير الروبوت الذكي السريع من خلال Microsoft Bot Framework، وتعمل في بيئة خالية من الخوادم.
كيف يمكنني إنشاء روبوت جديد باستخدام QnA Maker؟
الإجابة: اتبع الإرشادات الواردة في هذه الوثائق لإنشاء الروبوت الخاص بك باستخدام Azure الذكاء الاصطناعي Bot Service.
كيف أعمل استخدام قاعدة المعارف (KB) مختلفة مع Azure الذكاء الاصطناعي Bot Service موجودة؟
الإجابة: تحتاج إلى المعلومات التالية عن قاعدة المعارف:
- معرف قاعدة المعارف.
- تم العثور على اسم المجال الفرعي المخصص لنقطة النهاية المنشورة لقاعدة المعارف، والمعروف باسم
host، في صفحة الإعدادات بعد النشر. - تم العثور على مفتاح نقطة النهاية المنشور لقاعدة المعارف في صفحة الإعدادات بعد النشر.
باستخدام هذه المعلومات، انتقل إلى خدمة تطبيقات الروبوت في مدخل Microsoft Azure. ضمن الإعدادات -> التكوين -> إعدادات التطبيق، قم بتغيير تلك القيم.
تمت تسمية مفتاح نقطة النهاية لقاعدة المعارف بـ QnAAuthkey في خدمة ABS.
هل يمكن أن يشترك اثنان أو أكثر من تطبيقات العملاء في قاعدة معارف؟
إجابة: نعم، يمكن الاستعلام عن قاعدة المعارف من أي عدد من العملاء. إذا بدت الاستجابة من قاعدة المعارف بطيئة، أو انتهت مهلتها، ففكر في ترقية طبقة الخدمة لخدمة التطبيق المرتبطة بقاعدة المعارف.
كيف أضمّن خدمة QnA Maker في موقعي على الويب؟
الإجابة: اتبع هذه الخطوات لتضمين خدمة QnA Maker كعنصر تحكم في الدردشة عبر الويب في موقعك على الويب:
تخزين بيانات
ما البيانات التي يتم تخزينها وأين تخزن؟
الإجابة:
عند إنشاء خدمة QnA Maker الخاصة بك، قمت بتحديد منطقة Azure. يتم تخزين قواعد المعرفة وملفات السجل في هذه المنطقة.