Aracılığıyla paylaş

Azure AI Search'te sorgulara anlamsal derecelendirme ekleme

  • Makale

Arama belgelerinizde dize alanları varsa ve vektör sorgusunda arama belgesinde metin gösterimi varsa metin sorgularına, karma sorgulara ve vektör sorgularına anlamsal derecelendirme uygulayabilirsiniz.

Bu makalede, sorgularda semantik ranker'ın nasıl çağrıldığı açıklanmaktadır. En son kararlı veya önizleme API'lerini kullandığınız varsayılır. Eski sürümlerle ilgili yardım için bkz . Anlam derecelendirme kodunu geçirme.

Önkoşullar

Not

Açıklamalı alt yazılar ve yanıtlar, arama belgesindeki metinden ayrıntılı olarak ayıklanır. Anlam alt sistemi, resim yazısı veya yanıtın özelliklerine sahip içeriği tanımak için makine okuma kavramasını kullanır, ancak yeni cümleler veya tümcecikler oluşturmaz. Bu nedenle, anlam derecelendirmesi için en iyi sonucu veren açıklamalar veya tanımlar içeren içeriktir. Oluşturulan yanıtlarla sohbet stili etkileşim istiyorsanız bkz . Artırılmış Oluşturma (RAG) Alma.

İstemci seçme

Anlam derecelendirmesi kullanan bir sorgu oluşturmak için aşağıdaki araçlardan ve SDK'lardan herhangi birini kullanabilirsiniz:

İlgi puanlamayı atlayan özelliklerden kaçının

İlgi puanlamasını atlayan birkaç sorgu özelliği, bunları anlamsal derecelendirmeyle uyumsuz hale getirir. Sorgu mantığınız aşağıdaki özellikleri içeriyorsa sonuçlarınızı sıralayamazsınız:

  • Yalnızca filtre uygulanmış sorgu gibi boş bir arama dizesine sahip search=* bir sorgu çalışmaz çünkü anlamsal ilgiyi ölçecek bir şey yoktur ve bu nedenle arama puanları sıfır olur. Sorgu, işleme sırasında değerlendirilebilecek terimler veya tümcecikler sağlamalıdır.

  • Belirli alanlarda sıralama (orderBy yan tümceleri) arama puanlarını ve anlam puanını geçersiz kılar. Sıralamayı semantik puanın sağlaması gerektiği düşünüldüğünde, sıralı sonuçlara semantik derecelendirme uygularsanız orderby yan tümcesi eklemek HTTP 400 hatasıyla sonuçlanır.

Sorguyu ayarlama

Varsayılan olarak sorgular anlamsal derecelendirme kullanmaz. Anlam derecelendirmesini kullanmak için iki farklı parametre kullanılabilir. Her parametre farklı bir senaryo kümesini destekler.

artı queryTypeveya aracılığıyla search semanticQuerybelirtilen anlamsal sorgular düz metin olmalıdır ve boş olamazlar. Boş sorgular sonuçlara semantik derecelendirme uygulanmamasıyla sonuçlanır.

Semantik ranker parametresi Düz metin arama Basit metin arama söz dizimi Tam metin arama söz dizimi Vektör araması Karma Arama Anlamsal yanıtlar ve açıklamalı alt yazılar
queryType-semantic1 ✅ ❌ ❌ ❌ ✅ ✅
semanticQuery="<your plain text query>"2 ✅ ✅ ✅ ✅ ✅ ✅

parametresi için semantickullanıldığından queryType 1 queryType=semantic açık simple veya full değerleri destekleyemez. Etkili sorgu davranışları, basit ayrıştırıcının varsayılan değerleridir.

2 Parametresi semanticQuery tüm sorgu türleri için kullanılabilir. Ancak, Azure portalı Arama Gezgini'nde desteklenmez.

Seçilen parametreden bağımsız olarak, dizin zengin anlamsal içeriğe ve anlamsal yapılandırmaya sahip metin alanları içermelidir.

Arama gezgini semantik derecelendirme seçenekleri içerir. Azure portalında parametresini semanticQuery ayarlayamazsınız.

  1. Azure Portal’ında oturum açın.

  2. Bir arama dizini açın ve Arama gezgini'ne tıklayın.

  3. Sorgu seçenekleri'ni seçin. Zaten bir anlamsal yapılandırma tanımladıysanız, varsayılan olarak seçilidir. Yoksa dizininiz için bir anlamsal yapılandırma oluşturun.

    Arama gezgininde sorgu seçeneklerini gösteren ekran görüntüsü.

  4. "İyi yemekler içeren tarihi otel" gibi bir sorgu girin ve Ara'yı seçin.

  5. Alternatif olarak JSON görünümü'nü seçin ve tanımları sorgu düzenleyicisine yapıştırın. Azure portalı kullanmayı semanticQuerydesteklemez, bu nedenle ayarının queryType "semantic" yapılması gerekir:

    Azure portalında JSON sorgu söz dizimini gösteren ekran görüntüsü.

    Sorgu türünü görünüme yapıştırabileceğiniz anlamsal olarak ayarlamak için JSON örneği:

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

Yanıtı değerlendirme

Yalnızca ilk sonuçlardaki ilk 50 eşleşme, sıralanabilir. Tüm sorgularda olduğu gibi, yanıt alınabilir olarak işaretlenmiş tüm alanlardan veya yalnızca parametresinde listelenen alanlardan select oluşur. Yanıt özgün ilgi puanını içerir ve isteği nasıl formüle ettiğinize bağlı olarak bir sayı veya toplu sonuçlar da içerebilir.

Anlamsal derecelendirmede yanıtın daha fazla öğesi vardır: yeni bir anlam derecesine sahip ilgi puanı, düz metinde ve vurgulu isteğe bağlı bir resim yazısı ve isteğe bağlı bir yanıt. Sonuçlarınız bu ek öğeleri içermiyorsa sorgunuz yanlış yapılandırılmış olabilir. Sorunu gidermeye yönelik ilk adım olarak, hem dizin tanımında hem de sorguda belirtildiğinden emin olmak için anlamsal yapılandırmayı denetleyin.

bir istemci uygulamasında, arama sayfasını belirli bir alanın içeriğinin tamamı yerine, eşleşmenin açıklaması olarak bir resim yazısı içerecek şekilde yapılandırabilirsiniz. Bu yaklaşım, tek tek alanlar arama sonuçları sayfası için çok yoğun olduğunda kullanışlıdır.

Yukarıdaki örnek sorgunun yanıtı ("sitede restoranı olan ilginç otel ve rahat lobi veya paylaşılan alan") üç yanıt döndürür ("answers": "extractive|count-e"). "Captions" özelliği düz metin ve vurgulanmış sürümlerle ayarlandığından resim yazıları döndürülür. Bir yanıt belirlenemezse yanıttan atlanır. Kısa olması için, bu örnekte yalnızca üç yanıt ve sorgudaki en yüksek üç puanlama sonucu gösterilir.

{
  "@odata.count": 29,
  "@search.answers": [
    {
      "key": "24",
      "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "score": 0.9340000152587891
    },
    {
      "key": "40",
      "text": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport.",
      "highlights": "Only 8 miles from Downtown. <strong>On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, </strong>All non-smoking<strong> hotel.</strong> Only 15 miles from airport.",
      "score": 0.9210000038146973
    },
    {
      "key": "38",
      "text": "Nature is Home on the beach. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "highlights": "Nature is Home on the beach. Explore the shore by day, and then come home to our<strong> shared living space </strong>to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "score": 0.9200000166893005
    }
  ],
  "value": [
    {
      "@search.score": 3.2328331,
      "@search.rerankerScore": 2.575303316116333,
      "@search.captions": [
        {
          "text": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
          "highlights": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our<strong> penthouse </strong>suites offer views for miles and the rooftop<strong> plaza </strong>is open to all guests from sunset to 10 p.m. Enjoy a<strong> complimentary continental breakfast in the lobby, </strong>and free Wi-Fi<strong> throughout </strong>the hotel."
        }
      ],
      "HotelId": "50",
      "HotelName": "Head Wind Resort",
      "Description": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
      "Category": "Suite"
    },
    {
      "@search.score": 0.632956,
      "@search.rerankerScore": 2.5425150394439697,
      "@search.captions": [
        {
          "text": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
          "highlights": "Every stay starts with a warm cookie. Amenities like the<strong> Counting Sheep sleep experience, </strong>our<strong> Wake-up glorious breakfast buffet and spacious workout facilities </strong>await."
        }
      ],
      "HotelId": "34",
      "HotelName": "Lakefront Captain Inn",
      "Description": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
      "Category": "Budget"
    },
    {
      "@search.score": 3.7076726,
      "@search.rerankerScore": 2.4554927349090576,
      "@search.captions": [
        {
          "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
          "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance."
        }
      ],
      "HotelId": "24",
      "HotelName": "Uptown Chic Hotel",
      "Description": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "Category": "Suite"
    },
   . . .
  ]
}

Beklenen iş yükleri

Anlamsal derecelendirme için, bir arama hizmetinin çoğaltma başına en fazla 10 eşzamanlı sorgu desteklemesini beklemelisiniz.

Birimler çok yüksekse hizmet semantik derecelendirme isteklerini kısıtlar. Bu ifadeleri içeren bir hata iletisi, hizmetin anlamsal derecelendirme için kapasitede olduğunu gösterir:

Error in search query: Operation returned an invalid status 'Partial Content'`
@search.semanticPartialResponseReason`
CapacityOverloaded

Bu düzeye yakın, en yüksek veya daha yüksek tutarlı aktarım hızı gereksinimleri bekliyorsanız, iş yükünüz için sağlayabilmemiz için lütfen bir destek bileti oluşturun.

Sonraki adımlar

Anlam derecelendirmesi, anahtar sözcük arama ve vektör aramasını tek bir istekte ve birleşik yanıtta birleştiren karma sorgularda kullanılabilir.

Anlam dereceleyicisi ile karma sorgu