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-08-01-previewURI Parametreleri
| Name | İç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ığı
| Name | Gerekli | Tür | Description |
|---|---|---|---|
| Accept |
Kabul Et 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. |
|
| 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ı. |
İstek Gövdesi
İstek gövdesi şunlardan biri olabilir:
| Name | 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ı.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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ı.
| Name | 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.
| Name | 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.
| Name | 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ı.
| Name | 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ğı.
| Name | 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ğı.
| Name | 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.
| Name | 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
| Name | 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
| Name | Description |
|---|---|
| https://search.azure.com/.default |
Örnekler
SearchServiceCreateOrUpdateKnowledgeSource
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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-08-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"
},
"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": "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"
}
},
"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."
}
]
},
"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"
}
},
"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."
}
]
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}SearchServiceCreateOrUpdateKnowledgeSourceFabricDataAgent
Örnek isteği
PUT https://previewexampleservice.search.windows.net/knowledgesources('ks-fabric-agent-test')?api-version=2026-08-01-preview
{
"fabricDataAgentParameters": {
"workspaceId": "fakeWorkspaceId",
"dataAgentId": "fakeAgentId"
},
"name": "ks-fabric-agent-test",
"description": "Description of the Fabric Data Agent knowledge source.",
"kind": "fabricDataAgent",
"@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-fabric-agent-test",
"kind": "fabricDataAgent",
"description": "Description of the Fabric Data Agent knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"fabricDataAgentParameters": {
"workspaceId": "fakeWorkspaceId",
"dataAgentId": "fakeAgentId"
}
}{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-fabric-agent-test",
"kind": "fabricDataAgent",
"description": "Description of the Fabric Data Agent knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"fabricDataAgentParameters": {
"workspaceId": "fakeWorkspaceId",
"dataAgentId": "fakeAgentId"
}
}SearchServiceCreateOrUpdateKnowledgeSourceFabricOntology
Örnek isteği
PUT https://previewexampleservice.search.windows.net/knowledgesources('ks-fabricontology-test')?api-version=2026-08-01-preview
{
"fabricOntologyParameters": {
"workspaceId": "12345678-1234-1234-1234-123456789abc",
"ontologyId": "ontology-456"
},
"name": "ks-fabricontology-test",
"description": "Description of the Fabric Ontology knowledge source.",
"kind": "fabricOntology",
"@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-fabricontology-test",
"kind": "fabricOntology",
"description": "Description of the Fabric Ontology knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"fabricOntologyParameters": {
"workspaceId": "12345678-1234-1234-1234-123456789abc",
"ontologyId": "ontology-456"
}
}{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-fabricontology-test",
"kind": "fabricOntology",
"description": "Description of the Fabric Ontology knowledge source.",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"fabricOntologyParameters": {
"workspaceId": "12345678-1234-1234-1234-123456789abc",
"ontologyId": "ontology-456"
}
}SearchServiceCreateOrUpdateKnowledgeSourceFile
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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"
}
},
"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
}
]
}
},
"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"
}
},
"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."
}
]
},
"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"
}
},
"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."
}
]
},
"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-08-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"
}
},
"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": "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"
}
},
"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": "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"
}
},
"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."
}
]
}
}
}SearchServiceCreateOrUpdateKnowledgeSourceIndexedSharePoint
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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"
}
},
"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": "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"
}
},
"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": "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"
}
},
"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."
}
]
}
}
}SearchServiceCreateOrUpdateKnowledgeSourceIndexedSql
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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"
},
"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": "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"
}
},
"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": "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"
}
},
"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."
}
]
}
}
}SearchServiceCreateOrUpdateKnowledgeSourceMcpServer
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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
}
}
}
]
}
}SearchServiceCreateOrUpdateKnowledgeSourceWeb
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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
}
]
}
}
}SearchServiceCreateOrUpdateKnowledgeSourceWorkIQ
Örnek isteği
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-08-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
| Name | Description |
|---|---|
| Accept |
Kabul Et 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. |
|
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. |
|
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 planlaması için kullanılacak yapay zeka modeli. |
|
Knowledge |
Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir. |
|
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 |
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. |
| 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 temsil eden değerleri tanımlayan bir ipucu. |
|
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 |
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
Kabul Et başlığı.
| Değer | Description |
|---|---|
| application/json;odata.metadata=minimal |
AIServices
Yapay Zeka Hizmetleri için Parametreler.
| Name | 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.
| Name | 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ı.
| Name | 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.
| Name | 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. |
|
| 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. |
| queryHints |
Bu indeksli 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. |
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. |
AzureOpenAIVectorizerParameters
Azure OpenAI kaynağına bağlanmak için parametreleri belirtir.
| Name | 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. |
ContentColumnMapping
Bir SQL sütununu arama indeks alanına eşler.
| Name | 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.
| Name | 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. |
EmbeddingColumnMapping
Bir SQL sütununu gömmek için bir vektör alanına eşler.
| Name | 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.
| Name | 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.
| Name | Tür | Description |
|---|---|---|
| info |
Ek bilgiler. |
|
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Name | 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.).
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
FabricDataAgentKnowledgeSource
Fabric Data Agent bilgi kaynağı için yapılandırma.
| Name | 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.
| Name | Tür | Description |
|---|---|---|
| dataAgentId |
string |
Hangi Fabric Veri Ajanına erişileceğini belirtir. |
| workspaceId |
string |
Fabric workspace ID. |
FabricOntologyKnowledgeSource
Fabric Ontology bilgi kaynağı için yapılandırma.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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. |
|
| queryHints |
Bu indeksli 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. |
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.
| Name | 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.
| Name | 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.
| Name | 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. |
| queryHints |
Bu indeksli 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. |
|
| 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. |
IndexedSharePointKnowledgeSource
SharePoint bilgi kaynağı yapılandırması.
| Name | 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.
| Name | 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. |
| queryHints |
Bu indeksli 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. |
IndexedSqlKnowledgeSource
Indeksli SQL bilgi kaynağı için yapılandırma.
| Name | 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.
| Name | 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. |
|
| queryHints |
Bu indeksli 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. |
|
| 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.
| Name | 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.
| Name | Tür | Description |
|---|---|---|
| azureOpenAIParameters |
Azure OpenAI parametreleri. |
|
| kind |
string:
azure |
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. |
KnowledgeSourceAzureOpenAIVectorizer
Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir.
| Name | 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ı. |
KnowledgeSourceIngestionParameters
Bilgi kaynakları için tüm genel alım ayarlarını birleştirir.
| Name | 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ı. |
||
| 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. |
| 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. |
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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | Tür | Description |
|---|---|---|
| kind |
string:
none |
Uygulanacak çıkış ayrıştırma türü. |
McpServerOutputParsingJsonParameters
JSON çıkış ayrıştırma parametreleri.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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. |
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ı.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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ı.
| Name | Tür | Description |
|---|---|---|
| name |
string |
Alanın adı. |
SearchIndexKnowledgeSource
Bir arama dizinini hedefleyen Bilgi Kaynağı.
| Name | 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.
| Name | 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 temsil eden değerleri tanımlayan bir ipucu.
| Name | Tür | Description |
|---|---|---|
| field |
string minLength: 1 |
Filtrelenebilir arama dizin alanının adı. |
| fieldValues |
string[] |
Alan için temsil değerler. |
| filterInstructions |
string |
Sahada ne zaman ve nasıl filtreleyeceğimizi açıklayan doğal dil talimatları. |
SearchIndexKnowledgeSourceMultiWordExpressionBoost
Çok kelimeli bir ifade temelinde belgeleri güçlendiren bir ipucu.
| Name | 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.
| Name | 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. |
SearchIndexKnowledgeSourceQueryHints
Arama indeksi bilgi kaynağı için faydalı filtreler ve güçlendirmeler için sorgu planlamasını yönlendiren ipuçları.
| Name | 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.
| Name | 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 |
Korece |
| lv |
Letonca |
| nb |
Norveççe |
| nl |
Flemenkçe |
| pl |
Lehçe dili |
| pt |
Portekiz'de konuşulan Portekizce |
| pt-br |
Portekizce (Brezilya) |
| ru |
Rusça |
| 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. |
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. |
| 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ğı.
| Name | 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.
| Name | 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ı.
| Name | 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.
| Name | 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.
| Name | 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.
| Name | 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. |