إنشاء استعلام دلالي في Azure الذكاء الاصطناعي Search

مقالة
02/14/2024

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

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

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

إشعار

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

اختيار عميل

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

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

تجنب الميزات التي تتجاوز تسجيل الصلة

تتجاوز العديد من قدرات الاستعلام في Azure الذكاء الاصطناعي Search نقاط الصلة أو غير متوافقة مع الترتيب الدلالي. إذا كان منطق الاستعلام يتضمن الميزات التالية، فلا يمكنك تصنيف نتائجك دلاليا:

لن يعمل استعلام يحتوي search=* على أو سلسلة بحث فارغة، مثل استعلام عامل التصفية فقط فقط، لأنه لا يوجد شيء لقياس الصلة الدلالية مقابله. يجب أن يوفر الاستعلام مصطلحات أو عبارات يمكن تقييمها أثناء المعالجة.
الاستعلام الذي تم تكوينه في بناء جملة Lucene الكامل (queryType=full) غير متوافق مع الترتيب الدلالي (queryType=semantic). لا يدعم النموذج الدلالي بناء جملة Lucene الكامل.
يتجاوز الفرز (عبارات orderBy) في حقول معينة درجات البحث والنتيجة الدلالية. نظرا إلى أنه من المفترض أن توفر النتيجة الدلالية الترتيب، فإن إضافة عبارة orderby يؤدي إلى خطأ HTTP 400 إذا قمت بتطبيق الترتيب الدلالي على النتائج المرتبة.

إعداد الاستعلام

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

يتضمن مستكشف البحث خيارات للتصنيف الدلالي.

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

بدلا من ذلك، حدد طريقة عرض JSON والصق التعريفات في محرر الاستعلام:

فيما يلي بعض نص JSON الذي يمكنك لصقه في طريقة العرض:

 {
     "queryType": "semantic",
     "search": "historic hotel with good food",
     "semanticConfiguration": "my-semantic-config",
     "answers": "extractive|count-3",
     "captions": "extractive|highlight-true",
     "highlightPreTag": "<strong>",
     "highlightPostTag": "</strong>",
     "select": "HotelId,HotelName,Description,Category",
     "count": true
 }

استخدم "البحث في المستندات " لصياغة الطلب.

تتضمن الاستجابة تلقائيا @search.rerankerScore . إذا كنت تريد تسميات توضيحية أو إجابات في الاستجابة، أضف تسميات توضيحية وإجابات للطلب.

يستخدم المثال التالي في هذا القسم فهرس hotels-sample-index لإظهار الترتيب الدلالي مع الإجابات الدلالية والتسميات التوضيحية.

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

POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2023-11-01      
{
    "queryType": "semantic",
    "search": "newer hotel near the water with a great restaurant",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "highlightPreTag": "<strong>",
    "highlightPostTag": "</strong>",
    "select": "HotelId,HotelName,Description,Category",
    "count": true
}

تعيين "queryType" إلى "دلالي".

في الاستعلامات الأخرى، يتم استخدام "queryType" لتحديد محلل الاستعلام. في الترتيب الدلالي، يتم تعيينه إلى "دلالي". بالنسبة لحقل "البحث"، يمكنك تحديد الاستعلامات التي تتوافق مع بناء الجملة البسيط.
تعيين "البحث" إلى استعلام بحث نصي كامل استنادا إلى بناء الجملة البسيط. الترتيب الدلالي هو امتداد للبحث عن النص الكامل، لذلك على الرغم من أن هذه المعلمة غير مطلوبة، فلن تحصل على نتيجة متوقعة إذا كانت خالية.
قم بتعيين "تكوين دلالي" إلى تكوين دلالي معرف مسبقا مضمن في الفهرس الخاص بك.
قم بتعيين "إجابات" لتحديد ما إذا كانت الإجابات الدلالية مضمنة في النتيجة. حاليا، القيمة الصالحة الوحيدة لهذه المعلمة هي extractive. يمكن تكوين الإجابات لإرجاع 10 كحد أقصى. الإعداد الافتراضي هو واحد. يوضح هذا المثال عدد الإجابات الثلاثة: extractive|count-3.

الإجابات غير مضمونة في كل طلب. للحصول على إجابة، يجب أن يبدو الاستعلام كسؤال ويجب أن يتضمن المحتوى نصا يبدو كإجابة.
قم بتعيين "التسميات التوضيحية" لتحديد ما إذا كانت التسميات التوضيحية الدلالية مضمنة في النتيجة. حاليا، القيمة الصالحة الوحيدة لهذه المعلمة هي extractive. يمكن تكوين التسميات التوضيحية لإرجاع النتائج مع تمييزات أو بدونها. الإعداد الافتراضي هو لإرجاع أهم النقاط. يقوم هذا المثال بإرجاع التسميات التوضيحية دون تمييز: extractive|highlight-false.

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

تطبق التسميات التوضيحية تنسيق التمييز عبر المقاطع الرئيسية في المستند الذي يلخص الاستجابة. الافتراضي هو <em>. إذا كنت تريد تحديد نوع التنسيق (على سبيل المثال، الخلفية الصفراء)، يمكنك تعيين highlightPreTag وتمييزPostTag.
عين "select" لتحديد الحقول التي يتم إرجاعها في الاستجابة، و"count" لإرجاع عدد التطابقات في الفهرس. تعمل هذه المعلمات على تحسين جودة الطلب وقابلية القراءة للاستجابة.
أرسل الطلب لتنفيذ الاستعلام وإرجاع النتائج.

استخدم QueryType أو SemanticQuery لاستدعاء الترتيب الدلالي على استعلام دلالي. المثال التالي من فريق Azure SDK.

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");

تقييم الاستجابة

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

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

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

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

"@odata.count": 35,
"@search.answers": [],
"value": [
    {
        "@search.score": 1.8810667,
        "@search.rerankerScore": 1.1446577133610845,
        "@search.captions": [
            {
                "text": "Oceanside Resort. Luxury. New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
                "highlights": "<strong>Oceanside Resort.</strong> Luxury. New Luxury Hotel. Be the first to stay.<strong> Bay</strong> views from every room, location near the pier, rooftop pool, waterfront dining & more."
            }
        ],
        "HotelName": "Oceanside Resort",
        "Description": "New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
        "Category": "Luxury"
    },
  ...
]

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

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

استعلام مختلط ذو ترتيب دلالي

Share via