Azure resources for QnA Maker
يستخدم QnA Maker العديد من مصادر Azure، لكل منها غرض مختلف. يتيح لك فهم كيفية استخدامها بشكل فردي التخطيط لطبقة التسعير الصحيحة وتحديدها أو معرفة متى يتم تغيير طبقة التسعير الخاصة بك. فهم كيفية استخدامها في تركيبة يسمح لك بالعثور على المشاكل وإصلاحها عند حدوثها.
ملاحظة
سيتم إيقاف خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية طرح الأسئلة والإجابة عليها كجزء من Azure Cognitive Service for Language. للحصول على إمكانيات الإجابة على الأسئلة داخل خدمة اللغة، راجع الإجابة على الأسئلة. اعتبارا من 1 أكتوبر 2022 ، لن تتمكن من إنشاء موارد QnA Maker جديدة. للحصول على معلومات حول ترحيل قواعد معارف QnA Maker الحالية للإجابة على الأسئلة، راجع دليل الترحيل.
تخطيط الموارد
عند تطوير قاعدة معارف صانع QnA لأول مرة ، في مرحلة النموذج الأولي ، من الشائع أن يكون لديك مورد QnA Maker واحد لكل من الاختبار والإنتاج.
عند الانتقال إلى مرحلة تطوير المشروع ، يجب أن تفكر في:
- كم عدد اللغات التي سيحملها نظام قاعدة معارف الخاص بك؟
- كم عدد المناطق التي تحتاج إلى أن تكون قاعدة معارف الخاصة بك متاحة فيها؟
- كم عدد المستندات في كل مجال سيحتفظ به نظامك؟
خطط للحصول على مورد QnA Maker واحد يحتوي على جميع قواعد المعرفة التي لها نفس اللغة ونفس المنطقة ونفس مجموعة مجالات الموضوع.
اعتبارات طبقة التسعير
عادة ما تكون هناك ثلاث معلمات تحتاج إلى مراعاتها:
الإنتاجية التي تحتاجها من الخدمة:
- حدد خطة التطبيق المناسبة لخدمة التطبيق الخاصة بك بناء على احتياجاتك. يمكنك توسيع نطاق التطبيق أو تقليصه.
- يجب أن يؤثر ذلك أيضا على اختيار رمز SKU للبحث المعرفي في Azure، راجع المزيد من التفاصيل هنا. بالإضافة إلى ذلك، قد تحتاج إلى ضبط سعة البحث المعرفي باستخدام النسخ المتماثلة.
الحجم وعدد قواعد المعرفة: اختر SKU المناسب للبحث في Azure للسيناريو الخاص بك. عادة ما تقرر عدد قواعد المعرفة التي تحتاجها بناء على عدد مجالات الموضوعات المختلفة. بمجرد أن يكون نطاق الموضوع (للغة واحدة) في قاعدة معارف واحد.
يجب أن يكون مورد Azure خدمة البحث قد تم إنشاؤه بعد يناير 2019 ولا يمكن أن يكون في الطبقة المجانية (المشتركة). لا يوجد دعم لتكوين المفاتيح التي يديرها العميل في مدخل Azure.
هام
يمكنك نشر قواعد معارف N-1 في طبقة معينة، حيث N هي الحد الأقصى للفهارس المسموح بها في الطبقة. تحقق أيضا من الحد الأقصى للحجم وعدد المستندات المسموح بها لكل طبقة.
على سبيل المثال، إذا كانت طبقتك تحتوي على 15 فهرسا مسموحا به، فيمكنك نشر 14 قاعدة معرفية (فهرس واحد لكل قاعدة معارف منشور). يستخدم الفهرس الخامس عشر لجميع قواعد المعرفة للتأليف والاختبار.
- عدد المستندات كمصادر: تحد وحدة SKU المجانية لخدمة إدارة QnA Maker من عدد المستندات التي يمكنك إدارتها عبر البوابة الإلكترونية وواجهات برمجة التطبيقات إلى 3 (بحجم 1 ميغابايت لكل منهما). لا يوجد لوحدة SKU القياسية حدود لعدد المستندات التي يمكنك إدارتها. انظر المزيد من التفاصيل هنا.
يمنحك الجدول التالي بعض الإرشادات عالية المستوى.
| إدارة صانع QnA | App Service | Azure Cognitive Search | التقييدات | |
|---|---|---|---|---|
| تجربة عملية | رمز SKU مجاني | الطبقة المجانية | الطبقة المجانية | نشر ما يصل إلى 2 كيلوبايت، حجم 50 ميجابايت |
| بيئة التطوير / الاختبار | SKU القياسية | مُشترك | أساسي | نشر ما يصل إلى 14 كيلوبايت، وحجم 2 غيغابايت |
| بيئة الإنتاج | SKU القياسية | أساسي | قياسي | نشر ما يصل إلى 49 كيلوبايت، وحجم 25 جيجابايت |
الإعدادات الموصى بها
| الهدف QPS | App Service | Azure Cognitive Search |
|---|---|---|
| 3 | S1 ، نسخة طبق الأصل واحدة | S1 ، نسخة طبق الأصل واحدة |
| 50 | S3، 10 نسخ متماثلة | S1، 12 نسخة طبق الأصل |
| 80 | S3، 10 نسخ متماثلة | S3، 12 نسخة طبق الأصل |
| 100 | P3V2، 10 نسخ متماثلة | S3 ، 12 نسخة طبق الأصل ، 3 أقسام |
| 200 إلى 250 | P3V2، 20 نسخة طبق الأصل | S3 ، 12 نسخة طبق الأصل ، 3 أقسام |
متى يجب تغيير طبقة التسعير
| ترقية | السبب |
|---|---|
| ترقيه رمز SKU لإدارة صانع QnA | تريد الحصول على المزيد من أزواج QnA أو مصادر المستندات في قاعدة معارف. |
| ترقيه رمز SKU لخدمة التطبيقات والتحقق من مستوى البحث المعرفي وإنشاء نسخ طبق الأصل للبحث المعرفي | يحتاج قاعدة معارف إلى تقديم المزيد من الطلبات من تطبيق العميل، مثل روبوت الدردشة. |
| ترقيه Azure Cognitive خدمة البحث | كنت تخطط للحصول على العديد من قواعد المعرفة. |
احصل على آخر تحديثات وقت التشغيل من خلال تحديث خدمة التطبيقات في مدخل Azure.
مفاتيح في صانع QnA
تتعامل خدمة QnA Maker مع نوعين من المفاتيح: مفاتيح التأليف ومفاتيحنقطة نهاية الاستعلام المستخدمة مع وقت التشغيل المستضاف في خدمة التطبيق.
استخدم هذه المفاتيح عند تقديم طلبات إلى الخدمة من خلال واجهات برمجة التطبيقات.
| الاسم | الموقع | الغرض |
|---|---|---|
| مفتاح التأليف/الاشتراك | مدخل Microsoft Azure | تستخدم هذه المفاتيح للوصول إلى واجهات برمجة تطبيقات خدمة إدارة QnA Maker. تتيح لك واجهات برمجة التطبيقات هذه تحرير الأسئلة والإجابات في قاعدة معارف الخاص بك ونشر قاعدة معارف. يتم إنشاء هذه المفاتيح عند إنشاء خدمة QnA Maker جديدة. ابحث عن هذه المفاتيح في مورد الخدمات المعرفية في صفحة المفاتيح ونقطة النهاية . |
| مفتاح نقطة نهاية الاستعلام | مدخل QnA Maker | تستخدم هذه المفاتيح للاستعلام عن نقطة النهاية قاعدة معارف المنشورة للحصول على رد على سؤال مستخدم. عادة ما تستخدم نقطة نهاية الاستعلام هذه في روبوت الدردشة أو في رمز تطبيق العميل الذي يتصل بخدمة QnA Maker. يتم إنشاء هذه المفاتيح عند نشر قاعدة معارف صانع QnA. ابحث عن هذه المفاتيح في صفحة إعدادات الخدمة . ابحث عن هذه الصفحة من قائمة المستخدم في الجزء العلوي الأيسر من الصفحة في القائمة المنسدلة. |
البحث عن مفاتيح التأليف في مدخل Azure
يمكنك عرض مفاتيح التأليف وإعادة تعيينها من مدخل Azure، حيث قمت بإنشاء مورد صانع QnA.
انتقل إلى مورد صانع QnA في مدخل Azure وحدد المورد الذي يحتوي على نوع الخدمات المعرفية :
انتقل إلى المفاتيح ونقطة النهاية:
البحث عن مفاتيح نقطة نهاية الاستعلام في مدخل صانع QnA
تقع نقطة النهاية في نفس منطقة المورد لأن مفاتيح نقطة النهاية تستخدم لإجراء مكالمة إلى قاعدة معارف.
يمكن إدارة مفاتيح نقطة النهاية من مدخل QnA Maker.
سجل الدخول إلى مدخل QnA Maker، وانتقل إلى ملف التعريف الخاص بك، ثم حدد إعدادات الخدمة:
عرض مفاتيحك أو إعادة تعيينها:
ملاحظة
قم بتحديث مفاتيحك إذا كنت تعتقد أنها تعرضت للاختراق. قد يتطلب ذلك تغييرات مقابلة على تطبيق العميل أو رمز البوت.
منطقة خدمة الإدارة
يتم استخدام خدمة إدارة QnA Maker فقط لبوابة QnA Maker ولمعالجة البيانات الأولية. تتوفر هذه الخدمة فقط في منطقة غرب الولايات المتحدة . لا يتم تخزين بيانات العملاء في هذه الخدمة في غرب الولايات المتحدة.
اعتبارات تسمية الموارد
يستخدم اسم المورد الخاص بمورد QnA Maker، مثل qna-westus-f0-b، أيضا لتسمية الموارد الأخرى.
تتيح لك نافذة إنشاء مدخل Azure إنشاء مورد QnA Maker وتحديد مستويات التسعير للموارد الأخرى.
بعد إنشاء الموارد، يكون لها نفس الاسم، باستثناء مورد Insights التطبيق الاختياري، الذي يؤجل الأحرف إلى الاسم.
تلميح
إنشاء مجموعة موارد جديدة عند إنشاء مورد صانع QnA. يتيح لك ذلك رؤية جميع الموارد المرتبطة بمورد QnA Maker عند البحث حسب مجموعة الموارد.
تلميح
استخدم اصطلاح تسمية للإشارة إلى مستويات التسعير داخل اسم المورد أو مجموعة الموارد. عندما تتلقى أخطاء من إنشاء قاعدة معارف جديد أو إضافة مستندات جديدة، يعد حد طبقة تسعير البحث المعرفي مشكلة شائعة.
أغراض الموارد
لكل مورد من موارد Azure تم إنشاؤه باستخدام QnA Maker غرض محدد:
- مورد صانع QnA
- مورد البحث المعرفي
- App Service
- خدمة خطة التطبيق
- خدمة Insights التطبيقات
مورد صانع QnA
يوفر مورد QnA Maker إمكانية الوصول إلى واجهات برمجة تطبيقات التأليف والنشر.
إعدادات تكوين مورد صانع QnA
عند إنشاء قاعدة معارف جديد في مدخل QnA Maker، يكون إعداد اللغة هو الإعداد الوحيد الذي يتم تطبيقه على مستوى الموارد. يمكنك تحديد اللغة عند إنشاء أول قاعدة معارف للمورد.
مورد البحث المعرفي
يستخدم مورد البحث المعرفي من أجل:
- تخزين أزواج QnA
- توفير الترتيب الأولي (الترتيب #1) لأزواج QnA في وقت التشغيل
استخدام الفهرس
يحتفظ المورد بفهرس واحد ليكون بمثابة مؤشر الاختبار وترتبط الفهارس المتبقية بفهرس واحد منشور قاعدة معارف كل منها.
وسيحتوي المورد الذي يتم تسعيره لاستيعاب 15 مؤشرا على 14 قاعدة معرفية منشورة، ويستخدم مؤشر واحد لاختبار جميع قواعد المعرفة. يتم تقسيم فهرس الاختبار هذا حسب قاعدة معارف بحيث يستخدم استعلام يستخدم جزء الاختبار التفاعلي فهرس الاختبار ولكنه يقوم فقط بإرجاع النتائج من القسم المحدد المقترن قاعدة معارف المحدد.
استخدام اللغة
يتم استخدام أول قاعدة معارف تم إنشاؤه في مورد QnA Maker لتحديد مجموعة اللغة المفردة لمورد البحث المعرفي وجميع فهارسه. يمكنك تعيين لغة واحدة فقط لخدمة QnA Maker.
استخدام خدمة البحث معرفي واحد
إذا قمت بإنشاء خدمة QnA وتبعياتها (مثل البحث) من خلال البوابة الإلكترونية، إنشاء خدمة البحث لك وربطها بخدمة QnA Maker. بعد إنشاء هذه الموارد، يمكنك تحديث إعداد خدمة التطبيقات لاستخدام خدمة البحث موجود مسبقا وإزالة الذي أنشأته للتو.
تعرف على كيفية تكوين QnA Maker لاستخدام مورد خدمة إدراكية مختلف عن المورد الذي تم إنشاؤه كجزء من عملية إنشاء موارد QnA Maker.
خدمة التطبيق وخطة خدمة التطبيق
يتم استخدام خدمة التطبيق بواسطة تطبيق العميل الخاص بك للوصول إلى قواعد المعرفة المنشورة عبر نقطة نهاية وقت التشغيل. تتضمن خدمة التطبيق طبقة الترتيب الثانية المستندة إلى معالجة اللغة الطبيعية (NLP) (المرتبة رقم 2) لأزواج QnA في وقت التشغيل. يطبق الترتيب الثاني فلاتر ذكية يمكن أن تتضمن بيانات وصفية ومطالبات متابعة.
للاستعلام عن قاعدة معارف المنشورة، تستخدم جميع قواعد المعارف المنشورة نقطة نهاية عنوان URL نفسها، ولكن حدد معرف قاعدة معارف داخل المسار.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Application Insights
يستخدم Insights التطبيق لجمع سجلات الدردشة والقياس عن بعد. راجع استعلامات Kusto الشائعة للحصول على معلومات حول خدمتك.
مشاركة الخدمات مع صانع QnA
يقوم QnA Maker بإنشاء العديد من موارد Azure. لتقليل الإدارة والاستفادة من تقاسم التكاليف، استخدم الجدول التالي لفهم ما يمكنك وما لا يمكنك مشاركته:
| الخدمة | مشاركة | السبب |
|---|---|---|
| Cognitive Services | X | غير ممكن حسب التصميم |
| خطة App Service | ✔ | مساحة ثابتة على القرص مخصصة لخطة خدمة التطبيق. إذا كانت التطبيقات الأخرى التي تشارك نفس خطة خدمة التطبيقات تستخدم مساحة كبيرة على القرص، فسيواجه مثيل خدمة تطبيق QnAMaker مشكلات. |
| App Service | X | غير ممكن حسب التصميم |
| Application Insights | ✔ | يمكن مشاركتها |
| خدمة البحث | ✔ | 1. هو اسم محجوز لخدمة QnAMaker ؛ لا يمكن استخدامه من قبل الآخرين. testkb2. خريطة مرادفة بالاسم synonym-map محجوزة لخدمة QnAMaker.3. عدد قواعد المعرفة المنشورة محدود بطبقة خدمة البحث. إذا كانت هناك فهارس مجانية متاحة ، فيمكن للخدمات الأخرى استخدامها. |
الخطوات التالية
- تعرف على قاعدة معارف صانع QnA
- فهم دورة حياة قاعدة معارف
- مراجعة حدود الخدمة قاعدة معارف