Azure Yapay Zeka Arama'da veri içeri aktarma

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.

Azure Yapay Zeka Arama'ta, sorgular, aracılı alma kullanıyorsanız arama dizini veya uzak bilgi kaynakları üzerindeki yüklenen içerik üzerinde yürütülür.

Bu makalede, bir arama hizmetinde dizin doldurmak için iki temel iş akışı açıklanmaktadır: verilerinizi program aracılığıyla dizine push yapmak veya bir arama dizinleyici kullanarak verileri pull yapmaktır.

Her iki yaklaşım da dış veri kaynağından belge yükler. Boş bir dizin oluşturabilmenize rağmen, içeriği ekleyene kadar bu sorgulanamaz.

Not

Yapay zeka zenginleştirme veya tümleşik vektörleştirme çözüm gereksinimleriyse, bir dizini yüklemek için çekme modelini (dizin oluşturucular) kullanmanız gerekir. Beceri kümeleri dizin oluşturuculara bağlıdır ve bağımsız olarak çalışmaz.

Verileri dizine gönderme

Gönderme modeli, belgeleri var olan bir arama dizinine yüklemek için API'leri kullanır. Belgeleri tek tek veya toplu halde, her grup için en fazla 1.000 belge ya da 16 MB olacak şekilde, hangisi önce gerçekleşirse karşıya yükleyebilirsiniz.

Başlıca yararları şunlardır:

  • Veri kaynağı türüyle ilgili bir kısıtlama yoktur. Yük, dizin şemanızla eşlenen JSON belgelerinden oluşmalıdır, ancak veriler her yerden kaynaklanabilir.

  • Yürütme sıklığıyla ilgili bir kısıtlama yoktur. Değişiklikleri istediğiniz sıklıkta dizine gönderebilirsiniz. Düşük gecikme süresi gereksinimlerine sahip uygulamalar için (örneğin, dizinin ürün envanteri dalgalanmalarıyla eşitlenmesi gerektiğinde), tek seçeneğiniz gönderim modelidir.

  • Bağlantı ve belgelerin güvenli bir şekilde alınması tamamen sizin denetiminizdedir. Buna karşılık, dizin oluşturucu bağlantılarının kimliği Azure Yapay Zeka Arama sağlanan güvenlik özellikleri kullanılarak doğrulanır.

Azure Yapay Zeka Arama dizinine veri gönderme

Dizine tek veya birden çok belge yüklemek için aşağıdaki API'leri kullanın:

Azure portal aracılığıyla veri gönderme desteği yoktur.

Anında iletme API'lerine giriş için bkz:

Dizin oluşturma eylemleri: karşıya yükleme, birleştirme, birleştirmeYükleme, silme

Dizin oluşturma eyleminin türünü, belgenin tam olarak yüklenmesini, var olan belge içeriğiyle birleştirilmesini veya silinmesini belirterek, belge temelinde denetleyebilirsiniz.

REST API'sini veya Azure SDK'sını kullandığınızda, veri içeri aktarma için aşağıdaki belge işlemleri desteklenir:

  • Karşıya yükleme, belgenin yeniyse eklendiği, mevcutsa güncellendiği veya yenilendiği bir "upsert" örneğine benzer. Belgede dizinin gerektirdiği değerler eksikse, belge alanının değeri null olarak ayarlanır.

  • merge zaten var olan bir belgeyi güncelleştirir ve bulunamayan bir belgeyi başarısız kılar. Birleştirme, mevcut değerlerin yerini alır. Bu nedenle, türünde Collection(Edm.String) alanlar gibi birden çok değer içeren koleksiyon alanlarını denetlediğinizden emin olun. Örneğin, bir tags alanı ["budget"] değeriyle başlıyorsa ve ["economy", "pool"] ile bir birleştirme yaparsanız, tags alanının son değeri ["economy", "pool"] olur. Bu ["budget", "economy", "pool"]olmayacak.

  • mergeOrUpload, belge mevcutsa birleştirme ve belge yeniyse karşıya yükleme gibi davranır.

  • delete , belgenin tamamını dizinden kaldırır. Tek bir alanı kaldırmak istiyorsanız, bunun yerine birleştirmeyi kullanın ve söz konusu alanı null olarak ayarlayın.

Verileri dizine çekme

Çekme modeli, desteklenen bir veri kaynağına bağlanan dizin oluşturucuları ve Logic Apps iş akışlarını kullanır ve verileri otomatik olarak dizininize yükler.

Microsoft'un dizin oluşturucuları şu platformlar için kullanılabilir:

Azure Yapay Zeka Arama, etkin alma için indexed bilgi kaynağı yapılandırıldığında bir dizinleyici işlem hattı oluşturur ve bilgi kaynağındaki özellikleri kullanarak dizini yükler.

Microsoft iş ortakları tarafından geliştirilen ve bakımı yapılan Logic Apps iş akışlarını veya üçüncü taraf bağlayıcılarını da kullanabilirsiniz. Daha fazla bilgi ve bağlantı için bkz . Veri kaynağı galerisi.

Bu otomatik yaklaşımlarla dizininizi bir veri kaynağına (genellikle bir tablo, görünüm, kapsayıcı veya eşdeğer yapı) bağlar ve kaynak alanları dizindeki eşdeğer alanlarla eşlersiniz. Yürütme sırasında satır kümesi otomatik olarak JSON'a dönüştürülür ve belirtilen dizine yüklenir. Tüm dizin oluşturucular, verilerin ne sıklıkta yenileneceğini belirtebilmeniz için zamanlamaları destekler. Çoğu dizin oluşturucu, veri kaynağı destekliyorsa değişim takibi sağlar. Dizin oluşturucular, var olan belgelerdeki değişiklikleri ve silmeleri takip etmenin yanı sıra yeni belgeleri tanıyarak, dizininizdeki verileri aktif şekilde yönetme ihtiyacını ortadan kaldırır.

Azure Yapay Zeka Arama dizinine veri çekme

Dizin oluşturucu tabanlı dizin oluşturma için aşağıdaki araçları ve API'leri kullanın:

Dizin oluşturucu işlevselliği Azure portal, REST API ve .NET SDK kullanıma sunulur.

Azure portal kullanmanın bir avantajı, Azure Yapay Zeka Arama genellikle kaynak veri kümesinin meta verilerini okuyarak varsayılan dizin şeması oluşturabilmesidir.

Arama gezgini ile veri içeri aktarmayı doğrulama

Belge yüklemesinde ön denetim gerçekleştirmenin hızlı bir yolu, Azure portal Search explorer kullanmaktır.

Azure portal içindeki Arama Gezgini komutunun ekran görüntüsü.

Bu gezgin, bir dizini kod yazmadan sorgulamanızı sağlar. Arama deneyimi, simple sözdizimi ve varsayılan searchMode sorgu parametresi gibi varsayılan ayarları temel alır. Belgenin tamamını inceleyebilmeniz için sonuçlar JSON biçiminde döndürülür.

JSON görünümünde Arama Gezgini'nde çalıştırabileceğiniz örnek bir sorgu aşağıda verilmiştır. "HotelId", hotels-sample dizininin belge anahtarıdır. Filtre, belirli bir belgenin belge kimliğini sağlar:

{
  "search": "*",
  "filter": "HotelId eq '50'"
}

REST kullanıyorsanız, bu Arama sorgusu aynı amaca ulaşır.

İlgili içerik

  • Son güncelleştirme: