Azure Yapay Zeka Arama’te (önizleme) güncellik duyarlı erişimi yapılandırın

Güncelliğe duyarlı alma (önizleme), dizine alınmış bir bilgi kaynağının aracı tabanlı alma sırasında daha yeni içeriği tercih etmesini sağlar. Bilgi kaynağı, Azure Yapay Zeka Arama’ün sıralamayı daha yeni belgelere doğru kaydırmasını sağlayan bir güncellik ilkesi içerebilir; böylece istekte bulunanların her getirme isteğinde özel sıralama mantığı göndermesi gerekmez.

Tazelik, katı bir filtre değil, bir sıralama önyargısıdır. Daha eski belgeler sorguyla yakından ilgili olduğunda da görünebilir.

Kullanım desteği

Prerequisites

• Blob bilgi kaynağı gibi bir Azure Yapay Zeka Arama dizini oluşturan ve sürdüren dizinlenmiş bilgi kaynağı.

• Bilgi kaynağına başvuran bir bilgi bankası .

• Bilgi bankalarını güncelleştirme izni. Kullanıcı hesabınıza atanan Arama Hizmeti Katkıda Bulunanı rolüyle anahtarsız kimlik doğrulamasını yapılandırın (önerilir) veya bir yönetici API anahtarı kullanın.

Güncellik odaklı getirme ne zaman etkinleştirilir

Daha yeni içerik genellikle eski içeriğe göre daha kullanışlı veya güvenilir olduğunda, yeniliğe duyarlı alma özelliğini etkinleştirin. Yaygın örnekler arasında sürüm notları, ilke güncelleştirmeleri, runbook'lar, hizmet önerileri ve işletimsel rehberlik yer alır.

Filtrelemenin yerine tazelik kullanmayın. Sorgunun yalnızca belirli bir tarih aralığından içerik döndürmesi gerekiyorsa, bunun yerine alma isteğinde veya bilgi kaynağı yapılandırmasında bir filtre kullanın.

Güncellik ilkesini yapılandırın

Dizine alınan bilgi kaynağı tanımına bir yenilik ilkesi ekleyin. Önizleme sözleşmesi, geri getirme işlem hattının geri kalanını korurken güncelliği dikkate alan bir sıralama sinyali uygulamak için ilkeyi kullanır.

Aşağıdaki örnekte, yenilik ilkesine sahip bir blob bilgi kaynağı gösterilmektedir.

var knowledgeSource = new AzureBlobKnowledgeSource(
    name: "news-articles-ks",
    azureBlobParameters: new AzureBlobKnowledgeSourceParameters(connectionString: blobConnectionString, containerName: "news")
    {
        IngestionParameters = new IngestionParameters
        {
            FreshnessPolicy = new FreshnessPolicy
            {
                BoostingDuration = TimeSpan.FromDays(90)
            }
        }
    }
)
{
    Description = "A knowledge source for recent news articles."
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);

knowledge_source = AzureBlobKnowledgeSource(
    name="news-articles-ks",
    description="A knowledge source for recent news articles.",
    azure_blob_parameters=AzureBlobKnowledgeSourceParameters(
        connection_string=blob_connection_string,
        container_name="news",
        ingestion_parameters=IngestionParameters(
            freshness_policy=FreshnessPolicy(boosting_duration="P90D"),
        ),
    ),
)

index_client.create_or_update_knowledge_source(knowledge_source)

PUT {{search-endpoint}}/knowledgesources/news-articles-ks?api-version=2026-08-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}

{
  "name": "news-articles-ks",
  "kind": "azureBlob",
  "description": "A knowledge source for recent news articles.",
  "azureBlobParameters": {
    "connectionString": "{{blob-connection-string}}",
    "containerName": "news",
    "ingestionParameters": {
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    }
  }
}

Tazelik ilkesi, kaynak alma parametrelerinin bir parçasıdır. Dizin şeması, Azure Yapay Zeka Arama scoring profile güncellik işlevleriyle uyumlu, oluşturulan bir güncellik alanını destekleyecek biçimde değiştirildi. boostingDuration değeri, 90 gün için P90D gibi puanlama profili güncellik işlevleriyle aynı ISO 8601 süre biçimini kullanır. Güncellik, sıralamaya bir güncellik sinyali ekler; ancak sorgu alaka düzeyi, yapılandırılan getirme ayarları, anlamsal yeniden sıralama ve diğer sıralama sinyalleri yine de geçerliliğini korur.

Yeni değerle başka bir oluşturma veya güncelleştirme isteği göndererek mevcut bir bilgi kaynağında değişiklik boostingDuration yapabilirsiniz. Puanlama profili, yeniden içe aktarma gerektirmeden olduğu yerde güncelleştirilir.

Mevcut bir bilgi kaynağından yenilik ilkesini kaldıramazsınız. Güncellik duyarlı alma işlemini devre dışı bırakmak için bilgi kaynağını silin ve freshnessPolicy olmadan yeni bir kaynak oluşturun.

Derecelendirme davranışını doğrulama

Güncellik alanı, veri alımı sırasında oluşturulur; bu nedenle ilke yalnızca yürürlüğe girdikten sonra alınan içerik için geçerlidir. İçerik sisteme alındıktan sonra, hem yeni hem de eski içerikleri döndürebilen getirme isteklerini çalıştırın. Başarılı bir yapılandırma, daha önce alma işlemini basit bir tarih sıralamaya dönüştürmeden daha yeni ilgili belgeleri ortaya çıkartır.

Sıralama beklenildiği gibi güncelliği yansıtmıyorsa, altta yatan dizindeki last_modified alanını inceleyin. Eksik, eski veya tutarsız tarih değerleri, tazelik sinyalinin kalitesini azaltır.

İlgili içerik

• Bilgi kaynağı nedir?
• Bilgi bankası oluşturma
• Bilgi bankasını sorgulama
• Arama puanlarını artırmak için puanlama profilleri ekleme