Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Not
Bazı aracısal alma özellikleri genellikle programlı erişim yoluyla 2026-04-01 REST API sürümünde kullanılabilir. Azure portalı ve Microsoft Foundry portalı, tüm aracısal alma özelliklerine yalnızca önizleme erişimi sağlamaya devam eder. Genel kullanıma sunulanların ve önizlemede kalanların dökümü de dahil olmak üzere geçiş kılavuzu için bkz. Aracı alma kodunu en son sürüme geçirme.
Önizleme REST API sürümünü kullanmayı seçerseniz, henüz genel kullanıma sunulmamış aracısal alma özelliklerine erişebilirsiniz. Önizleme özellikleri hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.
Bilgi kaynağı, aracılı alma için kullanılan içeriği belirtir. Dış verilerle doldurulmuş bir arama dizinini kapsüller veya doğrudan sorgulanan Bing veya SharePoint gibi uzak bir hedefe doğrudan bağlantıdır. Bilgi kaynağı, bilgi bankasında gerekli bir tanımdır.
Arama hizmetinizde üst düzey kaynak olarak bir bilgi kaynağı oluşturun. Her bilgi kaynağı, aracılı alma ölçütlerini karşılayan bir arama dizini veya desteklenen bir dış kaynak olmak üzere tam olarak bir veri yapısına işaret etmektedir.
Bilgi bankasındaki bir veya daha fazla bilgi kaynağına başvurma. Aracılı bir alma işlem hattında, tek bir istekte birden çok bilgi kaynağına göre sorgulayabilirsiniz. Her bilgi kaynağı için alt sorgular oluşturulur. Alma yanıtında en iyi sonuçlar döndürülür.
Belirli bilgi kaynakları için, aracılı alma için çalışan tam bir dizin oluşturucu işlem hattı (veri kaynağı, beceri kümesi, dizin oluşturucu ve dizin) oluşturmak için bir bilgi kaynağı tanımı kullanabilirsiniz. Bilgi kaynağındaki bilgiler, el ile birden çok nesne oluşturmak yerine doldurulmuş, öbeklenmiş ve aranabilir dizin gibi tüm nesneleri oluşturmak için kullanılır.
Bilgi bankası oluşturmadan önce en az bir bilgi kaynağınız olduğundan emin olun. Bilgi kaynakları ve bilgi bankaları için tam belirtimi REST API başvurusunda bulabilirsiniz.
Bilgi kaynağıyla çalışma
Oluşturma yolu: Önce bir bilgi kaynağı oluşturun, ardından bir bilgi bankası oluşturun.
Silme yolu: Bir bilgi kaynağına yapılan başvuruları kaldırmak için bilgi bankalarını güncelleyin veya silin ve ardından bilgi kaynağını en son olarak silin.
Bilgi kaynağı, dizini ve bilgi bankasının tümü aynı arama hizmetinde bulunmalıdır. Dış içeriğe genel internet (Bing) üzerinden veya Microsoft kiracısında (uzak SharePoint) erişilir.
Desteklenen bilgi kaynakları
Aşağıdaki bilgi kaynaklarını oluşturabilirsiniz:
| Tür | Dizine alınan veya uzaktan erişilebilir |
|---|---|
"searchIndex" API var olan bir dizini sarmalar. |
Endekslenmiş |
"azureBlob" API, bir blob kapsayıcısından veri çeken bir dizin oluşturucu işlem hattı üretir. |
Endekslenmiş |
"indexedOneLake" API , bir lakehouse'tan çeken bir dizin oluşturucu işlem hattı oluşturur. |
Endekslenmiş |
"indexedSharePoint" API (önizleme), bir SharePoint sitesinden veri alan bir endeksleyici işlem hattı üretir. |
Endekslenmiş |
"remoteSharePoint" API (önizleme) içeriği doğrudan SharePoint'ten alır. |
Uzaktan |
"web" API, Microsoft Bing'den gerçek zamanlı veri alır. |
Uzaktan |
Dizine eklenen bilgi kaynakları, Azure Yapay Zeka Arama üzerinde hedef bir dizine işaret eder. Sorgu yürütme, arama hizmetinizdeki arama altyapısı için yereldir. Anahtar sözcük (tam metin araması), vektör ve karma sorgu özellikleri, dizine alınan bilgi kaynaklarından veri almak için kullanılır.
Sorgu zamanında uzak bilgi kaynaklarına erişebilirsiniz. Etkin alma motoru, platforma özgü alma API'lerini (Bing veya SharePoint API'leri) çağırır.
Dizine alınmış içerik veya uzak içerik olsun, alınan tüm içerik, ilgi düzeyine göre puanlandığı, birleştirildiği (birden çok sorgu olduğu varsayılarak), yeniden sıralandığı ve alma yanıtında döndürüldüğü Azure Yapay Zeka Arama sıralama işlem hattına çekilir.
Bilgi kaynakları oluşturma
Bilgi kaynaklarını tek başına nesneler olarak oluşturun. Ardından, bunları bir "knowledgeSources" dizisi içindeki bir bilgi bankasında belirtin.
Bir arama hizmetinde nesne oluşturmak için Arama Hizmeti Katkıda Bulunanı izinlerine sahip olmanız gerekir. Dizin oluşturucu işlem hattı oluşturan bir bilgi kaynağı kullanıyorsanız, dizini yüklemek için Dizin Verileri Katkıda Bulunanı Arama izinlerine de ihtiyacınız vardır. Alternatif olarak, roller yerine bir API yönetici anahtarı kullanabilirsiniz .
Bilgi kaynağı oluşturmak için Azure portalını, REST API'yi veya Azure SDK paketini kullanın. Aşağıdaki bağlantılar bilgi kaynağı oluşturmaya yönelik yönergeler sağlar:
- Arama dizini bilgi kaynağı oluşturma (var olan bir dizini sarmalar)
- Bir blob bilgi kaynağı nasıl oluşturulur (bir dizin oluşturucu işlem hattı oluşturur)
- OneLake bilgi kaynağı oluşturma (indeksleyici işlem hattı oluşturma)
- SharePoint (dizinli) bilgi kaynağı oluşturma (dizin oluşturucu işlem hattı üretme)
- SharePoint üzerinden uzaktan bilgi kaynağı oluşturma (SharePoint'i doğrudan sorgular)
- Web Bilgi Kaynağı kaynağı oluşturma (Bing'in genel uç noktasına bağlanır)
Bilgi kaynağını oluşturduktan sonra bilgi bankasında bu kaynağa başvurun.
Bilgi kaynaklarını kullanma
Bilgi kaynağı tanımını ayarlayarak alwaysQuery veya sorgu planlaması sırasında kullanılan yönlendirme yönergelerini kullanarak bilgi kaynağı kullanımını açıkça denetleyebilirsiniz. Yönlendirme yönergeleri, dizindeki açıklamalara veya bilgi kaynağında dizini ne zaman kullanacağınıza ilişkin yönergeler sağlayan açık alma yönergelerine başvurur.
LLM'den düşük veya orta düzeyde geri çağırma gerekçelendirme çabası kullandığınızda sorgu planlaması gerçekleşir. En düşük düzeyde bir akıl yürütme çalışması için, bilgi bankasında listelenen tüm bilgi kaynakları her sorgunun kapsamındadır. Düşük ve orta düzeyde bilgi bankası ve LLM, sorgu zamanında hangi bilgi kaynaklarının en iyi arama corpus'unu sağlama olasılığını belirleyebilir.
Bilgi kaynağı seçim mantığı şu faktörleri temel alır:
Ayarlandı mı
alwaysQuery? Evet ise, bilgi kaynağı her zaman her sorguda kullanılır.namebilgiyi kaynağının özelliği.Dizine
descriptionalınan bir bilgi kaynağı varsayılarak bir dizinin değeri.Belirlenen
retrievalInstructions, alma eyleminde veya bilgi bankası tanımında yer alan ve bir bilgi kaynağını dahil eden veya hariç tutan yönergeleri sağlar. Komut istemine benzer. Alma yönergesi olarak kısa, ton ve biçimlendirme belirtebilirsiniz.outputModebir bilgi bankasında sorgu çıktısını ve yanıtta neler olduğunu da etkiler.
LLM kullanımını kontrol etmek için bilgi erişimi muhakeme çabası kullanma
Tüm çözümler LLM sorgu planlama ve yürütmeden yararlanmaz. Basitlik ve hız LLM sorgu planlama ve bağlam mühendisliğinin sağladığı avantajlardan daha ağır basıyorsa, işlem hattınızda LLM işlemesini önlemek için en düşük düzeyde bir akıl yürütme çabası belirtin.
Düşük ve orta düzeyde LLM işleme düzeyi, ilgi düzeyini artıran dengeli veya en üst düzey bir yaklaşımdır. Daha fazla bilgi için bkz. Geri alma mantığını ayarlama çabası.
Not
Önceki önizlemede attemptFastPath kullandıysanız, bu yaklaşım şimdi retrievalReasoningEffort olarak ayarlanmış minimal ile değiştirildi.