تكوين الترتيب الدلالي وإرجاع التسميات التوضيحية في نتائج البحث

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

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

• خدمة بحث على المستوى الأساسي أو القياسي (S1 أو S2 أو S3) أو مستوى التخزين المحسن (L1، L2)، تخضع لتوفر المنطقة.

• تم تمكين Ranker الدلالي على خدمة البحث.

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

اختيار عميل

اختر عميل بحث يدعم الترتيب الدلالي. وإليك بعض الخيارات:

• مدخل Azure، باستخدام مصمم الفهرس لإضافة تكوين دلالي.
• Visual Studio Code مع عميل REST
• Azure SDK ل .NET
• Azure SDK ل Python
• Azure SDK ل Java
• Azure SDK ل JavaScript

إضافة تكوين دلالي

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

التكوين الدلالي له اسم والخصائص التالية:

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

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

عبر جميع خصائص التكوين الدلالي، يجب أن تكون الحقول التي تعينها:

• يتم الإسناد ك searchable و retrievable
• سلاسل من نوع Edm.String، Collection(Edm.String)، حقول فرعية لسلسلة Collection(Edm.ComplexType)

مدخل Microsoft Azure

1. سجل الدخول إلى مدخل Microsoft Azure وانتقل إلى خدمة بحث تم تمكين الترتيب الدلالي لها.

2. من الفهارس في جزء التنقل الأيسر، افتح فهرسا.

3. حدد التكوينات الدلالية ثم حدد إضافة تكوين دلالي.

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

   

   حدد موافق لحفظ التغييرات.

واجهة برمجة التطبيقات REST

1. صياغة طلب إنشاء فهرس أو تحديثه.

2. أضف تكوينا دلاليا إلى تعريف الفهرس، ربما بعد scoringProfiles أو suggesters. يعد تحديد الإعداد الافتراضي اختياريا ولكنه مفيد إذا كان لديك أكثر من تكوين واحد.

   "semantic": {
       "defaultConfiguration": "my-semantic-config-default",
       "configurations": [
           {
               "name": "my-semantic-config-default",
               "prioritizedFields": {
                   "titleField": {
                       "fieldName": "HotelName"
                   },
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ],
                   "prioritizedKeywordsFields": [
                       {
                           "fieldName": "Tags"
                       }
                   ]
               }
           },
                       {
               "name": "my-semantic-config-desc-only",
               "prioritizedFields": {
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ]
               }
           }
       ]
   }
   

.NET SDK

استخدم فئة SemanticConfiguration في Azure SDK ل .NET.

المثال التالي من عينة الترتيب الدلالي التي ألفها فريق Azure SDK.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

الترحيل من إصدارات المعاينة

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

• 2023-11-01 (REST)
• سجل تغيير Azure SDK ل .NET (11.5)
• سجل تغيير Azure SDK ل Python (11.4)
• سجل تغيير Azure SDK ل Java (11.6)
• سجل تغيير Azure SDK ل JavaScript (12.0)

تغييرات السلوك:

• اعتبارا من 14 يوليو 2023، يكون ترتيب الدلالي غير محدد اللغة. ويمكن إعادة ترتيب النتائج المكونة من محتوى متعدد اللغات، دون أي تحيز نحو لغة معينة. في إصدارات المعاينة، سيؤدي الترتيب الدلالي إلى إلغاء فرز النتائج التي تختلف عن اللغة المحددة بواسطة محلل الحقول.

• في 2021-04-30-Preview وجميع الإصدارات الأحدث، لواجهة برمجة تطبيقات REST وجميع حزم SDK التي تستهدف نفس الإصدار: semanticConfiguration (في تعريف الفهرس) تحدد حقول البحث المستخدمة في الترتيب الدلالي. سابقا في 2020-06-30-Preview REST API، searchFields (في طلب استعلام) تم استخدام لمواصفات الحقل وتحديد الأولويات. يعمل هذا الأسلوب فقط في 2020-06-30-Preview وهو قديم في جميع الإصدارات الأخرى.

الخطوة 1: إزالة queryLanguage

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

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

وإلا، احذف queryLanguage.

الخطوة 2: استبدال searchFields ب semanticConfiguration

إذا كانت التعليمات البرمجية تستدعي 2020-06-30-Preview REST API أو حزم بيتا SDK التي تستهدف إصدار REST API هذا، فقد تستخدم searchFields في طلب استعلام لتحديد الحقول والأولويات الدلالية. في إصدارات بيتا الأولية، searchFields كان له غرض مزدوج، يقيد الاستعلام الأولي بالحقول المدرجة في searchFields، وأيضا تعيين أولوية الحقل إذا تم استخدام الترتيب الدلالي. في الإصدارات اللاحقة، searchFields يحتفظ بالغرض الأصلي منه، ولكن لم يعد يستخدم للتصنيف الدلالي.

احتفظ searchFields بطلبات الاستعلام إذا كنت تستخدمها للحد من البحث عن النص الكامل إلى قائمة الحقول المسماة.

semanticConfiguration أضف إلى مخطط فهرس لتحديد ترتيب أولويات الحقول، باتباع الإرشادات الواردة في هذه المقالة.

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

اختبر التكوين الدلالي الخاص بك عن طريق تشغيل استعلام دلالي.

إنشاء استعلام دلالي