Dosya araması için vektör depoları

Vektör deposu nesneleri , dosya arama aracına dosyalarınızda arama yapma olanağı verir. Vektör deposuna dosya eklemek, aracının Foundry modeline eğitim verilerinin ötesinde bilgi sağlar. Hizmet, dosyayı ayrıştırır, öbekler, gömer ve dizine ekler; ve böylece araç, hem anahtar sözcük hem de anlamsal arama çalıştırabilir.

Vektör depoları hem aracılara hem de konuşmalara eklenebilir. Şu anda bir aracıya en fazla bir vektör deposu ve konuşmaya en fazla bir vektör deposu ekleyebilirsiniz. Konuşmalara kavramsal genel bakış için bkz. Aracı çalışma zamanı bileşenleri.

Geçerli aracı geliştirici deneyiminde, yanıt oluşturma yanıtlar ve konuşmalar kullanır. Bazı SDK'lar ve eski örnekler çalıştırma terimini kullanır. Her iki terimi de görürseniz çalıştırmayı yanıt oluşturma olarak değerlendirin. Geçiş kılavuzu için bkz. Yeni aracı hizmetine geçiş.

Vektör araması (izin verilen en yüksek dosya boyutları gibi) sınırlarının listesi için kotalar ve sınırlar makalesine bakın.

Önkoşullar

  • Microsoft Foundry girişimi.
  • Dosya arama aracını kullanan bir aracı veya konuşma.
  • Standart aracı kurulumu kullanıyorsanız, dosyalarınızın depolama alanınızda kalması için kurulum sırasında Azure Blob Depolama ve Azure Yapay Zeka Arama bağlayın. Aracı ortam kurulumu kısmına bakın.
  • Roller ve izinler göreve göre değişiklik gösterir (örneğin, proje oluşturma, standart kurulum için rol atama veya aracı oluşturma ve düzenleme). Aracı ortamı kurulumunda gerekli izinler tablosuna bakın.
  • Özellik kullanılabilirliği bölgeye göre farklılık gösterebilir. Geçerli kapsam için bkz. bulut bölgeleri arasında Microsoft Foundry özelliği kullanılabilirliği.

Ana sınırlar ve varsayılanlar

Vektör depoları genellikle alma iş akışlarının üretimde başarısız olduğu ilk yerdir, bu nedenle varsayılanları ve sabit sınırları bilmenize yardımcı olur.

  • Vektör deposu başına dosyalar: Her vektör deposu en fazla 10.000 dosya barındırabilir.
  • Ekler: Bir aracıya en fazla bir vektör deposu ve bir konuşmaya en fazla bir vektör deposu ekleyebilirsiniz.
  • Varsayılan alma ayarları (dosya arama):
    • Öbek boyutu: 800 token
    • Öbek çakışması: 400 belirteç
    • Ekleme modeli: 256 boyutta metin ekleme-3-büyük
    • Bağlama eklenen öbek sayısı üst sınırı: 20

Dosya boyutu ve belirteç sınırları için bkz. kotalar ve sınırlar.

Temel kavramlar

Terim Anlamı
Vektör deposu Dosya arama aracı tarafından kullanılan aranabilir dosya içeriği (öbekler ve eklemeler) için bir kapsayıcı.
Yenmesi Bir dosyayı arama için ayrıştıran, bölümlere ayıran, yerleştiren ve dizinleyen zaman uyumsuz işlem.
Hazırlık Alımın tamamlanıp tamamlanmadığı ve vektör deposunun aranabilir olup olmadığı.
Süre sonu ilkesi Belirli bir süre etkin olmadığında bir vektör veri deposunun süresini sonlandıran yaşam döngüsü ilkesi.

Dosya arama, aracınızın dosyalarınızdan doğru içeriği bulmasına yardımcı olmak için en iyi alma yöntemlerini uygular. Sorguya ve verilerinize bağlı olarak araç şunları yapabilir:

  • Alma özelliğini geliştirmek için kullanıcı sorgularını yeniden yazma.
  • Karmaşık sorguları birden çok aramaya bölün.
  • Aracı ve konuşma vektör depolarında hem anahtar sözcük hem de anlamsal aramalar çalıştırın.
  • Sonuçları model bağlamına eklemeden önce yeniden sıralayın.

Geçerli varsayılan alma ayarları (çakışma ve öbek boyutu, gömme modeli ve bağlama eklenen en fazla öbek sayısı) için Nasıl çalışır bölümüne bakın.

Verilerinizin bulunduğu yer (temel ve standart aracı kurulumu)

Dosyaların ve arama kaynaklarının nerede yaşadığı aracı kurulumunuza bağlıdır:

  • Basic aracısı kurulumu: Dosya arama, Microsoft yönetilen depolama ve arama kaynaklarını kullanır.
  • Standard aracı kurulumu: Dosya arama, kurulum sırasında bağladığınız Azure Blob Depolama ve Azure Yapay Zeka Arama kaynaklarını kullanır, böylece dosyalarınız depolama alanınızda kalır.

Ortamınızı ayarlamak için Aracı ortamını ayarlama bölümüne bakın. Daha fazla ayrıntı için bkz. Aracı kurulumuna bağımlılık.

Yanıt oluşturmadan önce vektör deposu hazır olduğundan emin olun

Yanıt oluşturmadan önce vektör deposundaki tüm dosyaların tam olarak işlendiğine emin olun. Bu adım, vektör deponuzdaki tüm verilerin aranabilir olmasını sağlar.

Hazır olma durumunu denetlemek için SDK yoklama yardımcılarını (örneğin oluşturma ve yoklama vekarşıya yükleme ve yoklama) kullanın veya durumu tamamlanana kadar vektör deposu nesnesini yoklayın. Kod örnekleri için bkz. Aracılar için dosya arama aracı.

Alım sırasında vektör deposu in_progress durumda olabilir. Alma tamamlandığında, durum tamamlandı olarak değişir.

Geri dönüş olarak yanıt oluşturma işlemi, konuşmanın vektör deposunda hala işlenmekte olan dosyalar bulunduğunda en fazla 60 saniyelik bir bekleme süresi içerir. Bu geri dönüş beklemesi aracının vektör deposu için geçerli değildir.

Uçtan uca iş akışı denetim listesi

Alımdan yaşam döngüsü yönetimine kadar çalışan bir vektör deposu iş akışını doğrulamak için bu denetim listesini kullanın.

  1. Dosyalarınızın ve arama kaynaklarınızın nerede yaşamasını istediğinize bağlı olarak temel aracı kurulumunu mu yoksa standart aracı kurulumunu mu kullanacağınıza karar verin. Bkz. Verilerinizin bulunduğu yer (temel ve standart aracı kurulumu).
  2. Dosyalarınızı karşıya yükleyin ve bir vektör deposu oluşturun. Adım adım bir örnek için bkz. Dosyaları karşıya yükleme ve bir vektör deposuna ekleme.
  3. Yanıtlar oluşturmadan önce veri alımının tamamlanmasını bekleyin. Durumu tamamlanana ve devam_ediyor olan hiçbir dosya kalmayana kadar SDK yoklama yardımcılarını kullanın veya vektör deposunu sorgulayın. Bkz . Yanıt oluşturmadan önce vektör deposu hazırlığını sağlama.
  4. Vektör depoyu, dosya arama için kullandığınız aracıya veya konuşmaya ekleyin. Ek limite dikkat edin. Bkz . Vektör depoları.
  5. Dosya araması kullanan bir yanıt oluşturun ve aracın beklenen kaynaklardan alındığını doğrulayın. Bkz. Dosya arama ile yanıt oluşturma ve Sonuçları doğrulama.
  6. Yaşam döngüsünü yönetme: Artık ihtiyacınız olmayan dosyaları kaldırın ve süre sonu ilkelerini planlayın (özellikle konuşma yardımcıları tarafından oluşturulan vektör depoları için). Bkz. Vektör depoları ve Konuşma vektör depoları için varsayılan süre sonu ilkeleri bulunmaktadır.

Dosya ekleme ve vektör depolarını yönetme

Vektör depolarına dosya eklemek zaman uyumsuz bir işlemdir. Alımın tamamlandığından emin olmak için resmi SDK'larda oluştur ve sorgula yardımcılarını kullanın. SDK kullanmıyorsanız, durumu tamamlanana ve in_progress hiçbir dosya kalmayana kadar vektör deposunu yoklayın.

Dosyalar, vektör deposu dosyaları oluşturularak oluşturulduktan sonra bir vektör deposuna da eklenebilir. Alternatif olarak, en fazla 500 dosyadan oluşan toplu işlemler oluşturarak vektör deposuna birkaç dosya ekleyebilirsiniz.

Vektör deposu oluşturmak için bir dosyayı karşıya yüklediğinizde sistem otomatik olarak:

  1. İçeriğinizi yönetilebilir parçalara ayırır.
  2. Ekleme modellerini kullanarak her öbeği yüksek boyutlu vektörlere dönüştürür.
  3. Bu vektörleri iyileştirilmiş bir arama dizininde depolar.
  4. Vektörlerle özgün içeriğiniz arasında ilişkilendirmeler oluşturur.

Vektör depolarından dosyaları kaldırma

Vektör deposundaki dosyaları iki farklı yolla kaldırabilirsiniz:

  • Vektör deposu dosya nesnesini silin.
  • Temel alınan dosya nesnesini silin. Bu işlem, dosyayı kuruluşunuzdaki tüm aracılar ve konuşmalar genelindeki tüm vektör deposu yapılandırmalarından kaldırır.

Süre sonu ilkeleriyle yaşam döngüsünü yönetme

Süre sonu ilkeleri vektör deposu yaşam döngüsünü yönetmenize yardımcı olur. Vektör deposu nesnesini oluştururken veya güncelleştirirken bu ilkeleri ayarlayabilirsiniz.

Konuşma vektör veri depolarının varsayılan zaman aşımı ilkeleri vardır

Konuşma yardımcıları kullanılarak oluşturulan vektör depoları, en son etkin olduktan sonraki yedi günlük varsayılan süre sonu ilkesine sahiptir (yanıt oluşturma sırasında vektör deposunun en son kullanıldığı zaman olarak tanımlanır).

Vektör deposu süresi dolduğunda, bu konuşma için yanıt oluşturma işlemi başarısız olur. Sorunu düzeltmek için aynı dosyalarla yeni bir vektör deposu oluşturun ve bunu konuşmaya yeniden yapıştırın. Daha fazla ayrıntı için Konuşma vektör depolarının varsayılan süre sonu ilkeleri vardır bölümüne bakın.

Desteklenen dosya türleri ve anahtar sınırları

Desteklenen dosya türleri listesi ve kodlama gereksinimleri için bkz . Desteklenen dosya türleri.

Dikkate almak için önemli sınırlar:

  • Bir aracıya en fazla bir vektör deposu ve bir konuşmaya en fazla bir vektör deposu ekleyebilirsiniz.
  • Dosya boyutu ve belirteç sınırları özelliğe göre değişir. Bkz. Kotalar ve sınırlar.

Sorun giderme

  • Vektör deponuz henüz aranamıyor: Veri aktarımının bitmesini bekleyin. SDK yoklama yardımcılarını kullanın veya durumu tamamlanana kadar vektör deposunu yoklayın.
  • Yanıt oluşturma işlemi birkaç gün sonra başarısız oluyor: Konuşma vektör deponuzun süresi dolmuş olabilir. Aynı dosyalarla yeni bir vektör deposu oluşturun ve yeniden yükleyin.
  • Birden çok aracıdan veya konuşmadan bir dosya kayboldu: Temel alınan dosya nesnesini silmiş olabilirsiniz, bu da dosyanın kuruluşunuzdaki tüm vektör depo yapılandırmalarından kaldırılmasına neden olur.
  • Karşıya yükleme veya içe alma başarısız olursa: Kotalar ve sınırlar bölümünde dosya boyutunu ve belirteç sınırlarını kontrol edin.