Azure Yapay Zeka Arama

Azure Yapay Zeka Arama, geleneksel ve üretken yapay zeka arama uygulamalarında kullanıcıya ait içeriğe göre büyük ölçekte güvenli bilgi alma olanağı sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - Azure Çin bölgeleri      - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	Microsoft
URL	https://support.microsoft.com

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web sitesi	https://learn.microsoft.com/en-us/azure/search/search-what-is-azure-search/
Kategoriler	AI; İş Zekası
Gizlilik ilkesi	https://privacy.microsoft.com/en-us/privacystatement

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

[variables('connectionStringAuthDefaultDisplayName')]	[variables('connectionStringAuthDefaultDescription')]	Azure Kamu ve ABD Kamu (GCC) dışındaki tüm bölgeler	Paylaşılamaz
Erişim Anahtarı	Azure AI Aramanıza erişmek için bağlantı dizesi sağlayın.	Yalnızca Azure Kamu ve ABD Hükümeti (GCC)	Paylaşılamaz
İstemci Sertifikası Kimlik Doğrulaması	PFX sertifikasını ve parolasını kullanarak Microsoft Entra Id kimlik bilgilerini sağlayın	Tüm bölgeler	Paylaşılabilir
Yönetilen Kimlik	Yönetilen Kimlik kullanarak bağlantı oluşturma	Yalnızca LOGICAPPS	Paylaşılabilir
Microsoft Entra ID Tümleşik	Erişmek için Microsoft Entra Id kullanma	Tüm bölgeler	Paylaşılamaz
Hizmet sorumlusu (Microsoft Entra ID uygulaması)	Azure AI Aramanıza erişmek için Microsoft Entra ID uygulamasını kullanın.	Tüm bölgeler	Paylaşılamaz
Varsayılan [KULLANIM DIŞI]	Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.	Tüm bölgeler	Paylaşılamaz

[variables('connectionStringAuthDefaultDisplayName')]

Kimlik Doğrulama Kimliği: adminkey

Geçerli: Azure Kamu ve ABD Kamu (GCC) dışındaki tüm bölgeler

[variables('connectionStringAuthDefaultDescription')]

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Bağlanmak için Azure AI Arama Uç Noktası	Doğru
Azure AI Arama Yönetici Anahtarı	securestring	Azure Yapay Zeka Arama'e bağlanmak için Yönetici Anahtarı	Doğru

Erişim Tuşu

Kimlik Doğrulama Kimliği: adminkey

Geçerli: yalnızca Azure Kamu ve ABD Kamu (GCC)

Azure AI Aramanıza erişmek için bağlantı dizesi sağlayın.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Bağlanmak için Azure AI Arama Uç Noktası	Doğru
Azure AI Arama Yönetici Anahtarı	securestring	Azure Yapay Zeka Arama'e bağlanmak için Yönetici Anahtarı	Doğru

İstemci Sertifikası Kimlik Doğrulaması

Kimlik Doğrulama Kimliği: certOauth

Geçerli: Tüm bölgeler

PFX sertifikasını ve parolasını kullanarak Microsoft Entra Id kimlik bilgilerini sağlayın

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Azure AI Arama Ad Alanı Uç Noktası sağlama (ör. ai://testai.search.windows.net/)	Doğru
Tenant	String		Doğru
Müşteri Kimliği	String	Microsoft Entra Id uygulaması için istemci kimliği
İstemci sertifikası gizli dizisi	istemci sertifikası	Bu uygulama tarafından izin verilen istemci sertifikası gizli dizisi	Doğru

Yönetimli Kimlik

Kimlik Doğrulaması Kimliği: managedIdentityAuth

Uygulanabilir: Yalnızca LOGICAPPS

Yönetilen Kimlik kullanarak bağlantı oluşturma

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim	Türü	Description	Gerekli
Yönetimli Kimlik	managedIdentity	Yönetilen Kimlik ile oturum açma	Doğru
Azure AI Arama Uç Noktası URL'si	String	Azure AI Arama Ad Alanı Uç Noktası sağlama (ör. ai://testai.search.windows.net/)	Doğru

Microsoft Entra Kimliği Entegre

Kimlik Doğrulama Kimliği: oauth

Geçerli: Tüm bölgeler

Erişmek için Microsoft Entra Id kullanma

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Azure AI Arama Ad Alanı Uç Noktası sağlama (ör. ai://testai.search.windows.net/)	Doğru

Hizmet sorumlusu (Microsoft Entra ID uygulaması)

Kimlik Doğrulama Kimliği: oauthSP

Geçerli: Tüm bölgeler

Azure AI Aramanıza erişmek için Microsoft Entra ID uygulamasını kullanın.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Azure AI Arama Ad Alanı Uç Noktası sağlama (ör. ai://testai.search.windows.net/)	Doğru
Tenant	String		Doğru
Müşteri Kimliği	String		Doğru
İstemci Sırrı	securestring		Doğru

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Azure AI Arama Uç Noktası URL'si	String	Bağlanmak için Azure AI Arama Uç Noktası	Doğru
Azure AI Arama Yönetici Anahtarı	securestring	Azure Yapay Zeka Arama'e bağlanmak için Yönetici Anahtarı	Doğru

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	200	60 saniye

Eylemler

Anlamsal Karma Arama	Filtre ile anlamsal karma arama.
Aracılı Arama (Önizleme)	Aracı arama.
Arama dizinlerini alma	Bu işlem, Azure Yapay Zeka Arama'teki alan ayrıntılarını içeren tüm dizinler şemasını alır.
Arama vektörleri	Filtre içeren tek bir vektör araması.
Belgeyi birleştirme	Tek bir belgeyi birleştirme.
Belgeyi dizine ekleme	Tek bir belgeyi dizine ekleme.
Belgeyi silme	Tek bir belgeyi silin.
Birden çok belgeyi dizine ekle	Belirtilen belgelerin dizinini oluşturun.
Birden çok belgeyi silme	Belirtilen belgeleri silin.
Dizin istatistiklerini alma	Bu işlem, Azure Yapay Zeka Arama'teki bir dizine ilişkin istatistikleri alır.
Doğal dil ile arama vektörleri	Doğal dil ile arama vektörleri.

Anlamsal Karma Arama

İşlem Kimliği:

SemanticHybridSearch

Filtre ile anlamsal karma arama.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.
Metin Ara	searchText		string	Metin Ara
Vektörleştirilmiş Arama Alanları	vectorizedSearchFields		array of string	Vektörleştirilmiş Arama Alanları
AnlamSal Yapılandırma	semanticConfiguration		string	AnlamSal Yapılandırma
Alanları Seç	selectFields		array of string	Alanları Seç
Filtre koşulu	filterCondition		string	Filtre koşulu
Oturum Kimliği (SessionId)	sessionId		string	Oturum Kimliği (SessionId)
En Yakın Komşular	nearestNeighbors		integer	En Yakın Komşular
En Çok Yapılan Aramalar	top		integer	En Çok Yapılan Aramalar
Aramaları Atla	skipSearches		integer	Aramaları Atla

Döndürülenler

response

array of Object

Aracılı Arama (Önizleme)

İşlem Kimliği:

KnowledgeAgentRetrieval

Aracı arama.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.
Aracı Adı	agentName	True	string	Aracı adı.
Rol	role		string	Rol
Aracı İleti İçeriği	content		string	Aracı İleti İçeriği

Döndürülenler

Vücut

AgenticRetrievalOutput

Arama dizinlerini alma

İşlem Kimliği:

GetIndexesSchema

Bu işlem, Azure Yapay Zeka Arama'teki alan ayrıntılarını içeren tüm dizinler şemasını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Yalnızca Tümleşik Vektörlere Sahip Dizinler	onlyIntegratedVectorIndexes		boolean	True ise, yalnızca tümleşik vektörlere sahip dizinler döndürülür.

Döndürülenler

response

array of Object

Arama vektörleri

İşlem Kimliği:

VectorSearch

Filtre içeren tek bir vektör araması.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.
Vektör Alanları ve Değerleri Arama Vektör Alanı Adı	vectorFieldsName	True	string	Arama vektör alanı adı.
vectorFieldsValue	vectorFieldsValue	True	array of float
Döndürülecek En Yakın Komşu Sayısı	nearestNeighbors	True	integer	Geri dönecek en yakın komşu sayısı.
Search	searchQuery		string	Arama sorgusu koşulu
Arama Modu	searchMode		string	Arama Modu
Filtre koşulu	filterCondition		string	En yakın komşuları bulmadan önce uygulanacak filtreleme koşulu.

Döndürülenler

Name	Yol	Tür	Description
		array of string

Belgeyi birleştirme

İşlem Kimliği:

MergeDocument

Tek bir belgeyi birleştirme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Belgeyi dizine ekleme

İşlem Kimliği:

IndexDocument

Tek bir belgeyi dizine ekleme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Döndürülenler

response

object

Belgeyi silme

İşlem Kimliği:

DeleteDocument

Tek bir belgeyi silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Birden çok belgeyi dizine ekle

İşlem Kimliği:

IndexDocuments

Belirtilen belgelerin dizinini oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Döndürülenler

response

object

Birden çok belgeyi silme

İşlem Kimliği:

DeleteDocuments

Belirtilen belgeleri silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Dizin istatistiklerini alma

İşlem Kimliği:

GetIndexStatistics

Bu işlem, Azure Yapay Zeka Arama'teki bir dizine ilişkin istatistikleri alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.

Döndürülenler

response

object

Doğal dil ile arama vektörleri

İşlem Kimliği:

IntegratedVectorSearch

Doğal dil ile arama vektörleri.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dizin Adı	indexName	True	string	Dizin adı.
Metin Ara	searchText		string	Metin Ara
Vektörleştirilmiş Arama Alanları	vectorizedSearchFields		array of string	Vektörleştirilmiş Arama Alanları
Alanları Seç	selectFields		array of string	Alanları Seç
Filtre koşulu	filterCondition		string	Filtre koşulu
Oturum Kimliği (SessionId)	sessionId		string	Oturum Kimliği (SessionId)
En Yakın Komşular	nearestNeighbors		integer	En Yakın Komşular
En Çok Yapılan Aramalar	top		integer	En Çok Yapılan Aramalar
Aramaları Atla	skipSearches		integer	Aramaları Atla

Döndürülenler

response

array of Object

Tanımlar

Nesne

AgenticRetrievalOutput

Name	Yol	Tür	Description
response	response	array of AgenticRetrievalOutput_Response
etkinlik	activity	array of AgenticRetrievalOutput_Activity
Başvuru	references	array of AgenticRetrievalOutput_References

AgenticRetrievalOutput_Response

Name	Yol	Tür	Description
Aracı İletiSi Yanıt Rolü	role	string	Aracı İletiSi Yanıt Rolü
içerik	content	array of AgenticRetrievalOutput_Response_Content

AgenticRetrievalOutput_Response_Content

Name	Yol	Tür	Description
Aracı İletisi Yanıt Türü	type	string	Aracı İletisi Yanıt Türü
Aracı İletisi Yanıt Metni	text	array of object	Aracı İletisi Yanıt Metni
items	text	object

AgenticRetrievalOutput_Activity

Name	Yol	Tür	Description
Aracı İleti Etkinliği	type	string	Aracı İleti Etkinliği
Aracı İleti Kimliği	id	string	Aracı İleti Kimliği
Aracı İletisi Giriş Belirteçleri	inputTokens	string	Aracı İletisi Giriş Belirteçleri
Aracı İletisi Çıkış Belirteçleri	outputTokens	string	Aracı İletisi Çıkış Belirteçleri
Aracı İletisi Hedef Dizini	targetIndex	string	Aracı İletisi Hedef Dizini
Aracı İleti Arama Sorgusu	query.search	string	Aracı İleti Arama Sorgusu
Aracı İletisi Sorgu Filtresi	query.filter	string	Aracı İletisi Sorgu Filtresi
Aracı İletisi Sorgu Süresi	queryTime	string	Aracı İletisi Sorgu Süresi
Aracı İleti Sayısı	count	string	Aracı İleti Sayısı

AgenticRetrievalOutput_References

Name	Yol	Tür	Description
Aracı İletiSi Başvuru Türü	type	string	Aracı İletiSi Başvuru Türü
Aracı İletiSi Başvuru Kimliği	id	string	Aracı İletiSi Başvuru Kimliği
Aracı İleti Başvurusu Etkinlik Kaynağı	activitySource	string	Aracı İleti Başvurusu Etkinlik Kaynağı
Aracı İleti Başvurusu Belge Anahtarı	docKey	string	Aracı İleti Başvurusu Belge Anahtarı
Aracı İletisi Başvuru Kaynak Verileri	sourceData	string	Aracı İletisi Başvuru Kaynak Verileri

object

Bu , 'object' türüdür.