Knowledge Sources - Create Or Update
Yeni bir bilgi kaynağı oluşturur veya zaten varsa bir bilgi kaynağını güncelleştirir.
PUT {endpoint}/knowledgesources('{sourceName}')?api-version=2026-11-01-preview
URI Parametreleri
| Veri Akışı Adı | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Arama hizmetinin uç nokta URL'si. |
|
source
|
path | True |
string |
Bilgi kaynağının adı. |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
|
| Accept |
Accept başlığı. |
||
| If-Match |
string |
If-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşirse gerçekleştirilir. |
|
| If-None-Match |
string |
If-None-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşmiyorsa gerçekleştirilir. |
|
| Prefer | True |
HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler. |
İstek Gövdesi
İstek gövdesi şunlardan biri olabilir:
| Veri Akışı Adı | Description |
|---|---|
|
Azure |
Azure Blob Depolama bilgi kaynağı yapılandırması. |
|
Fabric |
Fabric Data Agent bilgi kaynağı için yapılandırma. |
|
Fabric |
Fabric Ontology bilgi kaynağı için yapılandırma. |
|
File |
Dosya bilgi kaynağının doğrudan dosya yükleme ve indekslemesini destekleyen yapılandırma. |
|
Indexed |
OneLake bilgi kaynağı için yapılandırma. |
|
Indexed |
SharePoint bilgi kaynağı yapılandırması. |
|
Indexed |
Indeksli SQL bilgi kaynağı için yapılandırma. |
|
Mcp |
MCP (Model Context Protocol) sunucusu tarafından desteklenen bilgi kaynağı için yapılandırma. |
|
Remote |
Uzak SharePoint bilgi kaynağı yapılandırması. |
|
Search |
Bir arama dizinini hedefleyen Bilgi Kaynağı. |
|
Web |
Web sonuçlarını hedefleyen Bilgi Kaynağı. |
|
Work |
WorkIQ bilgi kaynağı için yapılandırma. |
AzureBlobKnowledgeSource
Azure Blob Depolama bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| azureBlobParameters | True |
Bilgi kaynağının türü. |
|
| kind | True |
string:
azure |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FabricDataAgentKnowledgeSource
Fabric Data Agent bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| fabricDataAgentParameters | True |
Fabric Data Agent bilgi kaynağı parametreleri. |
|
| kind | True |
string:
fabric |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FabricOntologyKnowledgeSource
Fabric Ontology bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| fabricOntologyParameters | True |
Fabric Ontology bilgi kaynağı parametreleri. |
|
| kind | True |
string:
fabric |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FileKnowledgeSource
Dosya bilgi kaynağının doğrudan dosya yükleme ve indekslemesini destekleyen yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| fileParameters | True |
Dosya bilgi kaynağı parametreleri. |
|
| kind | True |
string:
file |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| corsOptions |
Dosya bilgi kaynağının dosya uç noktaları için Çapraz Kaynak Paylaşımı (CORS) kontrol seçenekleri (yükleme, liste, güncelleme, sil). |
||
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedOneLakeKnowledgeSource
OneLake bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| indexedOneLakeParameters | True |
Bilgi kaynağı için parametreler. |
|
| kind | True |
string:
indexed |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedSharePointKnowledgeSource
SharePoint bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| indexedSharePointParameters | True |
Bilgi kaynağı için parametreler. |
|
| kind | True |
string:
indexed |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedSqlKnowledgeSource
Indeksli SQL bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| indexedSqlParameters | True |
SQL bilgi kaynağı için parametreler. |
|
| kind | True |
string:
indexed |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
McpServerKnowledgeSource
MCP (Model Context Protocol) sunucusu tarafından desteklenen bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| kind | True |
string:
mcp |
Bilgi kaynağının türü. |
| mcpServerParameters | True |
MCP sunucu bilgi kaynağı parametreleri. |
|
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
RemoteSharePointKnowledgeSource
Uzak SharePoint bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| kind | True |
string:
remote |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| remoteSharePointParameters |
Uzak SharePoint bilgi kaynağı parametreleri. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
SearchIndexKnowledgeSource
Bir arama dizinini hedefleyen Bilgi Kaynağı.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| kind | True |
string:
search |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| searchIndexParameters | True |
Bilgi kaynağı için parametreler. |
|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
WebKnowledgeSource
Web sonuçlarını hedefleyen Bilgi Kaynağı.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| kind | True |
string:
web |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
||
| webParameters |
Web bilgi kaynağı için parametreler. |
WorkIQKnowledgeSource
WorkIQ bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| kind | True |
string:
workIQ |
Bilgi kaynağının türü. |
| name | True |
string |
Bilgi kaynağının adı. |
| workIQParameters | True |
WorkIQ bilgi kaynağı parametreleri, kimlik doğrulama için kullanılan müşteriye ait Entra uygulama yapılandırması dahil. |
|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
|
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
||
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 200 OK |
KnowledgeSource:
|
İstek başarılı oldu. |
| 201 Created |
KnowledgeSource:
|
İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu. |
| Other Status Codes |
Beklenmeyen bir hata yanıtı. |
Güvenlik
api-key
Tür:
apiKey
İçinde:
header
OAuth2Auth
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Kapsamlar
| Veri Akışı Adı | Description |
|---|---|
| https://search.azure.com/.default |
Örnekler
SearchServiceAttachKnowledgeSourceGraphOntology
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-graph-cache')?api-version=2026-11-01-preview
{
"name": "ks-graph-cache",
"kind": "azureBlob",
"@odata.etag": "\"0\"",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"isADLSGen2": false,
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": true,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "minimal",
"cache": {
"storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-graph-cache",
"kind": "azureBlob",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": true,
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"cache": {
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
},
"createdResources": {
"datasource": "ks-graph-cache-datasource",
"indexer": "ks-graph-cache-indexer",
"skillset": "ks-graph-cache-skillset",
"index": "ks-graph-cache-index"
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-graph-cache",
"kind": "azureBlob",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": true,
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"cache": {
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
},
"createdResources": {
"datasource": "ks-graph-cache-datasource",
"indexer": "ks-graph-cache-indexer",
"skillset": "ks-graph-cache-skillset",
"index": "ks-graph-cache-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSource
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "searchIndex",
"resultsProcessing": "none",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"boostInstructions": "Document language; pick from the user's locale.",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2
}
]
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "searchIndex",
"description": "Description of the knowledge source.",
"resultsProcessing": "none",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2,
"boostInstructions": "Document language; pick from the user's locale."
}
]
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "searchIndex",
"description": "Description of the knowledge source.",
"resultsProcessing": "none",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2,
"boostInstructions": "Document language; pick from the user's locale."
}
]
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlob
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "azureBlob",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
},
"networkAccessMode": "private"
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "azureBlob",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"networkAccessMode": "private",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "azureBlob",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"networkAccessMode": "private",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlobWithTopicGraphs
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "azureBlob",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
},
"networkAccessMode": "private"
},
"topicGraph": {
"kind": "diverse",
"minDiversityPoolSize": 1000,
"diversityFactor": 0.1
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "azureBlob",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"networkAccessMode": "private",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "azureBlob",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"folderPath": "test-path",
"isADLSGen2": false,
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"networkAccessMode": "private",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceCompatibleResponses
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('image-documents')?api-version=2026-11-01-preview
{
"name": "image-documents",
"kind": "azureBlob",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "documents",
"ingestionParameters": {
"chatCompletionModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini",
"headers": {
"api-key": "test-key"
}
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
Örnek yanıt
{
"name": "image-documents",
"kind": "azureBlob",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "documents",
"ingestionParameters": {
"chatCompletionModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini"
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
{
"name": "image-documents",
"kind": "azureBlob",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "documents",
"ingestionParameters": {
"chatCompletionModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini"
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceFile
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the File knowledge source.",
"kind": "file",
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "ks-preview-test-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "ks-preview-test-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedOneLake
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the OneLake knowledge source.",
"kind": "indexedOneLake",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedOneLakeParameters": {
"fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
}
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedOneLake",
"description": "Description of the OneLake knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedOneLakeParameters": {
"fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"disableImageVerbalization": false,
"contentExtractionMode": "standard",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedOneLake",
"description": "Description of the OneLake knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedOneLakeParameters": {
"fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"disableImageVerbalization": false,
"contentExtractionMode": "standard",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSharePoint
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the SharePoint knowledge source.",
"kind": "indexedSharePoint",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSharePointParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "defaultSiteLibrary",
"query": "*.docx OR *.pdf",
"ingestionParameters": {
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"userIds",
"groupIds"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedSharePoint",
"description": "Description of the SharePoint knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSharePointParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "defaultSiteLibrary",
"query": "*.docx OR *.pdf",
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"userIds",
"groupIds"
],
"contentExtractionMode": "standard",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedSharePoint",
"description": "Description of the SharePoint knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSharePointParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "defaultSiteLibrary",
"query": "*.docx OR *.pdf",
"ingestionParameters": {
"disableImageVerbalization": false,
"ingestionPermissionOptions": [
"userIds",
"groupIds"
],
"contentExtractionMode": "standard",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSql
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the SQL knowledge source.",
"kind": "indexedSql",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSqlParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"tableOrView": "dbo.Products",
"contentColumns": [
{
"name": "title",
"sourceField": "Title",
"searchFieldType": "Edm.String"
},
{
"name": "description",
"sourceField": "Description",
"searchFieldType": "Edm.String"
},
{
"name": "price",
"sourceField": "Price",
"searchFieldType": "Edm.Double"
}
],
"embeddingColumns": [
{
"name": "descriptionEmbedding",
"sourceField": "Description"
}
],
"ingestionParameters": {
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "minimal"
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedSql",
"description": "Description of the SQL knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSqlParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"tableOrView": "dbo.Products",
"contentColumns": [
{
"name": "title",
"sourceField": "Title",
"searchFieldType": "Edm.String"
},
{
"name": "description",
"sourceField": "Description",
"searchFieldType": "Edm.String"
},
{
"name": "price",
"sourceField": "Price",
"searchFieldType": "Edm.Double"
}
],
"embeddingColumns": [
{
"name": "descriptionEmbedding",
"sourceField": "Description"
}
],
"ingestionParameters": {
"contentExtractionMode": "minimal",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
}
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "indexedSql",
"description": "Description of the SQL knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedSqlParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"tableOrView": "dbo.Products",
"contentColumns": [
{
"name": "title",
"sourceField": "Title",
"searchFieldType": "Edm.String"
},
{
"name": "description",
"sourceField": "Description",
"searchFieldType": "Edm.String"
},
{
"name": "price",
"sourceField": "Price",
"searchFieldType": "Edm.Double"
}
],
"embeddingColumns": [
{
"name": "descriptionEmbedding",
"sourceField": "Description"
}
],
"ingestionParameters": {
"contentExtractionMode": "minimal",
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/my/userassigned/id"
},
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceMcpServer
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the MCP server knowledge source.",
"kind": "mcpServer",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"mcpServerParameters": {
"serverURL": "https://mcp.contoso.com/sse",
"authentication": {
"kind": "foundryConnection",
"foundryConnectionParameters": {
"connectionId": "conn-123"
}
},
"tools": [
{
"name": "search-code",
"outputParsing": {
"kind": "json",
"jsonParameters": {
"documentsPath": "$.documents[*]",
"includeContext": true
}
},
"resultsProcessing": "rerank",
"maxOutputTokens": 4096
}
]
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "mcpServer",
"description": "Description of the MCP server knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"mcpServerParameters": {
"serverURL": "https://mcp.contoso.com/sse",
"authentication": {
"kind": "foundryConnection",
"foundryConnectionParameters": {
"connectionId": "conn-123"
}
},
"tools": [
{
"name": "search-code",
"resultsProcessing": "rerank",
"maxOutputTokens": 4096,
"outputParsing": {
"kind": "json",
"jsonParameters": {
"documentsPath": "$.documents[*]",
"includeContext": true
}
}
}
]
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "mcpServer",
"description": "Description of the MCP server knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"mcpServerParameters": {
"serverURL": "https://mcp.contoso.com/sse",
"authentication": {
"kind": "foundryConnection",
"foundryConnectionParameters": {
"connectionId": "conn-123"
}
},
"tools": [
{
"name": "search-code",
"resultsProcessing": "rerank",
"maxOutputTokens": 4096,
"outputParsing": {
"kind": "json",
"jsonParameters": {
"documentsPath": "$.documents[*]",
"includeContext": true
}
}
}
]
}
}
SearchServiceCreateOrUpdateKnowledgeSourceOpenAICompatible
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('compatible-preview-file-source')?api-version=2026-11-01-preview
{
"name": "compatible-preview-file-source",
"description": "Description of the File knowledge source.",
"kind": "file",
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
"modelName": "text-embedding-3-small",
"dimensions": 1024,
"headers": {
"api-key": "EXAMPLE-NOT-A-REAL-SECRET",
"x-route-key": "EXAMPLE-NOT-A-REAL-ROUTING-SECRET"
}
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "compatible-preview-file-source",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
"modelName": "text-embedding-3-small",
"dimensions": 1024
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "compatible-preview-file-source-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "compatible-preview-file-source",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "openAICompatible",
"openAICompatibleParameters": {
"uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
"modelName": "text-embedding-3-small",
"dimensions": 1024
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "compatible-preview-file-source-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWeb
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"webParameters": {
"domains": {
"allowedDomains": [
{
"address": "example.com",
"includeSubpages": true
},
{
"address": "another-example.com"
}
],
"blockedDomains": [
{
"address": "blocked.com"
},
{
"address": "spam.com",
"includeSubpages": true
}
]
}
},
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "web",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "web",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"webParameters": {
"domains": {
"allowedDomains": [
{
"address": "example.com",
"includeSubpages": true
},
{
"address": "another-example.com"
}
],
"blockedDomains": [
{
"address": "blocked.com"
},
{
"address": "spam.com",
"includeSubpages": true
}
]
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "web",
"description": "Description of the knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"webParameters": {
"domains": {
"allowedDomains": [
{
"address": "example.com",
"includeSubpages": true
},
{
"address": "another-example.com"
}
],
"blockedDomains": [
{
"address": "blocked.com"
},
{
"address": "spam.com",
"includeSubpages": true
}
]
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWithTopicGraphs
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "searchIndex",
"resultsProcessing": "none",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"boostInstructions": "Document language; pick from the user's locale.",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2
}
]
},
"topicGraph": {
"kind": "diverse",
"minDiversityPoolSize": 1000,
"diversityFactor": 0.1
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "searchIndex",
"description": "Description of the knowledge source.",
"resultsProcessing": "none",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2,
"boostInstructions": "Document language; pick from the user's locale."
}
]
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "searchIndex",
"description": "Description of the knowledge source.",
"resultsProcessing": "none",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2,
"boostInstructions": "Document language; pick from the user's locale."
}
]
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWorkIQ
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the WorkIQ knowledge source.",
"kind": "workIQ",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"workIQParameters": {
"entraAppAuthentication": {
"applicationId": "11111111-1111-1111-1111-111111111111",
"federatedCredentialId": "22222222-2222-2222-2222-222222222222"
}
}
}
Örnek yanıt
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "workIQ",
"description": "Description of the WorkIQ knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"workIQParameters": {
"entraAppAuthentication": {
"applicationId": "11111111-1111-1111-1111-111111111111",
"federatedCredentialId": "22222222-2222-2222-2222-222222222222"
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "workIQ",
"description": "Description of the WorkIQ knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"isServiceLevelKey": false,
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"workIQParameters": {
"entraAppAuthentication": {
"applicationId": "11111111-1111-1111-1111-111111111111",
"federatedCredentialId": "22222222-2222-2222-2222-222222222222"
}
}
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
| Accept |
Accept başlığı. |
| AIServices |
Yapay Zeka Hizmetleri için Parametreler. |
|
Asset |
Görüntüler gibi çıkarılmış varlıkları depolamak için kullanılan bir varlık deposu için yapılandırma. |
|
Azure |
Azure Blob Depolama bilgi kaynağı yapılandırması. |
|
Azure |
Azure Blob Depolama bilgi kaynağı için parametreler. |
|
Azure |
Çağrılacak Azure Open AI model adı. |
|
Azure |
Azure OpenAI kaynağına bağlanmak için parametreleri belirtir. |
|
Balanced |
Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor. |
|
Content |
Bir SQL sütununu arama indeks alanına eşler. |
|
Cors |
Dizin için Çıkış Noktaları Arası Kaynak Paylaşımını (CORS) denetleme seçeneklerini tanımlar. |
|
Diverse |
Konu grafiği çeşitli erişim kullanır. |
|
Embedding |
Bir SQL sütununu gömmek için bir vektör alanına eşler. |
|
Entra |
Kimlik doğrulama adına federe kimlik doğrulama için kullanılan müşteri sahibi Microsoft Entra uygulaması kaydı için yapılandırma. |
|
Error |
Kaynak yönetimi hatasına ilişkin ek bilgiler. |
|
Error |
Hata ayrıntısı. |
|
Error |
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.). |
|
Fabric |
Fabric Data Agent bilgi kaynağı için yapılandırma. |
|
Fabric |
Fabric Data Agent bilgi kaynağı için parametreler. |
|
Fabric |
Fabric Ontology bilgi kaynağı için yapılandırma. |
|
Fabric |
Fabric Ontology bilgi kaynağı için parametreler. |
|
File |
Dosya bilgi kaynağının doğrudan dosya yükleme ve indekslemesini destekleyen yapılandırma. |
|
File |
Dosya bilgi kaynağı için parametreler. |
|
Freshness |
Tazelik farkında geri alma için yapılandırma. Ayarlandığında, yeni belgeler geri alma sırasında sıralama artışı alır. |
|
Indexed |
OneLake bilgi kaynağı için yapılandırma. |
|
Indexed |
OneLake bilgi kaynağı için parametreler. |
|
Indexed |
Hangi SharePoint kitaplıklarına erişileceğini belirtir. |
|
Indexed |
SharePoint bilgi kaynağı yapılandırması. |
|
Indexed |
SharePoint bilgi kaynağı parametreleri. |
|
Indexed |
Indeksli SQL bilgi kaynağı için yapılandırma. |
|
Indexed |
İndekslenmiş SQL bilgi kaynağı parametreleri. |
|
Indexing |
Dizin oluşturucu yürütme zamanlamasını temsil eder. |
|
Knowledge |
Sorgu planlaması yapmak için kullanılan Azure OpenAI kaynağını belirtir. |
|
Knowledge |
Sorgu planlama ve alma için kullanılan Microsoft Retriever 1'i belirtir. |
|
Knowledge |
Sorgu planlaması için kullanılacak yapay zeka modeli. |
|
Knowledge |
Bilgi tabanı erişimi veya Minimal mod bilgi kaynağı görüntü sözlü kullanımı için müşteri kontrollü OpenAI uyumlu bir model belirtir. Erişim için model profili Sohbet Tamamlamaları veya Yanıtlar seçer. Standard/CU çıkarımı veya Web bilgi kaynaklarına sahip bilgi tabanları için desteklenmez. |
|
Knowledge |
OpenAI uyumlu bir Sohbet Tamamlama veya Yanıtlar uç noktası için bağlantı parametreleri. Oluşturma için tam olarak boş olmayan başlıklardan veya managedIdentityAudience gereklidir. Güncellemeler, bağlantı ve model profili için kimlik bilgilerini korumak amacıyla başlıkları atlayabilir. |
|
Knowledge |
Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir. |
|
Knowledge |
Önbelleğe alınmış bilgi kaynağı zenginleştirme sonuçları için depolamayı yapılandırır. Blob ve Tablo uç noktalarına sahip bir GPv2 depolama hesabı gerektirir. Önbellek depolama bağlaması ve kimliği oluşturulduktan sonra değiştirilemez ve önbellek grafik çıkarma iş akışı kullanılırken kaldırılamaz. |
|
Knowledge |
Dizinlemeden önce yerel Blob yumuşak silme etkinleştirilmiş Azure Blob bilgi kaynağından grafik çıkarımı yapılandırır. ADLS Gen2, ACL alımı ve duyarlılık etiketi alımı desteklenmemektedir. Farklı ontoloji değişiklikleri, senkronizasyon aktif olmayana kadar beklemelidir. |
|
Knowledge |
Grafik çıkarımı için bir topraklama kaynağı. Yalnızca aynı hizmet arama dizinleri desteklenir. |
|
Knowledge |
Çıkarılan varlıkları topraklamak için kullanılan bir arama indeksini tanımlar. |
|
Knowledge |
Açık kaynak türü, bir temel referans için. Yalnızca searchIndex desteklenir. |
|
Knowledge |
Grafik çıkarımı için satır içi ontoloji. Desteklenen tek kaynak, doğrudan istekte sağlanan kısıtlı JSON-LD belgesidir. |
|
Knowledge |
Ontoloji referansı için açık kaynak türü. Sadece "inline" desteklenir. |
|
Knowledge |
Bilgi kaynakları için tüm genel alım ayarlarını birleştirir. |
|
Knowledge |
Belge içeriğiyle birlikte alınacak izin türleri. |
|
Knowledge |
Bilgi kaynağının türü. |
|
Knowledge |
Bilgi kaynağı alımı için ağ erişim modunu belirler. Varsayılan 'kamu'dur. |
|
Knowledge |
Yönetilen bilgi kaynağı alımı ve oluşturulan sorgu vektörizasyonu için kullanılan OpenAI uyumlu gömme uç noktası. Yerel gömme modelinden geçiş, bilgi kaynağını yeniden oluşturup tekrar indekslemeyi gerektirir. URI, modelName ve boyutlar oluşturulduktan sonra değiştirilemez. |
|
Knowledge |
Bir bilgi kaynağının sonuçlarının yeniden sıralanıp sıralanmadığını kontrol eder. |
|
Mcp |
MCP sunucusu için kimlik doğrulama türü. |
|
Mcp |
Çıktı formatını otomatik olarak algılayın ve buna göre ayrıştırın. |
|
Mcp |
Azure Yapay Zeka Atölyesi bağlantısı kullanılarak kimlik doğrulama. |
|
Mcp |
Foundry bağlantı doğrulaması parametreleri. |
|
Mcp |
Çıkışı, yapılandırılmış JSON parametreleriyle bir JSON belgesi olarak ayrıştırın. |
|
Mcp |
MCP (Model Context Protocol) sunucusu tarafından desteklenen bilgi kaynağı için yapılandırma. |
|
Mcp |
MCP sunucu bilgi kaynağı için parametreler. |
|
Mcp |
Çıkışı ayrıştırmadan tek bir blok olarak ele alın. |
|
Mcp |
JSON çıkış ayrıştırma parametreleri. |
|
Mcp |
MCP sunucu aracı için çıkan bir çözümleme. |
|
Mcp |
Bölünmüş çıktı ayrıştırma parametreleri. |
|
Mcp |
Çıktıyı yapılandırılmış bölünme parametreleriyle sayfalara böl. |
|
Mcp |
Depolanmış HTTP başlıkları kullanılarak kimlik doğrulama. |
|
Mcp |
Depolanmış başlık kimlik doğrulaması parametreleri. |
|
Mcp |
MCP sunucu bilgi kaynağı içindeki tek bir aracı temsil eder. |
|
None |
Konu grafiği çeşitliliği olmadan normal vektör araması kullanır. |
|
Open |
Doğrudan OpenAI uyumlu gömme uç noktası için bağlantı parametreleri. Oluşturma için tam olarak boş olmayan başlıklardan veya managedIdentityAudience gereklidir. Güncellemeler, bağlantı ve gömme profili için kimlik bilgilerini korumak amacıyla başlıkları atlayabilir. |
| Prefer |
HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler. |
|
Remote |
Uzak SharePoint bilgi kaynağı yapılandırması. |
|
Remote |
Uzak SharePoint bilgi kaynağı parametreleri. |
|
Search |
Veri kaynağının kimlik özelliğini temizler. |
|
Search |
Kullanılacak veri kaynağının kimliğini belirtir. |
|
Search |
Arama dizini için alan referansı. |
|
Search |
Bir arama dizinini hedefleyen Bilgi Kaynağı. |
|
Search |
Arama indeks bilgi kaynağı için bir teşvik ipucu. |
|
Search |
Bir alan değerine göre belgeleri güçlendiren bir ipucu. |
|
Search |
Bir alanı ve sorgu planlayıcısının filtre oluştururken kullanabileceği kapsamlı temel değerlerini tanımlayan bir ipucu. |
|
Search |
Bir filtre ipucunun topraklama değerlerinin hedef indeks yüzeylerinden otomatik çözünürlüğünü yapılandırır. |
|
Search |
Çok kelimeli bir ifade temelinde belgeleri güçlendiren bir ipucu. |
|
Search |
Arama dizini bilgi kaynağı için parametreler. |
|
Search |
Arama indeksi bilgi kaynağı için faydalı filtreler ve güçlendirmeler için sorgu planlamasını yönlendiren ipuçları. |
|
Search |
Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir. |
|
Split |
SplitSkill tarafından metin girişi için desteklenen dil kodları. |
|
Text |
Hangi bölme modunun gerçekleştirildiğini gösteren değer. |
|
Vector |
Kullanılacak konu grafiği vektör araması türü. |
|
Vector |
Sorgu sırasında kullanılacak vektörleştirme yöntemi. |
|
Web |
Web sonuçlarını hedefleyen Bilgi Kaynağı. |
|
Web |
Web bilgi kaynağı etki alanı için yapılandırma. |
|
Web |
Web bilgi kaynağı için etki alanı izin verme/engelleme yapılandırması. |
|
Web |
Web bilgi kaynağı için parametreler. |
|
Work |
WorkIQ bilgi kaynağı için yapılandırma. |
|
Work |
WorkIQ bilgi kaynağı için parametreler. |
Accept
Accept başlığı.
| Değer | Description |
|---|---|
| application/json;odata.metadata=minimal |
AIServices
Yapay Zeka Hizmetleri için Parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| apiKey |
string |
AI Hizmetlerine erişim için API anahtarı. |
| uri |
string (uri) |
AI Hizmetleri uç noktasının URI'si. |
AssetStore
Görüntüler gibi çıkarılmış varlıkları depolamak için kullanılan bir varlık deposu için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| connectionString |
string |
Asset store için bağlantı dizesi. |
| containerName |
string |
Çıkarılan varlıkların (örneğin görsellerin) saklandığı varlık deposunda blob konteynerinin adı. |
AzureBlobKnowledgeSource
Azure Blob Depolama bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| azureBlobParameters |
Bilgi kaynağının türü. |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
azure |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
AzureBlobKnowledgeSourceParameters
Azure Blob Depolama bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| connectionString |
string |
Anahtar tabanlı bağlantı dizesi veya yönetilen kimlik kullanılıyorsa ResourceId biçimi. |
|
| containerName |
string |
Blob depolama kapsayıcısının adı. |
|
| createdResources |
object |
Bilgi kaynağı tarafından oluşturulan kaynaklar. |
|
| folderPath |
string |
Kapsayıcı içindeki isteğe bağlı klasör yolu. |
|
| graphExtraction |
Azure Blob bilgi kaynakları için grafik çıkarma yapılandırması. İlk indeksleme çalıştırmasından önce kaynak üzerinde yerel Blob yumuşak silme yapılandırın. ADLS Gen2, ACL alma ve duyarlılık etiketi alma bu iş akışı için desteklenmez. |
||
| ingestionParameters |
Tüm genel alım ayarlarını birleştirir. |
||
| isADLSGen2 |
boolean |
False |
ADLS Gen2 depolama hesabına bağlanıyorsanız true olarak ayarlayın. Varsayılan değer false'tur. |
| topicGraph | VectorQueryTopicGraph: |
Bu Azure Blob bilgi kaynağı için varsayılan konu grafik vektör arama seçenekleri. |
AzureOpenAIModelName
Çağrılacak Azure Open AI model adı.
| Değer | Description |
|---|---|
| text-embedding-ada-002 |
TextEmbeddingAda002 modeli. |
| text-embedding-3-large |
TextEmbedding3Large modeli. |
| text-embedding-3-small |
TextEmbedding3Small modeli. |
| gpt-4o |
Gpt4o modeli. |
| gpt-4o-mini |
Gpt4oMini modeli. |
| gpt-4.1 |
Gpt41 modeli. |
| gpt-4.1-mini |
Gpt41Mini modeli. |
| gpt-4.1-nano |
Gpt41Nano modeli. |
| gpt-5 |
Gpt5 modeli. |
| gpt-5-mini |
Gpt5Mini modeli. |
| gpt-5-nano |
Gpt5Nano modeli. |
| gpt-5.1 |
Gpt51 modeli. |
| gpt-5.2 |
Gpt52 modeli. |
| gpt-5.4 |
Gpt54 modeli. |
| gpt-5.4-mini |
Gpt54Mini modeli. |
| gpt-5.4-nano |
Gpt54Nano modeli. |
| gpt-5.5 |
Gpt55 modeli. |
| gpt-5.6-sol |
Gpt56Sol modeli. |
| gpt-5.6-terra |
Gpt56Terra modeli. |
| gpt-5.6-luna |
Gpt56Luna modeli. |
| gpt-6-astra |
Gpt6Astra modeli. |
| gpt-6-sol |
Gpt6Sol modeli. |
| gpt-6-luna |
Gpt6Luna modeli. |
| gpt-6.1-sol |
Gpt61Sol modeli. |
AzureOpenAIVectorizerParameters
Azure OpenAI kaynağına bağlanmak için parametreleri belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| apiKey |
string |
Belirlenen Azure OpenAI kaynağının API anahtarı. |
| authIdentity | SearchIndexerDataIdentity: |
Giden bağlantılar için kullanılan kullanıcı tarafından atanan yönetilen kimlik. |
| deploymentId |
string |
Belirlenen kaynakta Azure OpenAI modeli dağıtımının kimliği. |
| modelName |
Sağlanan deploymentId yolunda dağıtılan ekleme modelinin adı. |
|
| resourceUri |
string (uri) |
Azure OpenAI kaynağının kaynak URI'si. |
BalancedVectorQueryTopicGraph
Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
balanced |
Kullanılacak konu grafiği vektör araması türü. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 10000 |
Konu grafiği örneklemeden önce alınacak minimum vektör aday sayısı. Varsayılan değer 1.000'dir. |
ContentColumnMapping
Bir SQL sütununu arama indeks alanına eşler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| name |
string |
Hedef indeks alanı adı. |
| searchFieldType |
string |
Azure Yapay Zeka Arama alan tipi (örneğin, Edm.String, Edm.Int32). |
| sourceField |
string |
SQL sütun adı. |
CorsOptions
Dizin için Çıkış Noktaları Arası Kaynak Paylaşımını (CORS) denetleme seçeneklerini tanımlar.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| allowedOrigins |
string[] |
JavaScript koduna dizininize erişim izni verilecek kaynakların listesi. {protocol}://{fully-qualified-domain-name}[:{port#}] biçimindeki ana bilgisayarların bir listesini veya tüm çıkış noktalarına izin vermek için tek bir '*' içerebilir (önerilmez). |
| maxAgeInSeconds |
integer (int64) |
Tarayıcıların CORS ön kontrol yanıtlarını önbelleğe alması gereken süre. Varsayılan olarak 5 dakikadır. |
DiverseVectorQueryTopicGraph
Konu grafiği çeşitli erişim kullanır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| diversityFactor |
number (float) minimum: 0maximum: 1 |
Konu grafiği çeşitlilik geri çağırmasında kullanılan çeşitlilik faktörü. Atlandıysa, konu grafiği profilinde varsayılan yapılandırılan özellik kullanılır. |
| kind |
string:
diverse |
Kullanılacak konu grafiği vektör araması türü. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 10000 |
Konu grafiği örneklemeden önce alınacak minimum vektör aday sayısı. Varsayılan değer 1.000'dir. |
EmbeddingColumnMapping
Bir SQL sütununu gömmek için bir vektör alanına eşler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| name |
string |
Arama indeksinde hedef vektör alanı adı. |
| sourceField |
string |
Gömülü oluşturma için giriş olarak kullanılan SQL sütunu. |
EntraAppAuthentication
Kimlik doğrulama adına federe kimlik doğrulama için kullanılan müşteri sahibi Microsoft Entra uygulaması kaydı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| applicationId |
string (uuid) |
Müşteriye ait Entra uygulaması kaydının uygulama (istemci) kimliği. |
| federatedCredentialId |
string (uuid) |
Uygulama kaydında yapılandırılan federasyona dayalı kimlik kimliği, arama hizmetinin saklanan bir istemci sırrı olmadan uygulama olarak kimlik doğrulamasını sağlar. |
| tenantId |
string (uuid) |
Uygulama kaydının kiracı kimliği. Başvuru kaydı arama hizmetinden farklı bir kiracıda olduğunda gereklidir. Eğer belirtilmemişse, arama hizmetinin kiracısı kullanılır. |
ErrorAdditionalInfo
Kaynak yönetimi hatasına ilişkin ek bilgiler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| info |
Ek bilgiler. |
|
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgisi. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi |
ErrorResponse
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
FabricDataAgentKnowledgeSource
Fabric Data Agent bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| fabricDataAgentParameters |
Fabric Data Agent bilgi kaynağı parametreleri. |
|
| kind |
string:
fabric |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FabricDataAgentKnowledgeSourceParameters
Fabric Data Agent bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| dataAgentId |
string |
Hangi Fabric Veri Ajanına erişileceğini belirtir. |
| workspaceId |
string |
Fabric çalışma alanı kimliği. |
FabricOntologyKnowledgeSource
Fabric Ontology bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| fabricOntologyParameters |
Fabric Ontology bilgi kaynağı parametreleri. |
|
| kind |
string:
fabric |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FabricOntologyKnowledgeSourceParameters
Fabric Ontology bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| ontologyId |
string |
Fabric çalışma alanından kullanılacak ontolojinin kimliği. |
| workspaceId |
string |
Ontolojiyi içeren Fabric çalışma alanı ID'si. |
FileKnowledgeSource
Dosya bilgi kaynağının doğrudan dosya yükleme ve indekslemesini destekleyen yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| corsOptions |
Dosya bilgi kaynağının dosya uç noktaları için Çapraz Kaynak Paylaşımı (CORS) kontrol seçenekleri (yükleme, liste, güncelleme, sil). |
|
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| fileParameters |
Dosya bilgi kaynağı parametreleri. |
|
| kind |
string:
file |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
FileKnowledgeSourceParameters
Dosya bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| createdResources |
object |
Dosya bilgi kaynağı tarafından oluşturulan kaynaklar. |
| ingestionParameters |
Dosya bilgi kaynağı için tüm genel alım ayarlarını, içerik çıkarma modu ve isteğe bağlı embeddingModel dahil olmak üzere, birleştirir. |
FreshnessPolicy
Tazelik farkında geri alma için yapılandırma. Ayarlandığında, yeni belgeler geri alma sırasında sıralama artışı alır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| boostingDuration |
string |
TAZELIK artırma penceresi için ISO 8601 süresi (örneğin 'P90D' 90 gün). Bu süreden daha yeni belgeler, geri alınma sırasında sıralama artışı alır. |
IndexedOneLakeKnowledgeSource
OneLake bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| indexedOneLakeParameters |
Bilgi kaynağı için parametreler. |
|
| kind |
string:
indexed |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedOneLakeKnowledgeSourceParameters
OneLake bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| createdResources |
object |
Bilgi kaynağı tarafından oluşturulan kaynaklar. |
| fabricWorkspaceId |
string |
OneLake çalışma alanı kimliği. |
| ingestionParameters |
Tüm genel alım ayarlarını birleştirir. |
|
| lakehouseId |
string |
Hangi OneLake göl evine erişileceğini belirtir. |
| targetPath |
string |
OneLake içeriğini filtrelemek için isteğe bağlı OneLakehouse klasörü veya kısayolu. |
IndexedSharePointContainerName
Hangi SharePoint kitaplıklarına erişileceğini belirtir.
| Değer | Description |
|---|---|
| defaultSiteLibrary |
Sitenin varsayılan belge kitaplığından içeriği dizine ekleyin. |
| allSiteLibraries |
Sitedeki her belge kitaplığından içeriği dizinleyin. |
| useQuery |
SharePoint içeriğini filtrelemek için bir sorgu kullanın. |
| allSiteLists |
Sitedeki her listeden içeriği indeksleyin. |
| allSitePages |
Sitedeki her sayfadan içeriği indeksleyin. |
| allSiteContent |
Sitedeki tüm desteklenen kütüphanelerden, listelerden ve sayfalardan içerik dizinleyin. |
IndexedSharePointKnowledgeSource
SharePoint bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| indexedSharePointParameters |
Bilgi kaynağı için parametreler. |
|
| kind |
string:
indexed |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedSharePointKnowledgeSourceParameters
SharePoint bilgi kaynağı parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| connectionString |
string |
Biçime sahip SharePoint bağlantı dizesi: SharePointOnlineEndpoint=[SharePoint site url'si]; ApplicationId=[Azure AD Uygulama Kimliği]; ApplicationSecret=[Azure AD Uygulama istemci gizli dizisi]; TenantId=[SharePoint sitesi kiracı kimliği] |
| containerName |
Hangi SharePoint kitaplıklarına erişileceğini belirtir. |
|
| createdResources |
object |
Bilgi kaynağı tarafından oluşturulan kaynaklar. |
| ingestionParameters |
Tüm genel alım ayarlarını birleştirir. |
|
| query |
string |
SharePoint içeriğini filtrelemek için isteğe bağlı sorgu. |
IndexedSqlKnowledgeSource
Indeksli SQL bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| indexedSqlParameters |
SQL bilgi kaynağı için parametreler. |
|
| kind |
string:
indexed |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
IndexedSqlKnowledgeSourceParameters
İndekslenmiş SQL bilgi kaynağı parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| connectionString |
string |
Azure SQL Veritabanı veya SQL Yönetilen Örneği için bağlantı dizesi. |
| contentColumns |
İçerik alanları için isteğe bağlı sütun eşlemeleri. Eğer atlanırsa, tüm sütunlar otomatik olarak keşfedilir. |
|
| createdResources |
object |
Bilgi kaynağı tarafından oluşturulan kaynaklar. |
| embeddingColumns |
Vektör alanlarını gömmek için isteğe bağlı sütun eşlemeleri. Eğer çıkarılırsa, vektör alanı oluşturulmaz. |
|
| highWaterMarkColumnName |
string |
Yüksek su işareti değişimi tespiti için isteğe bağlı sütun adı. Sağlanırsa, HighWaterMarkChangeDetectionPolicy kullanır. |
| ingestionParameters |
Gömü modeli, zamanlama ve kimlik dahil tüm genel alım ayarlarını birleştirir. |
|
| tableOrView |
string |
Indekslenecek tablo veya görünüm adı. Şema nitelikli olabilir (örneğin, 'dbo. MyTable'). |
IndexingSchedule
Dizin oluşturucu yürütme zamanlamasını temsil eder.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| interval |
string (duration) |
Dizin oluşturucu yürütmeleri arasındaki zaman aralığı. |
| startTime |
string (date-time) |
Dizin oluşturucunun çalışmaya başlaması gereken zaman. |
KnowledgeBaseAzureOpenAIModel
Sorgu planlaması yapmak için kullanılan Azure OpenAI kaynağını belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| azureOpenAIParameters |
Azure OpenAI parametreleri. |
|
| kind |
string:
azure |
Sorgu planlaması için kullanılacak yapay zeka modeli. |
KnowledgeBaseMicrosoftRetriever1Model
Sorgu planlama ve alma için kullanılan Microsoft Retriever 1'i belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
microsoft |
Sorgu planlaması için kullanılacak yapay zeka modeli. |
KnowledgeBaseModelKind
Sorgu planlaması için kullanılacak yapay zeka modeli.
| Değer | Description |
|---|---|
| azureOpenAI |
Sorgu planlaması için Azure Open AI modellerini kullanın. |
| openAICompatible |
Bilgi tabanı erişimi veya bilgi kaynağı görüntüsünü sözlü olarak aktarmak için müşteri kontrollü bir OpenAI uyumlu uç nokta kullanın. |
| microsoftRetriever1 |
Sorgu planlama ve geri alma için Microsoft Retriever 1'i kullanın. |
KnowledgeBaseOpenAICompatibleModel
Bilgi tabanı erişimi veya Minimal mod bilgi kaynağı görüntü sözlü kullanımı için müşteri kontrollü OpenAI uyumlu bir model belirtir. Erişim için model profili Sohbet Tamamlamaları veya Yanıtlar seçer. Standard/CU çıkarımı veya Web bilgi kaynaklarına sahip bilgi tabanları için desteklenmez.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
open |
Sorgu planlaması için kullanılacak yapay zeka modeli. |
| openAICompatibleParameters |
OpenAI uyumlu uç nokta için bağlantı ve kimlik doğrulama parametreleri. |
KnowledgeBaseOpenAICompatibleParameters
OpenAI uyumlu bir Sohbet Tamamlama veya Yanıtlar uç noktası için bağlantı parametreleri. Oluşturma için tam olarak boş olmayan başlıklardan veya managedIdentityAudience gereklidir. Güncellemeler, bağlantı ve model profili için kimlik bilgilerini korumak amacıyla başlıkları atlayabilir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| authIdentity | SearchIndexerDataIdentity: |
managedIdentityAudience için bir token elde etmek amacıyla kullanılan kullanıcı tarafından atanan yönetilen kimlik. Arama servisinin sistem tarafından atanmış kimliğini kullanmayı atlayın. Yalnızca managedIdentityAudience ile izinlidir. |
| headers |
object (password) |
Uç nokta kimlik doğrulaması için boş olmayan saklanan HTTP başlıkları. Hem isimler hem de değerler gizlidir ve yanıtlarda asla geri dönmezler. Boş haritalar geçersizdir. managedIdentityAudience ve authIdentity ile birbirini dışlamaktadır. Güncelleme sırasında, atlanan başlıklar yalnızca aynı kaynak ve model bağlamasında korunur; tam uç nokta, model profili ve kimlik doğrulama kimliği değişmediğinde; aksi takdirde, yeni kimlik bilgileri sağlanır. |
| managedIdentityAudience |
string |
Yönetilen kimlik doğrulaması için müşterinin üçüncü taraf Microsoft Entra uygulamasının temel uygulama GUID'si. api:// öneki veya /.default eki eklemeyin. Başlıklarla birbirini dışlıyor. |
| modelName |
Arama'nın yeteneklerini ve sınırlarını belirleyen desteklenen bir sohbet modeli adı. Bilgi kaynağı görüntü sözlü olarak belirtilmesi için, bu istek gövdesinde model seçici olarak gönderilir; URI yolu ise bu isimden bağımsız olarak Sohbet Tamamlamaları veya Yanıtlar seçer. Bilgi tabanı erişimi için GPT-6 model profilleri Yanıtlar kullanırken, mevcut model profilleri Sohbet Tamamlamaları kullanır; uç nokta, Yanıtlar için durumsuz araç devamı dahil olmak üzere seçilen protokolü desteklemelidir. Erişim isteği gövdesi modeli atlar; URI veya ağ geçidi gerçek modeli seçer ve gerekli sağlayıcı model tanımlayıcısını sağlar. Gömme modelleri ve rastgele sağlayıcı protokolleri desteklenmez. |
|
| uri |
string (uri) |
Yol ve sorgu parametreleri dahil olmak üzere tam HTTPS POST URL'si. Yol veya API sürümü eklenmeden değiştirilmeden gönderildi; yönlendirmeler takip edilmez. Bilgi tabanı erişimi için, uç nokta model profilinin Sohbet Tamamlama veya Yanıtlar protokolünü kabul etmelidir. Bilgi kaynağı görüntü sözlü olarak belirtilmesi için URI yolu /chat/completions veya /responses ile sonlanmalıdır; sorgu parametreleri protokolü seçmez. |
KnowledgeSourceAzureOpenAIVectorizer
Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| azureOpenAIParameters |
Azure OpenAI katıştırma vektörleştirmesine özgü parametreleri içerir. |
|
| kind |
string:
azure |
Vektör aramasıyla kullanılmak üzere yapılandırılan vektörleştirme yönteminin adı. |
KnowledgeSourceCache
Önbelleğe alınmış bilgi kaynağı zenginleştirme sonuçları için depolamayı yapılandırır. Blob ve Tablo uç noktalarına sahip bir GPv2 depolama hesabı gerektirir. Önbellek depolama bağlaması ve kimliği oluşturulduktan sonra değiştirilemez ve önbellek grafik çıkarma iş akışı kullanılırken kaldırılamaz.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| enableReprocessing |
boolean |
True |
Zenginleştirme yapılandırması değiştiğinde önbelleğe alınmış zenginleştirme sonuçlarının yeniden işlenip işlenemeyeceği. Grafik çıkarma önbelleği tekrarı için doğru olmalıdır. |
| identity | SearchIndexerDataIdentity: |
Zenginleştirme önbelleğine bağlanmak için kullanılan yönetilen kimlik. Bir ResourceId bağlantı dizesi için atanmışsa, sistem tarafından atanmış yönetilen kimlik kullanılır. Önbellek yapılandırıldıktan sonra kimlik değiştirilemez. |
|
| storageConnectionString |
string (password) |
Önbelleğe alınmış zenginleştirme sonuçlarının saklandığı depolama hesabına bağlantı dizesi. |
KnowledgeSourceGraphExtractionParameters
Dizinlemeden önce yerel Blob yumuşak silme etkinleştirilmiş Azure Blob bilgi kaynağından grafik çıkarımı yapılandırır. ADLS Gen2, ACL alımı ve duyarlılık etiketi alımı desteklenmemektedir. Farklı ontoloji değişiklikleri, senkronizasyon aktif olmayana kadar beklemelidir.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| graphName |
string |
Oluşturulacak grafiğin adı. |
|
| grounding |
Çıkarılan varlıkları çözmek için kullanılan isteğe bağlı topraklama kaynağı. |
||
| ontology |
Üçlüleri çıkarmak için kullanılan ontoloji. Oluşturulurken yok veya null ise, yapılandırılmış bir zenginleştirme önbelleği, üçlü çıkarma olmadan aranabilir parçalar ve önbelleğe alınmış zenginleştirmeler üretmesine olanak tanır. Bir ontoloji eklendikten sonra kaldırılamaz. Farklı ontoloji değişiklikleri, senkronizasyon aktif olmayana kadar beklemelidir. |
||
| pageDegreeOfParallelism |
integer (int32) minimum: 1maximum: 1024 |
128 |
Grafik çıkarımı için paralel işlenen maksimum sayfa sayısı. |
KnowledgeSourceGraphGrounding
Grafik çıkarımı için bir topraklama kaynağı. Yalnızca aynı hizmet arama dizinleri desteklenir.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| index |
Topraklama için kullanılan aynı hizmet arama indeksi. searchIndex kaynakları için gereklidir. |
||
| kind | searchIndex |
Kaynak türden. Atlanmazsa, searchIndex varsayılır. Diğer türler reddedilir. |
KnowledgeSourceGraphGroundingIndex
Çıkarılan varlıkları topraklamak için kullanılan bir arama indeksini tanımlar.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| indexName |
string |
Topraklama arama indeksinin adı. |
| vectorFieldName |
string |
Vektör sorgulama yapılandırıldığında topraklama için kullanılan vektör alanının adı. |
KnowledgeSourceGraphGroundingSourceKind
Açık kaynak türü, bir temel referans için. Yalnızca searchIndex desteklenir.
| Değer | Description |
|---|---|
| searchIndex |
Aynı arama hizmetindeki bir arama dizini. |
KnowledgeSourceGraphOntology
Grafik çıkarımı için satır içi ontoloji. Desteklenen tek kaynak, doğrudan istekte sağlanan kısıtlı JSON-LD belgesidir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
Kaynak türden. Sadece "inline" desteklenir. |
|
| name |
string |
Ontoloji için isteğe bağlı müşteri tarafından sağlanan bir isim, . |
| value |
string |
JSON kodlu bir dize olarak sağlanan, kısıtlı JSON-LD 1.1 ontoloji belgesi (düz sınıflar ve nesne/veri tipi özellikleri). |
KnowledgeSourceGraphOntologySourceKind
Ontoloji referansı için açık kaynak türü. Sadece "inline" desteklenir.
| Değer | Description |
|---|---|
| inline |
İstekte kısıtlı JSON-LD belgesi olarak satır içinde sağlanan ontoloji içeriği. |
KnowledgeSourceIngestionParameters
Bilgi kaynakları için tüm genel alım ayarlarını birleştirir.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| aiServices |
İçerik işleme için isteğe bağlı AI Hizmetleri yapılandırması. |
||
| assetStore |
Çıkarılmış varlıkları (örneğin görüntüler) depolamak için isteğe bağlı varlık deposu yapılandırması. |
||
| cache |
Azure Blob grafik çıkarımı için zenginleştirme önbellek yapılandırması. Blob ve Tablo uç noktaları ile yeniden işleme etkin GPv2 depolama hesabı gerektirir. Yapılandırıldıktan sonra önbellek kaldırılamaz veya depolama bağlaması ya da kimliği değiştirilemez |
||
| chatCompletionModel | KnowledgeBaseModel: |
Görüntü sözlüleştirme veya bağlam çıkarma için isteğe bağlı sohbet tamamlama modeli. |
|
| contentExtractionMode |
enum:
|
minimal |
İsteğe bağlı içerik çıkarma modu. Varsayılan değer 'minimal'dir. |
| disableImageVerbalization |
boolean |
False |
Görüntü sözlülüğünün devre dışı bırakılması gerekip gerekmediğini belirtir. Varsayılan değer false'tur. |
| embeddingModel | KnowledgeSourceVectorizer: |
İçeriği vektörleştirmek için isteğe bağlı vektörleştirici yapılandırması. |
|
| freshnessPolicy |
Yeni belgelere yönelik yönlendirme için isteğe bağlı tazelik politikası. |
||
| identity | SearchIndexerDataIdentity: |
Bu bilgi kaynağı için kullanılacak açık bir kimlik. |
|
| ingestionPermissionOptions |
Belge içeriğiyle birlikte alınacak izin türlerinin isteğe bağlı listesi. Belirtilirse, veri kaynağı için dizin oluşturucu izin seçeneklerini ayarlar. |
||
| ingestionSchedule |
Veri alımı için isteğe bağlı zamanlama. |
||
| networkAccessMode | public |
Tüketim için isteğe bağlı ağ erişim modu. Özel bir uygulama ortamında alım çalıştırmak için 'özel' olarak ayarlanır ve bu ortamda veri kaynakları ve bağımlılıklar özel bir ağ üzerinden ulaşılabilir. Varsayılan 'kamu'dur. Bu, bir yaratma zamanı ayarıdır ve bilgi kaynağı oluşturulduktan sonra değiştirilemez. |
KnowledgeSourceIngestionPermissionOption
Belge içeriğiyle birlikte alınacak izin türleri.
| Değer | Description |
|---|---|
| userIds |
Belge içeriğinin yanı sıra açık kullanıcı tanımlayıcılarını alın. |
| groupIds |
Belge içeriğinin yanı sıra grup tanımlayıcılarını da alın. |
| rbacScope |
Belge içeriğinin yanı sıra RBAC kapsam bilgilerini de alın. |
| oneLakeParentFolders |
OneLake üst klasör yollarını alın ve oluşturulan dizinde OneLake izin filtrelemesini etkinleştirin. Yalnızca indekslenmiş OneLake bilgi kaynakları için desteklenir. |
| oneLakeLakehouseId |
Kaynak öğenin OneLake göl evi kimliğini alın ve oluşturulan indeks üzerinde OneLake izin filtrelemesini etkinleştirin. Yalnızca indekslenmiş OneLake bilgi kaynakları için desteklenir. |
| sensitivityLabels |
Belge içeriğiyle birlikte Microsoft Purview hassasiyet etiketlerini alın. |
KnowledgeSourceKind
Bilgi kaynağının türü.
| Değer | Description |
|---|---|
| searchIndex |
Bir Arama Dizini'nden veri okuyan bir bilgi kaynağı. |
| azureBlob |
Azure Blob Depolama'dan bir Arama Dizini'ne veri okuyan ve alan bir bilgi kaynağı. |
| indexedSharePoint |
Indekslenmiş SharePoint'ten veri okuyan bir bilgi kaynağı. |
| indexedOneLake |
Indekslenmiş OneLake'den veri okuyan bir bilgi kaynağı. |
| indexedSql |
Azure SQL Veritabanı veya SQL Yönetilen Örneği'dan bir Arama İndeksine veri alan ve alan bir bilgi kaynağı. |
| web |
Web'den veri okuyan bir bilgi kaynağı. |
| remoteSharePoint |
Uzak SharePoint'ten veri okuyan bir bilgi kaynağı. |
| workIQ |
İş IQ'sundan veri okuyan bir bilgi kaynağı |
| file |
Doğrudan dosya yükleme ve indekslemeyi destekleyen bir bilgi kaynağı. |
| mcpServer |
MCP (Model Context Protocol) sunucusu tarafından desteklenen bir bilgi kaynağı. |
| fabricDataAgent |
Fabric Veri Ajanı'ndan veri alan bir bilgi kaynağı. |
| fabricOntology |
Microsoft Fabric Ontology ontolojilerinden veri alan bir bilgi kaynağı. |
KnowledgeSourceNetworkAccessMode
Bilgi kaynağı alımı için ağ erişim modunu belirler. Varsayılan 'kamu'dur.
| Değer | Description |
|---|---|
| public |
Alım, standart, halka açık yürütme ortamında çalışır. Bu varsayılan seçenektir. |
| private |
Alım, özel bir yürütme ortamında çalışır, böylece veri kaynaklarına ve bağımlılıklara özel ağ üzerinden (özel uç nokta / paylaşılan özel bağlantı) ulaşabilir. |
KnowledgeSourceOpenAICompatibleVectorizer
Yönetilen bilgi kaynağı alımı ve oluşturulan sorgu vektörizasyonu için kullanılan OpenAI uyumlu gömme uç noktası. Yerel gömme modelinden geçiş, bilgi kaynağını yeniden oluşturup tekrar indekslemeyi gerektirir. URI, modelName ve boyutlar oluşturulduktan sonra değiştirilemez.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
open |
Vektör aramasıyla kullanılmak üzere yapılandırılan vektörleştirme yönteminin adı. |
| openAICompatibleParameters |
Bağlantı, kimlik doğrulama ve gömme profil parametreleri. |
KnowledgeSourceResultsProcessing
Bir bilgi kaynağının sonuçlarının yeniden sıralanıp sıralanmadığını kontrol eder.
| Değer | Description |
|---|---|
| rerank |
Bu bilgi kaynağından elde edilen sonuçlar yeniden sıralama hattından geçer. Bu varsayılan davranıştır. |
| none |
Bu bilgi kaynağından elde edilen sonuçlar, yeniden sıralamayı atlar ve temel sıralarını korur. |
McpServerAuthenticationKind
MCP sunucusu için kimlik doğrulama türü.
| Değer | Description |
|---|---|
| foundryConnection |
Azure Yapay Zeka Atölyesi bağlantısı kullanarak kimlik doğrulaması yapın. |
| storedHeaders |
Depolanmış HTTP başlıkları kullanarak kimlik doğrulama yapın. |
McpServerAutoOutputParsing
Çıktı formatını otomatik olarak algılayın ve buna göre ayrıştırın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
auto |
Uygulanacak çıkış ayrıştırma türü. |
McpServerFoundryConnectionAuthentication
Azure Yapay Zeka Atölyesi bağlantısı kullanılarak kimlik doğrulama.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| foundryConnectionParameters |
Foundry bağlantı doğrulaması parametreleri. |
|
| kind |
string:
foundry |
Kullanılacak kimlik doğrulama türü. |
McpServerFoundryConnectionParameters
Foundry bağlantı doğrulaması parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| connectionId |
string |
Azure Yapay Zeka Atölyesi bağlantı tanımlayıcısı. |
McpServerJsonOutputParsing
Çıkışı, yapılandırılmış JSON parametreleriyle bir JSON belgesi olarak ayrıştırın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| jsonParameters |
JSON çıkış ayrıştırma parametreleri. Tür 'json' olduğunda gereklidir. |
|
| kind |
string:
json |
Uygulanacak çıkış ayrıştırma türü. |
McpServerKnowledgeSource
MCP (Model Context Protocol) sunucusu tarafından desteklenen bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
mcp |
Bilgi kaynağının türü. |
| mcpServerParameters |
MCP sunucu bilgi kaynağı parametreleri. |
|
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
McpServerKnowledgeSourceParameters
MCP sunucu bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| authentication | McpServerAuthentication: |
MCP sunucusu için kimlik doğrulama yapılandırması. |
| serverURL |
string |
MCP sunucu uç noktasının URL'si. |
| tools |
MCP sunucusunda çağrılacak araçlar listesi. |
McpServerNoneOutputParsing
Çıkışı ayrıştırmadan tek bir blok olarak ele alın.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
none |
Uygulanacak çıkış ayrıştırma türü. |
McpServerOutputParsingJsonParameters
JSON çıkış ayrıştırma parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| documentsPath |
string |
Araç çıktısındaki belge dizisine giden JSON yolu. |
| includeContext |
boolean |
JSON çıktısından çevre bağlamı çıkarılmış belgelerle birlikte dahil edip etmeyeceği. |
McpServerOutputParsingKind
MCP sunucu aracı için çıkan bir çözümleme.
| Değer | Description |
|---|---|
| auto |
Çıktı formatını otomatik olarak algılayın ve buna göre ayrıştırın. |
| json |
Çıkışı, yapılandırılmış JSON parametreleriyle bir JSON belgesi olarak ayrıştırın. |
| split |
Çıktıyı yapılandırılmış bölünme parametreleriyle sayfalara böl. |
| none |
Çıkışı ayrıştırmadan tek bir blok olarak ele alın. |
McpServerOutputParsingSplitParameters
Bölünmüş çıktı ayrıştırma parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| defaultLanguageCode |
Hangi dil kodunun kullanılacağını gösteren değer. Varsayılan |
|
| maximumPageLength |
integer (int32) |
Sayfa başına maksimum karakter sayısı. |
| maximumPagesToTake |
integer (int32) |
Çıktıdan alınacak maksimum sayfa sayısı. |
| pageOverlapLength |
integer (int32) |
Sayfalar arasında örtüşen karakter sayısı. |
| textSplitMode |
Metin bölünme modu kullanılıyor. |
McpServerSplitOutputParsing
Çıktıyı yapılandırılmış bölünme parametreleriyle sayfalara böl.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
split |
Uygulanacak çıkış ayrıştırma türü. |
| splitParameters |
Bölünmüş çıktı ayrıştırma parametreleri. |
McpServerStoredHeadersAuthentication
Depolanmış HTTP başlıkları kullanılarak kimlik doğrulama.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
stored |
Kullanılacak kimlik doğrulama türü. |
| storedHeadersParameters |
Depolanmış başlık kimlik doğrulaması parametreleri. |
McpServerStoredHeadersParameters
Depolanmış başlık kimlik doğrulaması parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| headers |
object |
MCP sunucu isteklerine dahil edilecek saklanan HTTP başlıkları. |
McpServerTool
MCP sunucu bilgi kaynağı içindeki tek bir aracı temsil eder.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| maxOutputTokens |
integer (int32) |
Bu aracın çıktısı için isteğe bağlı ayrıştırma sonrası token sınırı. Belirtildiğinde 0'dan büyük olmalıdır. |
| name |
string |
Çağrılacak MCP aracının adı. |
| outputParsing | McpServerOutputParsing: |
Aracın çıktısını ayrıştırmak için isteğe bağlı yapılandırma. |
| resultsProcessing |
Bu aracın ayrıştırılmış sonuçlarının yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
NoneVectorQueryTopicGraph
Konu grafiği çeşitliliği olmadan normal vektör araması kullanır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| kind |
string:
none |
Kullanılacak konu grafiği vektör araması türü. |
OpenAICompatibleVectorizerParameters
Doğrudan OpenAI uyumlu gömme uç noktası için bağlantı parametreleri. Oluşturma için tam olarak boş olmayan başlıklardan veya managedIdentityAudience gereklidir. Güncellemeler, bağlantı ve gömme profili için kimlik bilgilerini korumak amacıyla başlıkları atlayabilir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| authIdentity | SearchIndexerDataIdentity: |
managedIdentityAudience için bir token elde etmek amacıyla kullanılan kullanıcı tarafından atanan yönetilen kimlik. Arama servisinin sistem tarafından atanmış kimliğini kullanmayı atlayın. Yalnızca managedIdentityAudience ile izinlidir. |
| dimensions |
integer (int32) minimum: 1 |
Çıktı boyutları, hedef vektör alanıyla eşleşmesi gerekir. text-embedding-ada-002 ve text-embedding-3-small için varsayılan olarak 1536, text-embedding-3-large için ise 3072 olarak ayarlanır. Ada 1536 gerektirir; text-embedding-3-small 1'den 1536'ya kadar desteklerken, text-embedding-3-large 1'den 3072'ye kadar destekler. Güncellemede atlanan başlıkların korunması, yapılandırılmış boyutların değişmeden kalmasını gerektirir; boyutların atlaması, varsayılanı açıkça belirtmekten farklıdır. |
| headers |
object (password) |
Uç nokta kimlik doğrulaması için boş olmayan saklanan HTTP başlıkları. Hem isimler hem de değerler gizlidir ve yanıtlarda asla geri dönmezler. Boş haritalar geçersizdir. managedIdentityAudience ve authIdentity ile birbirini dışlamaktadır. Güncelleme sırasında, atlanan başlıklar yalnızca aynı kaynak ve vektörizer bağlamasında korunur; tam uç nokta, yapılandırılmış boyutlar dahil gömme profili ve kimlik doğrulama kimliği değişmediğinde; aksi takdirde, yeni kimlik bilgileri sağlanır. |
| managedIdentityAudience |
string |
Yönetilen kimlik doğrulaması için müşterinin üçüncü taraf Microsoft Entra uygulamasının temel uygulama GUID'si. api:// öneki veya /.default eki eklemeyin. Başlıklarla birbirini dışlıyor. |
| modelName |
Gömme profili, yerel Azure OpenAI vektörizatörleriyle aynı model adı enum'u kullanır. Çalışma zamanında yalnızca text-embedding-ada-002, text-embedding-3-small ve text-embedding-3-large desteklenir; paylaşılan enum'daki sohbet adları reddedilir. Search'in sınırlarını ve varsayılan boyutlarını kontrol eder; giden gövde modeli atlar, bu nedenle URI veya ağ geçidi gerçek modeli seçmelidir. Rastgele sağlayıcı protokolleri desteklenmez. |
|
| uri |
string (uri) |
Tam HTTPS POST URL'si, yol ve sorgu parametreleri dahil olmak üzere gömülür. Yol veya API sürümü eklemeden değiştirilmeden gönderildi. Yönlendirmeler takip edilmez. |
Prefer
HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler.
| Değer | Description |
|---|---|
| return=representation |
RemoteSharePointKnowledgeSource
Uzak SharePoint bilgi kaynağı yapılandırması.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
remote |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| remoteSharePointParameters |
Uzak SharePoint bilgi kaynağı parametreleri. |
|
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
RemoteSharePointKnowledgeSourceParameters
Uzak SharePoint bilgi kaynağı parametreleri.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| containerTypeId |
string |
SharePoint Embedded bağlantısı için kapsayıcı kimliği. Bu null olduğunda, SharePoint Online'ı kullanır. |
| filterExpression |
string |
Sorgu çalıştırılmadan önce alma kapsamının belirlenmesi için sorgulanabilir SharePoint özellikleri ve öznitelikleri ile Anahtar Sözcük Sorgu Dili (KQL) ifadesi. |
| resourceMetadata |
string[] |
Yanıttaki her öğe için döndürülecek meta veri alanlarının listesi. Bu listeye yalnızca alınabilir meta veri özellikleri eklenebilir. Varsayılan olarak, hiçbir meta veri döndürülmez. |
SearchIndexerDataNoneIdentity
Veri kaynağının kimlik özelliğini temizler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Kimlik türünü belirten bir URI parçası. |
SearchIndexerDataUserAssignedIdentity
Kullanılacak veri kaynağının kimliğini belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Kimlik türünü belirten bir URI parçası. |
| federatedIdentityClientId |
string |
Çok kiracılı User-Assigned Yönetilen Kimlik Desteği: Kullanıcı tarafından atanan yönetilen kimlik ile federasyon yapacak şekilde yapılandırılmış çoklu uygulamanın istemci kimliği. |
| userAssignedIdentity |
string |
Kullanıcı tarafından atanan yönetilen kimliğin tam Azure kaynak kimliği genellikle arama hizmetine atanması gereken "/subscriptions/12345678-1234-1234-1234-123467890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" biçimindedir. |
SearchIndexFieldReference
Arama dizini için alan referansı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| name |
string |
Alanın adı. |
SearchIndexKnowledgeSource
Bir arama dizinini hedefleyen Bilgi Kaynağı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
search |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
|
| searchIndexParameters |
Bilgi kaynağı için parametreler. |
SearchIndexKnowledgeSourceBoostKind
Arama indeks bilgi kaynağı için bir teşvik ipucu.
| Değer | Description |
|---|---|
| fieldValue |
Belgeleri bir alan değerine göre güçlendirin. |
| multiWordExpression |
Çok kelimeli bir ifade temelinde belgeleri güçlendirin. |
SearchIndexKnowledgeSourceFieldValueBoost
Bir alan değerine göre belgeleri güçlendiren bir ipucu.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| boost |
number (double) |
Belge puanı için bir çarpan. 1,0'a eşit olmayan pozitif bir sayı olmalıdır. |
| boostInstructions |
string |
Boost'un ne zaman ve nasıl uygulanacağını açıklayan doğal dil talimatları. |
| field |
string minLength: 1 |
Arama dizin alanının adı. |
| fieldValues |
string[] |
Alan için temsil değerler. |
| kind |
string:
field |
Böyle bir boost ipucu. |
SearchIndexKnowledgeSourceFilterHint
Bir alanı ve sorgu planlayıcısının filtre oluştururken kullanabileceği kapsamlı temel değerlerini tanımlayan bir ipucu.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| autoConfiguration |
Servisi, alanın yüzeylerinden topraklama değerlerini çözecek şekilde yapılandırır. Varlığı otomatik yapılandırmayı mümkün kılar. Alan filtrelenebilir ve yüz yüze çevrilebilir olmalıdır. Hedef dizinde belge düzeyinde izinler veya Purview hassasiyet etiketleri etkin olduğunda desteklenmez; bu kısıtlama, bilgi kaynağı oluşturma/güncelleme ve bilgi tabanı erişim zamanında doğrulanır.
|
|
| field |
string minLength: 1 |
Filtrelenebilir arama dizin alanının adı. |
| fieldValues |
string[] |
Alan için kapsamlı değerler seti. En fazla 160 değer, her değer için maksimum 128 karakter ve toplamda 2048 karakter. Destekleyen |
| filterInstructions |
string |
Sahada ne zaman ve nasıl filtreleyeceğimizi açıklayan doğal dil talimatları. |
SearchIndexKnowledgeSourceFilterHintAutoConfiguration
Bir filtre ipucunun topraklama değerlerinin hedef indeks yüzeylerinden otomatik çözünürlüğünü yapılandırır.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| cacheTtl |
integer (int32) minimum: 60maximum: 3600 |
Çözülen yüzey değerlerinin önbelleğe alındığı saniye sayısı. İzin verilen aralık, özel hizmetlerde 60 ile 3600 arası, sunucusuz servislerde ise 60 ile 900 arasındadır. Atladığında, özel servislerde varsayılan olarak 3600 saniye, sunucusuz servislerde ise 900 saniye olur. |
| maxFacetValueCount |
integer (int32) minimum: 1maximum: 64 |
Topraklama olarak kullanılacak maksimum yüzey değeri sayısı. Varsayılan olarak 64 olur; izin verilen aralık 1'den 64'e kadardır. Değerler, manuel olarak belirtilen filtre değerleriyle aynı 2048 karakterlik birleşik uzunluk sınırı ve değer başına 128 karakter sınırına tabi olarak azalan facet sayısı sırasıyla seçilir. |
SearchIndexKnowledgeSourceMultiWordExpressionBoost
Çok kelimeli bir ifade temelinde belgeleri güçlendiren bir ipucu.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| boost |
number (double) |
Belge puanı için bir çarpan. 1,0'a eşit olmayan pozitif bir sayı olmalıdır. |
| boostInstructions |
string |
Boost'un ne zaman ve nasıl uygulanacağını açıklayan doğal dil talimatları. |
| fieldValues |
string[] |
Artış için temsili değerler. |
| kind |
string:
multi |
Böyle bir boost ipucu. |
SearchIndexKnowledgeSourceParameters
Arama dizini bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| baseFilter |
string |
Erişim zamanında indekse uygulanan varsayılan bir filtre koşulu (örneğin, 'Durum eq' VA'). Bilgi kaynağı çalışma zamanı parametreleriyle sorgu zamanında geçersiz kılılabilir. |
| queryHints |
Bu arama indeksi bilgi kaynağı için faydalı filtreler ve güçlendirmeler için sorgu planlamasını yönlendiren varsayılan ipuçları. İstek zamanı sorgu ipuçları, bu varsayılan değerleri tam bir nesne olarak değiştirir. |
|
| searchFields |
Arama dizininde hangi alanların aranacağını kısıtlamak için kullanılır. |
|
| searchIndexName |
string |
Arama dizininin adı. |
| semanticConfigurationName |
string |
Hedef arama dizininde varsayılandan farklı bir anlamsal yapılandırma belirtmek için kullanılır. |
| sourceDataFields |
Başvurulan kaynak veriler için ek alanlar istemek için kullanılır. |
|
| topicGraph | VectorQueryTopicGraph: |
Bu arama dizini bilgi kaynağı için varsayılan konu grafiği vektör arama seçenekleri. |
SearchIndexKnowledgeSourceQueryHints
Arama indeksi bilgi kaynağı için faydalı filtreler ve güçlendirmeler için sorgu planlamasını yönlendiren ipuçları.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| boosts | SearchIndexKnowledgeSourceBoost[]: |
Sorgu planlayıcısının belge sıralamasını etkilemek için kullanabileceği koşulları belirleyen ipuçlarını güçlendirin. |
| filters |
Filtre ipuçları, sorgu planlayıcısının filtre oluştururken kullanabileceği alanları ve temsil eden değerleri belirler. |
SearchResourceEncryptionKey
Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.
| Veri Akışı Adı | Tür | Default value | Description |
|---|---|---|---|
| accessCredentials.applicationId |
string |
Bekleyen verilerinizi şifrelerken kullanılacak Azure Key Vault'a gerekli erişim izinleri verilmiş bir AAD Uygulama Kimliği. Uygulama Kimliği, AAD Uygulamanızın Nesne Kimliği ile karıştırılmamalıdır. |
|
| accessCredentials.applicationSecret |
string |
Belirtilen AAD uygulamasının kimlik doğrulama anahtarı. |
|
| identity | SearchIndexerDataIdentity: |
Bu şifreleme anahtarı için kullanılacak açık bir yönetilen kimlik. Belirtilmezse ve erişim kimlik bilgileri özelliği null ise, sistem tarafından atanan yönetilen kimlik kullanılır. Kaynağa güncelleştirildiğinde, açık kimlik belirtilmezse değişmeden kalır. "Hiçbiri" belirtilirse, bu özelliğin değeri temizlenir. |
|
| isServiceLevelKey |
boolean |
False |
Bu anahtarın hizmet seviyesi anahtar olup olmadığını gösteren isteğe bağlı bir değer. Varsayılan değer false'tur. |
| keyVaultKeyName |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın adı. |
|
| keyVaultKeyVersion |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın sürümü. |
|
| keyVaultUri |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak anahtarı içeren, DNS adı olarak da adlandırılan Azure Key Vault URI'sidir. Örnek bir URI |
SplitSkillLanguage
SplitSkill tarafından metin girişi için desteklenen dil kodları.
| Değer | Description |
|---|---|
| am |
Amharca |
| bs |
Boşnakça |
| cs |
Çekçe |
| da |
Danca |
| de |
German |
| en |
English |
| es |
Spanish |
| et |
Estonyaca |
| fi |
Fince |
| fr |
French |
| he |
İbranice |
| hi |
Hintçe |
| hr |
Hırvatça |
| hu |
Macarca |
| id |
Endonezce |
| is |
İzlandaca |
| it |
Italian |
| ja |
Japanese |
| ko |
Korean |
| lv |
Letonca |
| nb |
Norveççe |
| nl |
Flemenkçe |
| pl |
Lehçe dili |
| pt |
Portekiz'de konuşulan Portekizce |
| pt-br |
Portekizce (Brezilya) |
| ru |
Russian |
| sk |
Slovakça |
| sl |
Slovakça |
| sr |
Sırpça |
| sv |
İsveç dili |
| tr |
Türkçe |
| ur |
Urduca |
| zh |
Çince (Basitleştirilmiş) |
TextSplitMode
Hangi bölme modunun gerçekleştirildiğini gösteren değer.
| Değer | Description |
|---|---|
| pages |
Metni tek tek sayfalara bölün. |
| sentences |
Metni tek tek cümlelere bölün. |
VectorSearchTopicGraphKind
Kullanılacak konu grafiği vektör araması türü.
| Değer | Description |
|---|---|
| none |
Konu grafiği çeşitlilik geri kazanımı kapalıysa normal vektör araması kullanın. |
| diverse |
Konu grafiği çeşitlilik geri çağırışını kullanın. |
| balanced |
Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor. |
VectorSearchVectorizerKind
Sorgu sırasında kullanılacak vektörleştirme yöntemi.
| Değer | Description |
|---|---|
| azureOpenAI |
Sorgu zamanında bir Azure OpenAI kaynağı kullanarak eklemeler oluşturun. |
| openAICompatible |
Müşteri kontrollü OpenAI uyumlu gömme uç noktası kullanarak gömme oluşturma yapın. |
| customWebApi |
Sorgu zamanında özel bir web uç noktası kullanarak eklemeler oluşturun. |
| aiServicesVision |
Azure AI Services Vision Vectorize API'sini kullanarak sorgu zamanında bir görüntü veya metin girişi için eklemeler oluşturun. |
| aml |
Sorgu zamanında Azure Yapay Zeka Atölyesi Model Kataloğu aracılığıyla dağıtılan bir Azure Machine Learning uç noktası kullanarak eklemeler oluşturun. |
WebKnowledgeSource
Web sonuçlarını hedefleyen Bilgi Kaynağı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
web |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
|
| webParameters |
Web bilgi kaynağı için parametreler. |
WebKnowledgeSourceDomain
Web bilgi kaynağı etki alanı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| address |
string |
Etki alanının adresi. |
| includeSubpages |
boolean |
Bu etki alanından alt sayfaların dahil edilip edilmeyeceği. |
WebKnowledgeSourceDomains
Web bilgi kaynağı için etki alanı izin verme/engelleme yapılandırması.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| allowedDomains |
Web sonuçları için izin verilen alan adları. |
|
| blockedDomains |
Web sonuçlarından engellenen alan adları. |
WebKnowledgeSourceParameters
Web bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| count |
integer (int32) |
Geri dönecek varsayılan web sonuç sayısı. Bilgi kaynağı çalışma zamanı parametreleriyle sorgu zamanında geçersiz kılılabilir. |
| domains |
Web sonuçları için etki alanı izin verme/engelleme yapılandırması. |
|
| freshness |
string |
Web sonuçları için varsayılan tazelik filtresi. Bilgi kaynağı çalışma zamanı parametreleriyle sorgu zamanında geçersiz kılılabilir. |
| language |
string |
Web sonuçları için varsayılan dil. Bilgi kaynağı çalışma zamanı parametreleriyle sorgu zamanında geçersiz kılılabilir. |
| market |
string |
Web sonuçları için varsayılan pazar. Bilgi kaynağı çalışma zamanı parametreleriyle sorgu zamanında geçersiz kılılabilir. |
WorkIQKnowledgeSource
WorkIQ bilgi kaynağı için yapılandırma.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Bilgi kaynağının ETag'ı. |
| description |
string |
İsteğe bağlı kullanıcı tanımlı açıklama. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
| kind |
string:
workIQ |
Bilgi kaynağının türü. |
| name |
string |
Bilgi kaynağının adı. |
| resultsProcessing |
Bu bilgi kaynağından alınan sonuçların nihai sonuç setine dahil edilmeden önce yeniden sıralanıp sıralanmadığını kontrol eder. Belirtilmediğinde varsayılan olarak 'yeniden sıralama' olur. |
|
| workIQParameters |
WorkIQ bilgi kaynağı parametreleri, kimlik doğrulama için kullanılan müşteriye ait Entra uygulama yapılandırması dahil. |
WorkIQKnowledgeSourceParameters
WorkIQ bilgi kaynağı için parametreler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| entraAppAuthentication |
Müşteri adına Work IQ API'sine kimlik doğrulama için kullanılan Microsoft Entra uygulama kayıt yapılandırması. Müşteri, kiracına ait bir Entra uygulamasını kaydeder, ona WorkIQAgent.Ask yetki vermiş ve Azure Yapay Zeka Arama'in bu uygulama olarak saklanan bir istemci sırrı olmadan kimlik doğrulaması yapabilmesi için federasyona bağlı bir kimlik hattı yapılandırır. |