Knowledge Sources - Create

Služba:: Search Service

Verze rozhraní API:: 2026-05-01-preview

Vytvoří nový zdroj znalostí.

POST {endpoint}/knowledgesources?api-version=2026-05-01-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Adresa URL koncového bodu vyhledávací služby.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Accept		Accept	Hlavička Accept.
x-ms-client-request-id		string (uuid)	Neprůzrný globálně jedinečný identifikátor řetězce vygenerovaný klientem pro požadavek.

Text požadavku

Text žádosti může tvořit:

Name	Description
AzureBlobKnowledgeSource	Konfigurace pro zdroj znalostí Azure Blob Storage.
FabricDataAgentKnowledgeSource	Konfigurace pro zdroj znalostí Fabric Data Agent.
FabricOntologyKnowledgeSource	Konfigurace pro zdroj znalostí Fabric Ontology.
FileKnowledgeSource	Konfigurace pro zdroj znalostí souborů, který podporuje přímé nahrávání a indexování souborů.
IndexedOneLakeKnowledgeSource	Konfigurace pro zdroj znalostí OneLake.
IndexedSharePointKnowledgeSource	Konfigurace pro zdroj znalostí SharePoint.
IndexedSqlKnowledgeSource	Konfigurace pro indexovaný zdroj znalostí SQL.
McpServerKnowledgeSource	Konfigurace pro zdroj znalostí podporovaný serverem MCP (Model Context Protocol).
RemoteSharePointKnowledgeSource	Konfigurace pro vzdálený zdroj znalostí SharePoint.
SearchIndexKnowledgeSource	Zdroj znalostí: Cílení na vyhledávací index.
WebKnowledgeSource	Zdroj znalostí: Cílení na webové výsledky.
WorkIQKnowledgeSource	Konfigurace pro zdroj znalostí WorkIQ.

AzureBlobKnowledgeSource

Konfigurace pro zdroj znalostí Azure Blob Storage.

Name	Vyžadováno	Typ	Description
azureBlobParameters	True	AzureBlobKnowledgeSourceParameters	Typ zdroje znalostí.
kind	True	string: azureBlob	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

FabricDataAgentKnowledgeSource

Konfigurace pro zdroj znalostí Fabric Data Agent.

Name	Vyžadováno	Typ	Description
fabricDataAgentParameters	True	FabricDataAgentKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Data Agent.
kind	True	string: fabricDataAgent	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

FabricOntologyKnowledgeSource

Konfigurace pro zdroj znalostí Fabric Ontology.

Name	Vyžadováno	Typ	Description
fabricOntologyParameters	True	FabricOntologyKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Ontology.
kind	True	string: fabricOntology	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

FileKnowledgeSource

Konfigurace pro zdroj znalostí souborů, který podporuje přímé nahrávání a indexování souborů.

Name	Vyžadováno	Typ	Description
fileParameters	True	FileKnowledgeSourceParameters	Parametry pro zdroj znalostí souboru.
kind	True	string: file	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

IndexedOneLakeKnowledgeSource

Konfigurace pro zdroj znalostí OneLake.

Name	Vyžadováno	Typ	Description
indexedOneLakeParameters	True	IndexedOneLakeKnowledgeSourceParameters	Parametry pro zdroj znalostí.
kind	True	string: indexedOneLake	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

IndexedSharePointKnowledgeSource

Konfigurace pro zdroj znalostí SharePoint.

Name	Vyžadováno	Typ	Description
indexedSharePointParameters	True	IndexedSharePointKnowledgeSourceParameters	Parametry pro zdroj znalostí.
kind	True	string: indexedSharePoint	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

IndexedSqlKnowledgeSource

Konfigurace pro indexovaný zdroj znalostí SQL.

Name	Vyžadováno	Typ	Description
indexedSqlParameters	True	IndexedSqlKnowledgeSourceParameters	Parametry pro zdroj znalostí SQL.
kind	True	string: indexedSql	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

McpServerKnowledgeSource

Konfigurace pro zdroj znalostí podporovaný serverem MCP (Model Context Protocol).

Name	Vyžadováno	Typ	Description
kind	True	string: mcpServer	Typ zdroje znalostí.
mcpServerParameters	True	McpServerKnowledgeSourceParameters	Parametry pro zdroj znalostí MCP serveru.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

RemoteSharePointKnowledgeSource

Konfigurace pro vzdálený zdroj znalostí SharePoint.

Name	Vyžadováno	Typ	Description
kind	True	string: remoteSharePoint	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
remoteSharePointParameters		RemoteSharePointKnowledgeSourceParameters	Parametry pro vzdálený zdroj znalostí SharePoint.

SearchIndexKnowledgeSource

Zdroj znalostí: Cílení na vyhledávací index.

Name	Vyžadováno	Typ	Description
kind	True	string: searchIndex	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
searchIndexParameters	True	SearchIndexKnowledgeSourceParameters	Parametry pro zdroj znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

WebKnowledgeSource

Zdroj znalostí: Cílení na webové výsledky.

Name	Vyžadováno	Typ	Description
kind	True	string: web	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
webParameters		WebKnowledgeSourceParameters	Parametry webového zdroje znalostí.

WorkIQKnowledgeSource

Konfigurace pro zdroj znalostí WorkIQ.

Name	Vyžadováno	Typ	Description
kind	True	string: workIQ	Typ zdroje znalostí.
name	True	string	Název zdroje znalostí.
@odata.etag		string	ETag zdroje znalostí.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.

Odpovědi

Name	Typ	Description
201 Created	KnowledgeSource: AzureBlobKnowledgeSource FabricDataAgentKnowledgeSource FabricOntologyKnowledgeSource FileKnowledgeSource IndexedOneLakeKnowledgeSource IndexedSharePointKnowledgeSource IndexedSqlKnowledgeSource McpServerKnowledgeSource RemoteSharePointKnowledgeSource SearchIndexKnowledgeSource WebKnowledgeSource WorkIQKnowledgeSource	Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

api-key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

Name	Description
https://search.azure.com/.default

Příklady

SearchServiceCreateKnowledgeSource

SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSourceFabricDataAgent

SearchServiceCreateKnowledgeSourceFabricOntology

SearchServiceCreateKnowledgeSourceIndexedOneLake

SearchServiceCreateKnowledgeSourceIndexedSharePoint

SearchServiceCreateKnowledgeSourceMcpServer

SearchServiceCreateKnowledgeSourceWeb

SearchServiceCreateKnowledgeSourceWorkIQ

SearchServiceCreateKnowledgeSource

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "semanticConfigurationName": "testconfig"
  },
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "searchIndex",
  "@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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "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",
    "semanticConfigurationName": "testconfig",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ]
  }
}

SearchServiceCreateKnowledgeSourceAzureBlob

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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",
    "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": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateKnowledgeSourceFabricDataAgent

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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"
  }
}

SearchServiceCreateKnowledgeSourceFabricOntology

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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"
  }
}

SearchServiceCreateKnowledgeSourceIndexedOneLake

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedSharePoint

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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",
    "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",
        "rbacScope"
      ],
      "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"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceMcpServer

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "mcpServerParameters": {
    "serverURL": "https://mcp.contoso.com/sse",
    "authentication": {
      "foundryConnectionParameters": {
        "connectionId": "conn-123"
      },
      "kind": "foundryConnection"
    },
    "tools": [
      {
        "name": "search-code",
        "outputParsing": {
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          },
          "kind": "json"
        },
        "inclusionMode": "reranked",
        "maxOutputTokens": 4096
      }
    ]
  },
  "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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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",
        "inclusionMode": "reranked",
        "maxOutputTokens": 4096,
        "outputParsing": {
          "kind": "json",
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          }
        }
      }
    ]
  }
}

SearchServiceCreateKnowledgeSourceWeb

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@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",
    "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
        }
      ]
    }
  }
}

SearchServiceCreateKnowledgeSourceWorkIQ

Ukázkový požadavek

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2026-05-01-preview


{
  "name": "ks-workiq-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>"
    }
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-workiq-test",
  "kind": "workIQ",
  "description": "Description of the WorkIQ knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Definice

Name	Description
Accept	Hlavička Accept.
AIServices	Parametry pro služby AI.
AssetStore	Konfigurace pro úložiště assetů používané k ukládání extrahovaných assetů, jako jsou obrázky.
AzureBlobKnowledgeSource	Konfigurace pro zdroj znalostí Azure Blob Storage.
AzureBlobKnowledgeSourceParameters	Parametry pro zdroj znalostí služby Azure Blob Storage.
AzureOpenAIModelName	Název modelu Azure Open AI, který se bude volat.
AzureOpenAIVectorizerParameters	Určuje parametry pro připojení k prostředku Azure OpenAI.
ContentColumnMapping	Mapuje sloupec SQL na pole indexu vyhledávání.
EmbeddingColumnMapping	Mapuje sloupec SQL na vektorové pole pro vložení.
ErrorAdditionalInfo	Další informace o chybě při správě prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
FabricDataAgentKnowledgeSource	Konfigurace pro zdroj znalostí Fabric Data Agent.
FabricDataAgentKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Data Agent.
FabricOntologyKnowledgeSource	Konfigurace pro zdroj znalostí Fabric Ontology.
FabricOntologyKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Ontology.
FileKnowledgeSource	Konfigurace pro zdroj znalostí souborů, který podporuje přímé nahrávání a indexování souborů.
FileKnowledgeSourceParameters	Parametry pro zdroj znalostí souboru.
FreshnessPolicy	Konfigurace pro vyhledávání s ohledem na čerstvost. Při nastavení získávají novější dokumenty při vyhledávání vyšší hodnocení.
IndexedOneLakeKnowledgeSource	Konfigurace pro zdroj znalostí OneLake.
IndexedOneLakeKnowledgeSourceParameters	Parametry pro zdroj znalostí OneLake.
IndexedSharePointContainerName	Určuje, ke kterým knihovnám SharePoint se má přistupovat.
IndexedSharePointKnowledgeSource	Konfigurace pro zdroj znalostí SharePoint.
IndexedSharePointKnowledgeSourceParameters	Parametry pro zdroj znalostí SharePoint.
IndexedSqlKnowledgeSource	Konfigurace pro indexovaný zdroj znalostí SQL.
IndexedSqlKnowledgeSourceParameters	Parametry pro indexovaný zdroj znalostí SQL.
IndexingSchedule	Představuje plán provádění indexeru.
KnowledgeBaseAzureOpenAIModel	Určuje prostředek Azure OpenAI používaný k plánování dotazů.
KnowledgeBaseModelKind	Model umělé inteligence, který se má použít pro plánování dotazů.
KnowledgeSourceAzureOpenAIVectorizer	Určuje prostředek Azure OpenAI použitý k vektorizaci řetězce dotazu.
KnowledgeSourceIngestionParameters	Konsoliduje všechna obecná nastavení příjmu dat pro zdroje znalostí.
KnowledgeSourceIngestionPermissionOption	Typy oprávnění pro vstup do obsahu dokumentu.
KnowledgeSourceKind	Druh zdroje znalostí.
McpServerAuthenticationKind	Typ autentizace pro MCP server.
McpServerAutoOutputParsing	Automaticky detekujte výstupní formát a podle toho ho analyzujte.
McpServerFoundryConnectionAuthentication	Autentizace pomocí připojení Azure AI Foundry.
McpServerFoundryConnectionParameters	Parametry pro autentizaci připojení Foundry.
McpServerJsonOutputParsing	Výstup parsujte jako JSON dokument pomocí konfigurovaných parametrů JSON.
McpServerKnowledgeSource	Konfigurace pro zdroj znalostí podporovaný serverem MCP (Model Context Protocol).
McpServerKnowledgeSourceParameters	Parametry pro zdroj znalostí MCP serveru.
McpServerNoneOutputParsing	Považujte výstup za jeden blok bez jakéhokoliv parsování.
McpServerOutputParsingJsonParameters	Parametry pro výstupní parsování JSON.
McpServerOutputParsingKind	Typ výstupního parsování pro MCP serverový nástroj.
McpServerOutputParsingSplitParameters	Parametry pro rozdělené výstupní parsování.
McpServerSplitOutputParsing	Rozdělte výstup na stránky pomocí nastavených parametrů rozdělení.
McpServerStoredHeadersAuthentication	Autentizace pomocí uložených HTTP hlaviček.
McpServerStoredHeadersParameters	Parametry pro autentizaci uložených hlaviček.
McpServerTool	Představuje jeden nástroj v rámci zdroje znalostí MCP serveru.
McpServerToolInclusionMode	Ovládá, jak jsou výsledky parsovaných MCP nástrojů integrovány do konečné sady výsledků.
RemoteSharePointKnowledgeSource	Konfigurace pro vzdálený zdroj znalostí SharePoint.
RemoteSharePointKnowledgeSourceParameters	Parametry pro vzdálený zdroj znalostí SharePoint.
SearchIndexerDataNoneIdentity	Vymaže vlastnost identity zdroje dat.
SearchIndexerDataUserAssignedIdentity	Určuje identitu zdroje dat, která se má použít.
SearchIndexFieldReference	Referenční pole pro vyhledávací index.
SearchIndexKnowledgeSource	Zdroj znalostí: Cílení na vyhledávací index.
SearchIndexKnowledgeSourceParameters	Parametry pro vyhledávací index zdroje znalostí.
SearchResourceEncryptionKey	Šifrovací klíč spravovaný zákazníkem ve službě Azure Key Vault. Klíče, které vytvoříte a spravujete, lze použít k šifrování nebo dešifrování neaktivních uložených dat, jako jsou indexy a mapy synonym.
SplitSkillLanguage	Jazykové kódy podporované pro vstupní text službou SplitSkill.
TextSplitMode	Hodnota označující, který režim rozdělení se má provést.
VectorSearchVectorizerKind	Metoda vektorizace, která se má použít během doby dotazu.
WebKnowledgeSource	Zdroj znalostí: Cílení na webové výsledky.
WebKnowledgeSourceDomain	Konfigurace pro webovou zdrojovou doménu znalostí.
WebKnowledgeSourceDomains	Konfigurace povolení/blokování domény pro webový zdroj znalostí.
WebKnowledgeSourceParameters	Parametry pro webový zdroj znalostí.
WorkIQKnowledgeSource	Konfigurace pro zdroj znalostí WorkIQ.

Accept

Výčet

Hlavička Accept.

Hodnota	Description
application/json;odata.metadata=minimal

AIServices

Objekt

Parametry pro služby AI.

Name	Typ	Description
apiKey	string	Klíč API pro přístup ke službám AI.
uri	string (uri)	Identifikátor URI koncového bodu služby AI.

AssetStore

Objekt

Konfigurace pro úložiště assetů používané k ukládání extrahovaných assetů, jako jsou obrázky.

Name	Typ	Description
connectionString	string	připojovací řetězec pro asset store.
containerName	string	Název blob kontejneru v úložišti assetů, kde jsou uloženy extrahované assety (například obrázky).

AzureBlobKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí Azure Blob Storage.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
azureBlobParameters	AzureBlobKnowledgeSourceParameters	Typ zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: azureBlob	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

AzureBlobKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí služby Azure Blob Storage.

Name	Typ	Default value	Description
connectionString	string		Připojovací řetězec založený na klíči nebo formát ResourceId, pokud používáte spravovanou identitu.
containerName	string		Název kontejneru úložiště objektů blob.
createdResources	object		Zdroje vytvořené zdrojem znalostí.
folderPath	string		Volitelná cesta ke složce v rámci kontejneru.
ingestionParameters	KnowledgeSourceIngestionParameters		Konsoliduje všechna obecná nastavení příjmu dat.
isADLSGen2	boolean	False	Pokud se připojujete k účtu úložiště ADLS Gen2, nastavte na hodnotu true. Výchozí hodnota je nastavená na false.

AzureOpenAIModelName

Výčet

Název modelu Azure Open AI, který se bude volat.

Hodnota	Description
text-embedding-ada-002	Model TextEmbeddingAda002.
text-embedding-3-large	TextEmbedding3Large model.
text-embedding-3-small	Model TextEmbedding3Small.
gpt-4o	Model Gpt4o.
gpt-4o-mini	Model Gpt4oMini.
gpt-4.1	Model Gpt41.
gpt-4.1-mini	Model Gpt41Mini.
gpt-4.1-nano	Model Gpt41Nano.
gpt-5	Model GPT5.
gpt-5-mini	Model Gpt5Mini.
gpt-5-nano	Model Gpt5Nano.
gpt-5.1	Model GPT51.
gpt-5.2	Model Gpt52.
gpt-5.4	Model GPT54.
gpt-5.4-mini	Model Gpt54Mini.
gpt-5.4-nano	Model Gpt54Nano.
gpt-5.5	Model Gpt55.

AzureOpenAIVectorizerParameters

Objekt

Určuje parametry pro připojení k prostředku Azure OpenAI.

Name	Typ	Description
apiKey	string	Klíč rozhraní API určeného prostředku Azure OpenAI
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Spravovaná identita přiřazená uživatelem používaná pro odchozí připojení.
deploymentId	string	ID nasazení modelu Azure OpenAI v určeném prostředku
modelName	AzureOpenAIModelName	Název modelu vložení, který je nasazený na zadané cestě deploymentId.
resourceUri	string (uri)	Identifikátor URI prostředku Azure OpenAI.

ContentColumnMapping

Objekt

Mapuje sloupec SQL na pole indexu vyhledávání.

Name	Typ	Description
name	string	Název cílového indexového pole.
searchFieldType	string	Azure AI Vyhledávač pole typ (např. Edm.String, Edm.Int32).
sourceField	string	SQL sloupec.

EmbeddingColumnMapping

Objekt

Mapuje sloupec SQL na vektorové pole pro vložení.

Name	Typ	Description
name	string	Název pole cílového vektoru v indexu vyhledávání.
sourceField	string	SQL sloupec používaný jako vstup pro generování embeddingu.

ErrorAdditionalInfo

Objekt

Další informace o chybě při správě prostředků

Name	Typ	Description
info		Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

FabricDataAgentKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí Fabric Data Agent.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
fabricDataAgentParameters	FabricDataAgentKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Data Agent.
kind	string: fabricDataAgent	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

FabricDataAgentKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí Fabric Data Agent.

Name	Typ	Description
dataAgentId	string	Specifikuje, ke kterému Fabric Data Agentovi má přistupovat.
workspaceId	string	Fabric workspace ID.

FabricOntologyKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí Fabric Ontology.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
fabricOntologyParameters	FabricOntologyKnowledgeSourceParameters	Parametry pro zdroj znalostí Fabric Ontology.
kind	string: fabricOntology	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

FabricOntologyKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí Fabric Ontology.

Name	Typ	Description
ontologyId	string	ID ontologie pro použití z pracovního prostoru Fabric.
workspaceId	string	Pracovní ID Fabric obsahující ontologii.

FileKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí souborů, který podporuje přímé nahrávání a indexování souborů.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
fileParameters	FileKnowledgeSourceParameters	Parametry pro zdroj znalostí souboru.
kind	string: file	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

FileKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí souboru.

Name	Typ	Description
createdResources	object	Zdroje vytvořené zdrojem znalostí souboru.
ingestionParameters	KnowledgeSourceIngestionParameters	Konsoliduje všechna obecná nastavení ingestace pro zdroj znalostí souboru, včetně režimu extrakce obsahu a volitelného embeddingModelu.

FreshnessPolicy

Objekt

Konfigurace pro vyhledávání s ohledem na čerstvost. Při nastavení získávají novější dokumenty při vyhledávání vyšší hodnocení.

Name	Typ	Description
boostingDuration	string	Doba trvání podle ISO 8601 pro okno zvýšení čerstvosti (např. 'P90D' po dobu 90 dnů). Dokumenty novější než tato doba získávají při vyhledávání vyšší hodnocení.

IndexedOneLakeKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí OneLake.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
indexedOneLakeParameters	IndexedOneLakeKnowledgeSourceParameters	Parametry pro zdroj znalostí.
kind	string: indexedOneLake	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

IndexedOneLakeKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí OneLake.

Name	Typ	Description
createdResources	object	Zdroje vytvořené zdrojem znalostí.
fabricWorkspaceId	string	ID pracovního prostoru OneLake.
ingestionParameters	KnowledgeSourceIngestionParameters	Konsoliduje všechna obecná nastavení příjmu dat.
lakehouseId	string	Určuje, ke kterému jezernímu domu OneLake se má přistupovat.
targetPath	string	Volitelná složka nebo zástupce OneLakehouse pro filtrování obsahu OneLake.

IndexedSharePointContainerName

Výčet

Určuje, ke kterým knihovnám SharePoint se má přistupovat.

Hodnota	Description
defaultSiteLibrary	Indexujte obsah z výchozí knihovny dokumentů webu.
allSiteLibraries	Indexujte obsah ze všech knihoven dokumentů na webu.
useQuery	Použijte dotaz k filtrování obsahu SharePointu.

IndexedSharePointKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí SharePoint.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
indexedSharePointParameters	IndexedSharePointKnowledgeSourceParameters	Parametry pro zdroj znalostí.
kind	string: indexedSharePoint	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

IndexedSharePointKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí SharePoint.

Name	Typ	Description
connectionString	string	Připojovací řetězec služby SharePoint s formátem: SharePointOnlineEndpoint=[adresa URL webu SharePoint]; ApplicationId=[ID aplikace Azure AD]; ApplicationSecret=[Tajný klíč klienta aplikace Azure AD]; TenantId=[ID tenanta sharepointového webu]
containerName	IndexedSharePointContainerName	Určuje, ke kterým knihovnám SharePoint se má přistupovat.
createdResources	object	Zdroje vytvořené zdrojem znalostí.
ingestionParameters	KnowledgeSourceIngestionParameters	Konsoliduje všechna obecná nastavení příjmu dat.
query	string	Volitelný dotaz pro filtrování obsahu SharePoint.

IndexedSqlKnowledgeSource

Objekt

Konfigurace pro indexovaný zdroj znalostí SQL.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
indexedSqlParameters	IndexedSqlKnowledgeSourceParameters	Parametry pro zdroj znalostí SQL.
kind	string: indexedSql	Typ zdroje znalostí.
name	string	Název zdroje znalostí.

IndexedSqlKnowledgeSourceParameters

Objekt

Parametry pro indexovaný zdroj znalostí SQL.

Name	Typ	Description
connectionString	string	připojovací řetězec pro Azure SQL Database nebo SQL Managed Instance.
contentColumns	ContentColumnMapping[]	Volitelná mapování sloupců pro obsahová pole. Pokud je vynechán, všechny sloupce jsou automaticky objevovány.
createdResources	object	Zdroje vytvořené zdrojem znalostí.
embeddingColumns	EmbeddingColumnMapping[]	Volitelné mapování sloupců pro vkládání vektorových polí. Pokud je vynechán, žádná vektorová pole se nevytvářejí.
highWaterMarkColumnName	string	Volitelný název sloupce pro detekci změny vysoké vodní značky. Pokud je k dispozici, používá HighWaterMarkChangeDetectionPolicy.
ingestionParameters	KnowledgeSourceIngestionParameters	Konsoliduje všechna obecná nastavení vstupu včetně modelu vkládání, harmonogramu a identity.
tableOrView	string	Název tabulky nebo zobrazení pro index. Může být schema-kvalifikovaný (např. 'dbo. MyTable').

IndexingSchedule

Objekt

Představuje plán provádění indexeru.

Name	Typ	Description
interval	string (duration)	Časový interval mezi provedeními indexeru.
startTime	string (date-time)	Čas, kdy by měl indexer začít běžet.

KnowledgeBaseAzureOpenAIModel

Objekt

Určuje prostředek Azure OpenAI používaný k plánování dotazů.

Name	Typ	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Azure OpenAI parametry.
kind	string: azureOpenAI	Model umělé inteligence, který se má použít pro plánování dotazů.

KnowledgeBaseModelKind

Výčet

Model umělé inteligence, který se má použít pro plánování dotazů.

Hodnota	Description
azureOpenAI	K plánování dotazů používejte modely Azure Open AI.

KnowledgeSourceAzureOpenAIVectorizer

Objekt

Určuje prostředek Azure OpenAI použitý k vektorizaci řetězce dotazu.

Name	Typ	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Obsahuje parametry specifické pro vektorizaci vkládání Azure OpenAI.
kind	string: azureOpenAI	Název druhu metody vektorizace, která je konfigurována pro použití s vektorovým vyhledáváním.

KnowledgeSourceIngestionParameters

Objekt

Konsoliduje všechna obecná nastavení příjmu dat pro zdroje znalostí.

Name	Typ	Default value	Description
aiServices	AIServices		Volitelná konfigurace služeb AI Services pro zpracování obsahu.
assetStore	AssetStore		Volitelná konfigurace úložiště assetů pro ukládání extrahovaných assetů, jako jsou obrázky.
chatCompletionModel	KnowledgeBaseModel: KnowledgeBaseAzureOpenAIModel		Volitelný model doplňování chatu pro verbalizaci obrázků nebo extrakci kontextu.
contentExtractionMode	enum: minimal standard	minimal	Volitelný režim extrakce obsahu. Výchozí hodnota je 'minimální'.
disableImageVerbalization	boolean	False	Označuje, zda má být verbalizace obrazu vypnutá. Výchozí hodnota je nastavená na false.
embeddingModel	KnowledgeSourceVectorizer: KnowledgeSourceAzureOpenAIVectorizer		Volitelná konfigurace vektorizátoru pro vektorizaci obsahu.
freshnessPolicy	FreshnessPolicy		Volitelná politika čerstvosti pro zkreslení vyhledávání směrem k novějším dokumentům.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Explicitní identita, která se má použít pro tento zdroj znalostí.
ingestionPermissionOptions	KnowledgeSourceIngestionPermissionOption[]		Volitelný seznam typů oprávnění pro ingestování společně s obsahem dokumentu. Pokud je zadaný, nastaví možnosti oprávnění indexeru pro zdroj dat.
ingestionSchedule	IndexingSchedule		Volitelný plán pro příjem dat.

KnowledgeSourceIngestionPermissionOption

Výčet

Typy oprávnění pro vstup do obsahu dokumentu.

Hodnota	Description
userIds	Ingestujte explicitní identifikátory uživatelů spolu s obsahem dokumentu.
groupIds	Ingestujte identifikátory skupin spolu s obsahem dokumentu.
rbacScope	Ingestujte informace o rozsahu RBAC společně s obsahem dokumentu.
sensitivityLabels	Přistívejte štítky citlivosti Microsoft Purview vedle obsahu dokumentu.

KnowledgeSourceKind

Výčet

Druh zdroje znalostí.

Hodnota	Description
searchIndex	Zdroj znalostí, který čte data z indexu vyhledávání.
azureBlob	Zdroj znalostí, který čte a ingestuje data z Azure Blob Storage do indexu vyhledávání.
indexedSharePoint	Zdroj znalostí, který čte data z indexovaného SharePointu.
indexedOneLake	Zdroj znalostí, který čte data z indexovaného OneLake.
indexedSql	Zdroj znalostí, který získává a zpracovává data z Azure SQL Database nebo SQL Managed Instance do vyhledávacího indexu.
web	Zdroj znalostí, který čte data z webu.
remoteSharePoint	Zdroj znalostí, který čte data z vzdáleného SharePointu.
workIQ	Zdroj znalostí, který čte data z pracovního IQ
file	Zdroj znalostí, který podporuje přímé nahrávání a indexování souborů.
mcpServer	Zdroj znalostí podporovaný serverem MCP (Model Context Protocol).
fabricDataAgent	Zdroj znalostí, který získává data z Fabric Data Agent.
fabricOntology	Zdroj znalostí, který získává data z ontologií Microsoft Fabric Ontology.

McpServerAuthenticationKind

Výčet

Typ autentizace pro MCP server.

Hodnota	Description
foundryConnection	Autentizujte pomocí připojení Azure AI Foundry.
storedHeaders	Autentizujte pomocí uložených HTTP hlaviček.

McpServerAutoOutputParsing

Objekt

Automaticky detekujte výstupní formát a podle toho ho analyzujte.

Name	Typ	Description
kind	string: auto	Typ parsování výstupů, který je třeba použít.

McpServerFoundryConnectionAuthentication

Objekt

Autentizace pomocí připojení Azure AI Foundry.

Name	Typ	Description
foundryConnectionParameters	McpServerFoundryConnectionParameters	Parametry pro autentizaci připojení Foundry.
kind	string: foundryConnection	Typ autentizace, kterou použít.

McpServerFoundryConnectionParameters

Objekt

Parametry pro autentizaci připojení Foundry.

Name	Typ	Description
connectionId	string	Identifikátor spojení Azure AI Foundry.

McpServerJsonOutputParsing

Objekt

Výstup parsujte jako JSON dokument pomocí konfigurovaných parametrů JSON.

Name	Typ	Description
jsonParameters	McpServerOutputParsingJsonParameters	Parametry pro výstupní parsování JSON. Povinné, když je laskavost 'json'.
kind	string: json	Typ parsování výstupů, který je třeba použít.

McpServerKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí podporovaný serverem MCP (Model Context Protocol).

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: mcpServer	Typ zdroje znalostí.
mcpServerParameters	McpServerKnowledgeSourceParameters	Parametry pro zdroj znalostí MCP serveru.
name	string	Název zdroje znalostí.

McpServerKnowledgeSourceParameters

Objekt

Parametry pro zdroj znalostí MCP serveru.

Name	Typ	Description
authentication	McpServerAuthentication: McpServerFoundryConnectionAuthentication McpServerStoredHeadersAuthentication	Konfigurace autentizace pro MCP server.
serverURL	string	URL endpointu MCP serveru.
tools	McpServerTool[]	Seznam nástrojů, které je třeba vyvolat na MCP serveru.

McpServerNoneOutputParsing

Objekt

Považujte výstup za jeden blok bez jakéhokoliv parsování.

Name	Typ	Description
kind	string: none	Typ parsování výstupů, který je třeba použít.

McpServerOutputParsingJsonParameters

Objekt

Parametry pro výstupní parsování JSON.

Name	Typ	Description
documentsPath	string	JSON cesta k poli dokumentů ve výstupu nástroje.
includeContext	boolean	Zda zahrnout okolní kontext z výstupu JSON vedle extrahovaných dokumentů.

McpServerOutputParsingKind

Výčet

Typ výstupního parsování pro MCP serverový nástroj.

Hodnota	Description
auto	Automaticky detekujte výstupní formát a podle toho ho analyzujte.
json	Výstup parsujte jako JSON dokument pomocí konfigurovaných parametrů JSON.
split	Rozdělte výstup na stránky pomocí nastavených parametrů rozdělení.
none	Považujte výstup za jeden blok bez jakéhokoliv parsování.

McpServerOutputParsingSplitParameters

Objekt

Parametry pro rozdělené výstupní parsování.

Name	Typ	Description
defaultLanguageCode	SplitSkillLanguage	Hodnota označující kód jazyka, který se má použít. Výchozí hodnota je `en`.
maximumPageLength	integer (int32)	Maximální počet znaků na stránku.
maximumPagesToTake	integer (int32)	Maximální počet stran, které lze z výstupu odebrat.
pageOverlapLength	integer (int32)	Počet znaků, které se mají překrývat mezi stránkami.
textSplitMode	TextSplitMode	Režim rozdělení textu k použití.

McpServerSplitOutputParsing

Objekt

Rozdělte výstup na stránky pomocí nastavených parametrů rozdělení.

Name	Typ	Description
kind	string: split	Typ parsování výstupů, který je třeba použít.
splitParameters	McpServerOutputParsingSplitParameters	Parametry pro rozdělené výstupní parsování.

McpServerStoredHeadersAuthentication

Objekt

Autentizace pomocí uložených HTTP hlaviček.

Name	Typ	Description
kind	string: storedHeaders	Typ autentizace, kterou použít.
storedHeadersParameters	McpServerStoredHeadersParameters	Parametry pro autentizaci uložených hlaviček.

McpServerStoredHeadersParameters

Objekt

Parametry pro autentizaci uložených hlaviček.

Name	Typ	Description
headers	object	Uložené HTTP hlavičky pro zahrnutí do požadavků MCP serveru.

McpServerTool

Objekt

Představuje jeden nástroj v rámci zdroje znalostí MCP serveru.

Name	Typ	Description
inclusionMode	McpServerToolInclusionMode	Ovládá, jak jsou výsledky z tohoto nástroje integrovány do konečné sady výsledků. Výchozí nastavení je 'přeřazeno', pokud není specifikováno.
maxOutputTokens	integer (int32)	Volitelný limit tokenů po parsování pro výstup tohoto nástroje. Musí být větší než 0, když je uvedeno.
name	string	Název nástroje MCP, který se má vyvolat.
outputParsing	McpServerOutputParsing: McpServerAutoOutputParsing McpServerJsonOutputParsing McpServerNoneOutputParsing McpServerSplitOutputParsing	Volitelná konfigurace pro parsování výstupu nástroje.

McpServerToolInclusionMode

Výčet

Ovládá, jak jsou výsledky parsovaných MCP nástrojů integrovány do konečné sady výsledků.

Hodnota	Description
reranked	Výsledky nástrojů procházejí procesem rerankingu a agregace spolu s výsledky z jiných znalostních zdrojů. Toto je výchozí chování.
always	Výsledky nástrojů obcházejí přehodnocení a jsou vždy zahrnuty v kontextu agenta.

RemoteSharePointKnowledgeSource

Objekt

Konfigurace pro vzdálený zdroj znalostí SharePoint.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: remoteSharePoint	Typ zdroje znalostí.
name	string	Název zdroje znalostí.
remoteSharePointParameters	RemoteSharePointKnowledgeSourceParameters	Parametry pro vzdálený zdroj znalostí SharePoint.

RemoteSharePointKnowledgeSourceParameters

Objekt

Parametry pro vzdálený zdroj znalostí SharePoint.

Name	Typ	Description
containerTypeId	string	ID kontejneru pro připojení ke službě SharePoint Embedded. Pokud je tato hodnota null, použije se SharePoint Online.
filterExpression	string	Výraz KQL (Keyword Query Language) s dotazovatelnými vlastnostmi a atributy SharePointu pro rozsah načítání před spuštěním dotazu.
resourceMetadata	string[]	Seznam polí metadat, která mají být vrácena pro každou položku v odpovědi. Do tohoto seznamu lze zahrnout pouze načíst vlastnosti metadat. Ve výchozím nastavení se nevrací žádná metadata.

SearchIndexerDataNoneIdentity

Objekt

Vymaže vlastnost identity zdroje dat.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Fragment identifikátoru URI určující typ identity.

SearchIndexerDataUserAssignedIdentity

Objekt

Určuje identitu zdroje dat, která se má použít.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Fragment identifikátoru URI určující typ identity.
federatedIdentityClientId	string	Multi-tenant User-Assigned Managed Identity Support: Klientské ID multi-tentant aplikace, které bylo nakonfigurováno tak, aby federovalo s uživatelem přiřazenou spravovanou identitou.
userAssignedIdentity	string	Plně kvalifikované ID prostředku Azure spravované identity přiřazené uživatelem obvykle ve formátu /subscriptions/12345678-1234-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId, které by měly být přiřazeny vyhledávací službě.

SearchIndexFieldReference

Objekt

Referenční pole pro vyhledávací index.

Name	Typ	Description
name	string	Název pole.

SearchIndexKnowledgeSource

Objekt

Zdroj znalostí: Cílení na vyhledávací index.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: searchIndex	Typ zdroje znalostí.
name	string	Název zdroje znalostí.
searchIndexParameters	SearchIndexKnowledgeSourceParameters	Parametry pro zdroj znalostí.

SearchIndexKnowledgeSourceParameters

Objekt

Parametry pro vyhledávací index zdroje znalostí.

Name	Typ	Description
baseFilter	string	Výchozí podmínka filtru aplikovaná na index při vyhledání (např. 'Stavová rovnice VA'). Lze jej přepsat v době dotazu pomocí parametrů běhu znalostního zdroje.
searchFields	SearchIndexFieldReference[]	Slouží k omezení polí, která se mají prohledávat ve vyhledávacím indexu.
searchIndexName	string	Název indexu vyhledávání.
semanticConfigurationName	string	Slouží k určení jiné sémantické konfigurace cílového vyhledávacího indexu, než je výchozí.
sourceDataFields	SearchIndexFieldReference[]	Slouží k vyžádání dalších polí pro odkazovaná zdrojová data.

SearchResourceEncryptionKey

Objekt

Šifrovací klíč spravovaný zákazníkem ve službě Azure Key Vault. Klíče, které vytvoříte a spravujete, lze použít k šifrování nebo dešifrování neaktivních uložených dat, jako jsou indexy a mapy synonym.

Name	Typ	Default value	Description
accessCredentials.applicationId	string		ID aplikace AAD, kterému byla udělena požadovaná přístupová oprávnění ke službě Azure Key Vault, která se má použít při šifrování neaktivních uložených dat. ID aplikace by nemělo být zaměňováno s ID objektu pro vaši aplikaci AAD.
accessCredentials.applicationSecret	string		Ověřovací klíč zadané aplikace AAD.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Explicitní spravovaná identita, která se má použít pro tento šifrovací klíč. Pokud není zadána vlastnost přihlašovacích údajů přístupu null, použije se spravovaná identita přiřazená systémem. Při aktualizaci prostředku zůstane explicitní identita beze změny. Pokud je zadána hodnota "none", hodnota této vlastnosti je vymazána.
isServiceLevelKey	boolean	False	Volitelná hodnota označující, zda je tento klíč klíčem na úrovni služby. Výchozí hodnota je nastavená na false.
keyVaultKeyName	string		Název klíče služby Azure Key Vault, který se má použít k šifrování neaktivních uložených dat.
keyVaultKeyVersion	string		Verze klíče služby Azure Key Vault, která se má použít k šifrování neaktivních uložených dat.
keyVaultUri	string		Identifikátor URI služby Azure Key Vault, označovaný také jako název DNS, který obsahuje klíč, který se má použít k šifrování neaktivních uložených dat. Příkladem identifikátoru URI může být `https://my-keyvault-name.vault.azure.net`.

SplitSkillLanguage

Výčet

Jazykové kódy podporované pro vstupní text službou SplitSkill.

Hodnota	Description
am	Amharština
bs	Bosenština
cs	Čeština
da	Dánština
de	Němčina
en	Angličtina
es	Španělština
et	Estonština
fi	Finština
fr	francouzský
he	Hebrejština
hi	Hindština
hr	Chorvatština
hu	Maďarština
id	Indonesian
is	Islandština
it	Italština
ja	Japonština
ko	Korejština
lv	Lotyština
nb	Norština
nl	Nizozemština
pl	Polština
pt	Portugalština (Portugalsko)
pt-br	Portugalština (Brazílie)
ru	Ruština
sk	Slovenština
sl	Slovinština
sr	Srbština
sv	Švédština
tr	Turečtina
ur	Urdština
zh	Čínština (zjednodušená)

TextSplitMode

Výčet

Hodnota označující, který režim rozdělení se má provést.

Hodnota	Description
pages	Rozdělte text na jednotlivé stránky.
sentences	Rozdělte text na jednotlivé věty.

VectorSearchVectorizerKind

Výčet

Metoda vektorizace, která se má použít během doby dotazu.

Hodnota	Description
azureOpenAI	Generování vkládání pomocí prostředku Azure OpenAI v době dotazu
customWebApi	Generování vkládání pomocí vlastního webového koncového bodu v době dotazu
aiServicesVision	Generování vkládání pro obrázek nebo textový vstup v době dotazu pomocí rozhraní API pro zpracování obrazu ve službě Azure AI Services Vectorize
aml	Generování vložení pomocí koncového bodu Azure Machine Learning nasazeného prostřednictvím katalogu modelů Azure AI Foundry v době dotazu.

WebKnowledgeSource

Objekt

Zdroj znalostí: Cílení na webové výsledky.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: web	Typ zdroje znalostí.
name	string	Název zdroje znalostí.
webParameters	WebKnowledgeSourceParameters	Parametry webového zdroje znalostí.

WebKnowledgeSourceDomain

Objekt

Konfigurace pro webovou zdrojovou doménu znalostí.

Name	Typ	Description
address	string	Adresa domény.
includeSubpages	boolean	Zda zahrnout podstránky z této domény.

WebKnowledgeSourceDomains

Objekt

Konfigurace povolení/blokování domény pro webový zdroj znalostí.

Name	Typ	Description
allowedDomains	WebKnowledgeSourceDomain[]	Domény, které jsou povoleny pro webové výsledky.
blockedDomains	WebKnowledgeSourceDomain[]	Domény, které jsou blokovány ve webových výsledcích.

WebKnowledgeSourceParameters

Objekt

Parametry pro webový zdroj znalostí.

Name	Typ	Description
count	integer (int32)	Výchozí počet webových výsledků k vrácení. Lze jej přepsat v době dotazu pomocí parametrů běhu znalostního zdroje.
domains	WebKnowledgeSourceDomains	Konfigurace povolení/blokování domény pro webové výsledky.
freshness	string	Výchozí filtr čerstvosti pro webové výsledky. Lze jej přepsat v době dotazu pomocí parametrů běhu znalostního zdroje.
language	string	Výchozí jazyk pro webové výsledky. Lze jej přepsat v době dotazu pomocí parametrů běhu znalostního zdroje.
market	string	Výchozí trh pro webové výsledky. Lze jej přepsat v době dotazu pomocí parametrů běhu znalostního zdroje.

WorkIQKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí WorkIQ.

Name	Typ	Description
@odata.etag	string	ETag zdroje znalostí.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč slouží k poskytnutí další úrovně šifrování v klidu pro definici zdroje znalostí, když chcete mít plnou jistotu, že nikdo, ani Microsoft, je nemůže dešifrovat. Jakmile zašifrujete definici zdroje znalostí, zůstane vždy zašifrovaná. Vyhledávací služba bude ignorovat pokusy o nastavení této vlastnosti na hodnotu null. Tuto vlastnost můžete podle potřeby měnit, pokud chcete šifrovací klíč otáčet; Definice vašeho zdroje znalostí zůstane nedotčena. Šifrování pomocí klíčů spravovaných zákazníkem není k dispozici pro bezplatné vyhledávací služby a je k dispozici pouze pro placené služby vytvořené 1. ledna 2019 nebo později.
kind	string: workIQ	Typ zdroje znalostí.
name	string	Název zdroje znalostí.