Azure Yapay Zeka Arama sorgulara anlamsal derecelendirme ekleme

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

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 Anlam derecelendirme kodunu taşıma bölümüne bakın.

Ö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 sorgu yeniden yazma (önizleme) durumu dışında yeni cümleler veya tümceler oluşturmaz. Bu nedenle, anlam derecelendirmesi için en iyi sonucu veren açıklamalar veya tanımlar içeren içeriktir. Eğer oluşturulan yanıtlarla sohbet tarzında bir etkileşim istiyorsanız, Agentic retrieval veya Bilgi Alma Destekli Üretim (RAG)'ye bakınız.

İ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:

  • search=* ya da yalnızca filtreli bir sorgu gibi boş bir arama dizesine sahip sorgular ç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 ve alaka derecesine göre puanlanan arama sonuçları üreten terimleri veya ifadeleri sağlamalıdır. Puanlanan sonuçlar, anlamsal sıralayıcıya girdilerdir.

  • Belirli alanlarda yapılan sıralama (orderBy yan tümceleri), arama puanlarını ve semantik puanı devre dışı bırakır. Sıralamayı semantik puanın sağlaması gerektiğinden, sıralı sonuçlara semantik derecelendirme uygularsanız orderby ifadesi 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 sorgu biçimleri kümesini destekler.

search ve queryType aracılığıyla veya semanticQuery aracılığıyla belirtilen tüm anlamsal sorgular düz metin olmalıdır ve boş olamaz. Aşağıdaki tabloda görebileceğiniz gibi parametresi sorgu queryType-semantic biçimlerinin bir alt kümesini destekler.

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

1queryType=semantic açıkça ifade edilen simple veya full değerlerini destekleyemez çünkü queryType parametresi semantic için kullanılmaktadır. 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ında Search Explorer 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 semanticQuery parametresini ayarlayamazsınız.

  1. Azure portalında arama hizmetinize gidin.

  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. Eğer henüz bir tane 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ı semanticQuery kullanılmasını desteklemediğinden queryType"semantic" olarak ayarlanması 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

Başlangıçtaki sonuçlardan yalnızca ilk 50 eşleşme, anlamsal olarak 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 daha fazla öğe içerir: yeni bir anlamsal olarak derecelendirilmiş ilgi puanı, isteğe bağlı olarak düz metin ve vurgularla bir açıklama 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ığı için resim yazıları geri 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.

Hacimler ç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üzeyde, bu düzeye yakın veya daha yüksek tutarlı aktarım hızı gereksinimleri bekliyorsanız, iş yükünüz için gerekli önlemleri alabilmemiz 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

  • Son güncelleştirme: