Zenginleştirme önbelleğini yönetme (önizleme)

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.

Önemli

(önizleme) olarak işaretlenen özellikler, özellikler veya özellikler hizmet düzeyi sözleşmesi kapsamında değildir, üretim iş yükleri için önerilmez ve genel kullanıma sunulmadan önce değişebilir veya kısıtlanabilir. Azure Yapay Zeka Arama önizleme terimleri, tek başına veya genel kullanıma sunulan bir özelliğin parçası olsun, tüm önizleme işlevleri için geçerlidir.

Zenginleştirme önbelleği (önizleme), beceri kümesi yürütmesi sırasında oluşturulan zenginleştirilmiş içeriği depolayan isteğe bağlı bir özelliktir. İçeriği çalıştırmalar arasında korur; böylece yalnızca değiştirilen becerilerin ve belgelerin yeniden işlenmesi gerekir. Beceri kümesi çıktılarının, dizin oluşturucu durumunun veya dizine alınan belgelerin yedeği değildir.

Azure Depolama'da zenginleştirme önbelleğini oluşturursunuz. Önbellek, belge analiz etme çıktısının yanı sıra her belge için her becerinin çıktısını içerir. Önbelleğe alma faturalanabilir olsa da (Azure Depolama kullanır), depolama maliyetleri görüntü ayıklama ve yapay zeka işlemeden daha az olduğundan zenginleştirmenin genel maliyeti azalır.

Bir zenginleştirme önbelleği yapılandırırsanız, bu makalede önbelleğe alınmış zenginleştirmelerden en yüksek verimi alabilmeniz için beceri ve veri kaynağı güncelleştirmelerini nasıl yöneteceğiniz açıklanır.

Önkoşullar

Sınırlama

Dikkat

SharePoint dizin oluşturucu (önizleme) kullanıyorsanız artımlı zenginleştirmeden kaçının. Belirli durumlarda önbellek geçersiz hale gelir. Yeniden yüklemek için dizin oluşturucuyu sıfırlayıp tam yeniden oluşturma gerçekleştirin.

Büyük veri kaynaklarının ek bir önbellek sınırlaması vardır.

Dikkat

Büyük veri kaynakları için zenginleştirme önbelleği, uzun süre çalışan beceriler, yinelenen kesintiler veya sık beceri hataları oluştuğunda toplam yeniden işlemeyi artırabilir. Dizin oluşturucu, yeniden işlemeyi en aza indirmek yerine doğruluğun önceliğini belirler, böylece yinelenen kesintilerden kaynaklanan önbellek kapsamı yeniden deneme davranışını artırır.

Büyüyen bir önbellek kapsamından kurtarmak için veri kaynağını daha küçük kapsayıcılara veya sanal klasörlere bölün. Ardından aynı dizine işaret eden paralel dizin oluşturucuları kullanın. Önbelleğin ilişkilendirmesini kaldırmak için, dizin oluşturucuda cache özelliğini null olarak ayarlayın.

Önbellek yapılandırması

Fiziksel olarak, önbellek bir blob kapsayıcısında ve Azure Depolama hesabınızdaki tablolarda depolanır ve dizin oluşturucu başına bir tane olur. Her dizin oluşturucuya, kullandığı kapsayıcıya karşılık gelen benzersiz ve sabit bir önbellek tanımlayıcısı atanır.

Önbellek, cache özelliğini belirttiğiniz ve dizin oluşturucuyu çalıştırdığınız zaman oluşturulur. Yalnızca zenginleştirilmiş içerik önbelleğe alınabilir. Dizinleyicinizin ekli bir beceri seti yoksa önbelleğe alma geçerli değildir.

Aşağıdaki örnekte önbelleğe alma etkin bir dizin oluşturucu gösterilmektedir. Tam yönergeler için bkz. Zenginleştirme önbelleğini yapılandırma .

POST https://[YOUR-SEARCH-SERVICE-NAME].search.windows.net/indexers?api-version=2026-08-01-preview
    {
        "name": "myIndexerName",
        "targetIndexName": "myIndex",
        "dataSourceName": "myDatasource",
        "skillsetName": "mySkillset",
        "cache" : {
            "storageConnectionString" : "<Your storage account connection string>",
            "enableReprocessing": true
        },
        "fieldMappings" : [],
        "outputFieldMappings": [],
        "parameters": []
    }

Önbellek yönetimi

Dizin oluşturucu önbellek yaşam döngüsünü yönetir. Dizin oluşturucu silerseniz, önbelleğini de silersiniz. Dizin oluşturucunun cache özelliğini null olarak ayarlarsanız veya bağlantı dizesi değiştirirseniz, bir sonraki dizin oluşturucu çalıştırması sırasında mevcut önbellek silinir.

Artımlı zenginleştirme, sizin müdahaleniz olmadan değişiklikleri algılamak ve yanıtlamak için tasarlanmış olsa da, belirli davranışları çağırmak için parametreler ayarlayabilirsiniz:

Yeni belgelerin önceliklerini belirleme

özelliği, cache önbelleğe alınan içeriğin yeniden işlenip işlenmeyeceğini denetleen bir enableReprocessing parametre içerir. Değer true olduğunda (varsayılan), bir beceri güncelleştirmesi önbelleğe alınmış belgeleri etkiliyorsa, dizin oluşturucuyu yeniden çalıştırdığınızda dizin oluşturucu bu belgeleri yeniden işler.

False olduğunda, dizin oluşturucu yeni içeriğe öncelik veren mevcut belgeleri yeniden işlemez. enableReprocessing öğesini yalnızca geçici olarak false yapın. Çoğu zaman doğru tutmak, hem yeni hem de mevcut belgelerin geçerli beceri kümesi tanımı için geçerli kalmasını sağlar.

Beceri kümesi değerlendirmeyi atlama

Bir beceriyi değiştirmek genellikle bu beceriyi yeniden işlemek için el ele gider. Ancak, bir beceride yapılan bazı değişiklikler yeniden işlemeyi tetiklememelidir. Örneğin, özel bir beceriyi yeni bir konuma veya yeni bir erişim anahtarıyla dağıtma. Bu değişiklikler genellikle beceri çıkışının maddesini etkilemeyen çevresel değişikliklerdir.

Beceride yapılan bir değişikliğin yüzeysel olduğunu biliyorsanız, parametresini true olarak ayarlayarak beceri değerlendirmesini disableCacheReprocessingChangeDetection geçersiz kılın:

  1. Güncelleştirme Beceri Kümesini çağırın ve beceri kümesi tanımını değiştirin.
  2. parametresini disableCacheReprocessingChangeDetection=true isteğe ekleyin.
  3. Değişikliği gönderin.

Bu parametreyi ayarladığınızda, yalnızca beceri kümesi tanımı güncelleştirmeleri işlenir. Değişiklik, mevcut önbellek üzerindeki etkiler için değerlendirilmez. Önizleme API'sini 2020-06-30-Preview veya sonraki bir sürümünü kullanın. En son önizleme API'sini kullanın.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2026-08-01-preview&disableCacheReprocessingChangeDetection

Veri kaynağı doğrulama denetimlerini atlama

Veri kaynağı tanımında yapılan değişikliklerin çoğu önbelleği geçersiz kılar. Ancak, bir değişikliğin önbelleği geçersiz kılmaması gerektiğini bildiğiniz senaryolar için - örneğin, bağlantı dizesi değiştirme veya depolama hesabında anahtar döndürme - ignoreResetRequirement üzerine parametresini ekleyin. Tüm nesnelerin sıfırdan yeniden oluşturulmasına ve doldurulmasına neden olacak bir sıfırlama koşulu tetiklemeden işlemenin geçmesine izin vermek için bu parametreyi true olarak ayarlayın.

PUT https://[search service].search.windows.net/datasources/[data source name]?api-version=2026-08-01-preview&ignoreResetRequirement

Beceri kümesi değerlendirmeyi zorlama

Önbelleğin amacı gereksiz işlemeyi önlemektir. Ancak dizin oluşturucunun algılamadığı bir beceride (örneğin, özel beceri gibi dış koddaki bir şeyi değiştirme) bir değişiklik yaptığınız varsayın.

Bu durumda, belirli bir becerinin çıkışına bağımlılığı olan aşağı akış becerileri de dahil olmak üzere belirli bir becerinin yeniden işlenmesini zorlamak için Becerileri Sıfırla API'sini kullanın. Bu API, geçersiz kılınması ve yeniden işlenmek üzere işaretlenmesi gereken becerilerin listesini içeren bir POST isteği kabul eder. Becerileri Sıfırla işleminden sonra, işlem hattı işlemesini çağırmak için İndeksleyici Çalıştırma isteğini takip edin.

Belirli belgeleri yeniden önbelleğe alma

Dizin oluşturucuyu sıfırlarsanız, arama kuruluşundaki tüm belgeler yeniden işlenir.

Yalnızca birkaç belgenin yeniden işlenmesi gereken senaryolarda, belirli belgelerin yeniden işlenmesini zorlamak için Belgeleri Sıfırla (önizleme) kullanın. Bir belgeyi sıfırladığınızda, dizin oluşturucu o belgenin önbelleğini geçersiz kılar. Dizin oluşturucu daha sonra belgeyi veri kaynağından okuyarak yeniden işler. Daha fazla bilgi için bkz. Dizin oluşturucuları, becerileri ve belgeleri çalıştırma veya sıfırlama.

Belirli belgeleri sıfırlamak için, istekteki arama dizininden okunan belge anahtarlarının listesini ekleyin. Anahtar dış veri kaynağındaki bir alanla eşleşiyorsa, arama dizinindeki değeri kullanın.

API'yi nasıl çağırdığınıza bağlı olarak, istek anahtar listesini ekler, üzerine yazar veya kuyruğa alır:

  • API'yi farklı anahtarlarla birden çok kez çağırmak, yeni anahtarları sıfırlanması gereken belge anahtarları listesine ekler.

  • overwrite sorgu dizesi parametresi true olarak ayarlanarak API çağrıldığında, sıfırlanacak geçerli belge anahtarları listesi istek yüküyle üzerine yazılır.

  • API'yi çağırmak, belge anahtarlarını dizin oluşturucunun gerçekleştirdiği iş kuyruğuna ekler. Dizin oluşturucu bir sonraki çalıştırıldığında, zamanlandığı şekilde ya da isteğe bağlı olarak, veri kaynağındaki diğer tüm değişikliklerden önce sıfırlanmış belge anahtarlarının işlenmesine öncelik verir.

Aşağıdaki örnekte belge sıfırlama isteği gösterilmektedir:

POST https://[search service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-08-01-preview
    {
        "documentKeys" : [
            "key1",
            "key2",
            "key3"
        ]
    }

Önbelleği geçersiz kılan değişiklikler

Bir önbelleği etkinleştirdiğinizde, dizin oluşturucu hangi içeriğin yeniden kullanılıp yeniden işlenmesi gerektiğine karar vermek için işlem hattı bileşiminizdeki değişiklikleri denetler. Bu bölümde önbelleği geçersiz kılan değişiklikler ve artımlı işlemeyi tetikleyen değişiklikler listelenir.

Geçersiz kılınan değişiklik, önbelleğin tamamının geçersiz hale geldiği bir değişikliktir. Örneğin, veri kaynağınızı güncelleştirmek geçersiz kılınan bir değişikliktir. Önbelleğinizi geçersiz kılan dizinleyici işlem hattının herhangi bir bölümündeki değişikliklerin tam listesi aşağıda verilmiştir:

  • Veri kaynağı türünü değiştirme
  • Veri kaynağı kapsayıcısı değiştiriliyor
  • Veri kaynağı kimlik bilgilerini değiştirme
  • Veri kaynağı değişiklik algılama ilkesini değiştirme
  • Veri kaynağı silme algılama ilkesini değiştirme
  • Dizin oluşturucu alan eşlemelerini değiştirme
  • Dizin oluşturucu parametrelerini değiştirme:
    • Ayrıştırma Modu
    • Dışlanan Dosya Adı Uzantıları
    • Dizine Alınan Dosya Adı Uzantıları
    • Meta verilerini yalnızca aşırı büyük boyutlu belgeler için dizine alın.
    • Sınırlandırılmış metin üst bilgileri
    • Sınırlandırılmış metin sınırlayıcısı
    • Ana Dizin
    • Görüntü Eylemi (Resimlerin ayıklanmasındaki değişiklikler)

Artımlı işlemeyi tetikleyen değişiklikler

Artımlı işleme beceri kümesi tanımınızı değerlendirir ve hangi becerileri yeniden çalıştıracaklarını belirler. Belge ağacının etkilenen bölümlerini seçmeli olarak güncelleştirir. Artımlı zenginleştirmeye neden olan değişikliklerin tam listesi aşağıdadır:

  • Beceri türünü değiştirme (becerinin OData türünü güncelleştirme)
  • URL, varsayılan değerler veya diğer parametreler gibi beceriye özgü parametreleri güncelleştirme
  • Becerinin ek veya farklı çıkışlar döndürmesi gibi durumlarda beceri çıkışlarının değişmesi
  • Farklı bir soy veya beceri zincirlemesiyle sonuçlanan beceri girdilerini değiştirme
  • Bu beceriye giriş sağlayan bir beceriyi güncelleştirirseniz tüm yukarı akış becerileri geçersiz kılınması
  • Belgelerin yeniden projelendirilmesiyle sonuçlanan bilgi deposu projeksiyon konumunun güncelleştirilmesi
  • Bilgi deposu projeksiyonlarını değiştirmek, belgelerin yeniden projekte edilmesine neden olur
  • Bir dizin oluşturucudaki çıkış alanı eşlemelerinin değiştirilmesi, bunun sonucunda belgelerin dizine yeniden yansıtılması

Önbelleğe alma için kullanılan API'ler

Önizleme API'leri dizin oluşturucularda ek özellikler sağlar. En son önizleme API'sini kullanın.

Beceri kümeleri ve veri kaynakları için genel kullanıma sunulan sürümü kullanın. İşlem sırası hakkında ayrıntılı bilgi edinmek için başvuru belgelerine ek olarak, Artımlı zenginleştirme için önbelleğe almayı yapılandırma bölümüne bakın.

  • Son güncelleştirme: