Knowledge Sources - Create

Szolgáltatás:: Search Service

API-verzió:: 2025-11-01-preview

Új tudásforrást hoz létre.

POST {endpoint}/knowledgesources?api-version=2025-11-01-preview

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.
Accept		Accept	Az Elfogadás fejléce.

Kérelem törzse

A kérelem törzse az alábbiak valamelyike lehet:

Név	Description
AzureBlobKnowledgeSource	Az Azure Blob Storage tudásforrás konfigurálása.
IndexedOneLakeKnowledgeSource	A OneLake tudásforrás konfigurálása.
IndexedSharePointKnowledgeSource	A SharePoint tudásforrás konfigurálása.
RemoteSharePointKnowledgeSource	Távoli SharePoint-tudásforrás konfigurálása.
SearchIndexKnowledgeSource	Tudásforrás keresési indexet céloz meg.
WebKnowledgeSource	Tudásforrás webes eredmények megcélzása.

AzureBlobKnowledgeSource

Az Azure Blob Storage tudásforrás konfigurálása.

Név	Kötelező	Típus	Description
azureBlobParameters	True	AzureBlobKnowledgeSourceParameters	A tudásforrás típusa.
kind	True	string: azureBlob	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.

IndexedOneLakeKnowledgeSource

A OneLake tudásforrás konfigurálása.

Név	Kötelező	Típus	Description
indexedOneLakeParameters	True	IndexedOneLakeKnowledgeSourceParameters	A tudásforrás paraméterei.
kind	True	string: indexedOneLake	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.

IndexedSharePointKnowledgeSource

A SharePoint tudásforrás konfigurálása.

Név	Kötelező	Típus	Description
indexedSharePointParameters	True	IndexedSharePointKnowledgeSourceParameters	A tudásforrás paraméterei.
kind	True	string: indexedSharePoint	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.

RemoteSharePointKnowledgeSource

Távoli SharePoint-tudásforrás konfigurálása.

Név	Kötelező	Típus	Description
kind	True	string: remoteSharePoint	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
remoteSharePointParameters		RemoteSharePointKnowledgeSourceParameters	A távoli SharePoint tudásforrás paraméterei.

SearchIndexKnowledgeSource

Tudásforrás keresési indexet céloz meg.

Név	Kötelező	Típus	Description
kind	True	string: searchIndex	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
searchIndexParameters	True	SearchIndexKnowledgeSourceParameters	A tudásforrás paraméterei.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.

WebKnowledgeSource

Tudásforrás webes eredmények megcélzása.

Név	Kötelező	Típus	Description
kind	True	string: web	A tudásforrás típusa.
name	True	string	A tudásforrás neve.
@odata.etag		string	A tudásforrás ETag-ja.
description		string	Opcionális felhasználó által definiált leírás.
encryptionKey		SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
webParameters		WebKnowledgeSourceParameters	A webes tudásforrás paraméterei.

Válaszok

Név	Típus	Description
201 Created	KnowledgeSource: AzureBlobKnowledgeSource IndexedOneLakeKnowledgeSource IndexedSharePointKnowledgeSource RemoteSharePointKnowledgeSource SearchIndexKnowledgeSource WebKnowledgeSource	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Név	Description
https://search.azure.com/.default

Példák

SearchServiceCreateKnowledgeSource

SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSourceIndexedOneLake

SearchServiceCreateKnowledgeSourceIndexedSharePoint

SearchServiceCreateKnowledgeSourceWeb

SearchServiceCreateKnowledgeSource

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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": {
      "dataSourceConnection": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedOneLake

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceWeb

Mintakérelem

HTTP

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


{
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "web",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Mintaválasz

Állapotkó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
        }
      ]
    }
  }
}

Definíciók

Név	Description
Accept	Az Elfogadás fejléce.
AIServices	Paraméterek az MI szolgáltatásokhoz.
AzureBlobKnowledgeSource	Az Azure Blob Storage tudásforrás konfigurálása.
AzureBlobKnowledgeSourceParameters	Az Azure Blob Storage tudásforrás paraméterei.
AzureOpenAIModelName	A meghívott Azure Open AI-modell neve.
AzureOpenAIVectorizerParameters	Megadja az Azure OpenAI-erőforráshoz való csatlakozás paramétereit.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
IndexedOneLakeKnowledgeSource	A OneLake tudásforrás konfigurálása.
IndexedOneLakeKnowledgeSourceParameters	A OneLake tudásforrás paraméterei.
IndexedSharePointContainerName	Megadja, hogy mely SharePoint-tárakat szeretné elérni.
IndexedSharePointKnowledgeSource	A SharePoint tudásforrás konfigurálása.
IndexedSharePointKnowledgeSourceParameters	A SharePoint tudásforrás paraméterei.
IndexingSchedule	Az indexelő végrehajtásának ütemezését jelöli.
KnowledgeBaseAzureOpenAIModel	Megadja a lekérdezések tervezéséhez használt Azure OpenAI-erőforrást.
KnowledgeBaseModelKind	A lekérdezések tervezéséhez használt AI-modell.
KnowledgeSourceAzureOpenAIVectorizer	Megadja a lekérdezési sztring vektorizálásához használt Azure OpenAI-erőforrást.
KnowledgeSourceIngestionParameters	Összevonja a tudásforrások összes általános betöltési beállítását.
KnowledgeSourceIngestionPermissionOption	Engedélytípusok, amelyekkel együtt kell beolvasni a dokumentum tartalmát.
KnowledgeSourceKind	A tudásforrás fajtája.
RemoteSharePointKnowledgeSource	Távoli SharePoint-tudásforrás konfigurálása.
RemoteSharePointKnowledgeSourceParameters	A távoli SharePoint-tudásforrás paraméterei.
SearchIndexerDataNoneIdentity	Törli az adatforrás identitástulajdonságát.
SearchIndexerDataUserAssignedIdentity	Megadja a használni kívánt adatforrás identitását.
SearchIndexFieldReference	Mezőreferenciát a keresési indexhez.
SearchIndexKnowledgeSource	Tudásforrás keresési indexet céloz meg.
SearchIndexKnowledgeSourceParameters	A keresési index tudásforrásának paraméterei.
SearchResourceEncryptionKey	Ügyfél által felügyelt titkosítási kulcs az Azure Key Vaultban. A létrehozott és kezelt kulcsok az inaktív adatok, például az indexek és a szinonimatérképek titkosítására vagy visszafejtésére használhatók.
VectorSearchVectorizerKind	A lekérdezés során használandó vektorizálási módszer.
WebKnowledgeSource	Tudásforrás webes eredmények megcélzása.
WebKnowledgeSourceDomain	Webes tudásforrás-tartomány konfigurálása.
WebKnowledgeSourceDomains	Tartomány engedélyezési/blokkolási konfigurációja webes tudásforráshoz.
WebKnowledgeSourceParameters	A webes tudásforrás paraméterei.

Accept

Felsorolás

Az Elfogadás fejléce.

Érték	Description
application/json;odata.metadata=minimal

AIServices

Tárgy

Paraméterek az MI szolgáltatásokhoz.

Név	Típus	Description
apiKey	string	Az AI-szolgáltatások eléréséhez szükséges API-kulcs.
uri	string (uri)	A AI Services végpont URI-ja.

AzureBlobKnowledgeSource

Tárgy

Az Azure Blob Storage tudásforrás konfigurálása.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
azureBlobParameters	AzureBlobKnowledgeSourceParameters	A tudásforrás típusa.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
kind	string: azureBlob	A tudásforrás típusa.
name	string	A tudásforrás neve.

AzureBlobKnowledgeSourceParameters

Tárgy

Az Azure Blob Storage tudásforrás paraméterei.

Név	Típus	Alapértelmezett érték	Description
connectionString	string		Kulcsalapú kapcsolati sztring vagy a ResourceId formátum, ha felügyelt identitást használ.
containerName	string		A blob Storage-tároló neve.
createdResources	object		A tudásforrás által létrehozott erőforrások.
folderPath	string		Nem kötelező mappa elérési útja a tárolón belül.
ingestionParameters	KnowledgeSourceIngestionParameters		Összevonja az összes általános betöltési beállítást.
isADLSGen2	boolean	False	Állítsa igaz értékre, ha ADLS Gen2-tárfiókhoz csatlakozik. Az alapértelmezett érték false.

AzureOpenAIModelName

Felsorolás

A meghívott Azure Open AI-modell neve.

Érték	Description
text-embedding-ada-002	TextEmbeddingAda002 modell.
text-embedding-3-large	TextEmbedding3Large modell.
text-embedding-3-small	TextEmbedding3Small modell.
gpt-4o	Gpt4o modell.
gpt-4o-mini	Gpt4oMini modell.
gpt-4.1	Gpt41 modell.
gpt-4.1-mini	Gpt41Mini modell.
gpt-4.1-nano	Gpt41Nano modell.
gpt-5	Gpt5 modell.
gpt-5-mini	Gpt5Mini modell.
gpt-5-nano	Gpt5Nano modell.

AzureOpenAIVectorizerParameters

Tárgy

Megadja az Azure OpenAI-erőforráshoz való csatlakozás paramétereit.

Név	Típus	Description
apiKey	string	A kijelölt Azure OpenAI-erőforrás API-kulcsa.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	A kimenő kapcsolatokhoz használt, felhasználó által hozzárendelt felügyelt identitás.
deploymentId	string	Az Azure OpenAI-modell üzembe helyezésének azonosítója a kijelölt erőforráson.
modelName	AzureOpenAIModelName	A megadott deploymentId elérési úton üzembe helyezett beágyazási modell neve.
resourceUri	string (uri)	Az Azure OpenAI-erőforrás erőforrás-URI-ja.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Description
error	ErrorDetail	A hibaobjektum.

IndexedOneLakeKnowledgeSource

Tárgy

A OneLake tudásforrás konfigurálása.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
indexedOneLakeParameters	IndexedOneLakeKnowledgeSourceParameters	A tudásforrás paraméterei.
kind	string: indexedOneLake	A tudásforrás típusa.
name	string	A tudásforrás neve.

IndexedOneLakeKnowledgeSourceParameters

Tárgy

A OneLake tudásforrás paraméterei.

Név	Típus	Description
createdResources	object	A tudásforrás által létrehozott erőforrások.
fabricWorkspaceId	string	OneLake-munkaterület azonosítója.
ingestionParameters	KnowledgeSourceIngestionParameters	Összevonja az összes általános betöltési beállítást.
lakehouseId	string	Megadja, hogy melyik OneLake tóházhoz férjen hozzá.
targetPath	string	Opcionális OneLakehouse mappa vagy parancsikon a OneLake-tartalom szűréséhez.

IndexedSharePointContainerName

Felsorolás

Megadja, hogy mely SharePoint-tárakat szeretné elérni.

Érték	Description
defaultSiteLibrary	A webhely alapértelmezett dokumentumtárának tartalmának indexelése.
allSiteLibraries	A webhely összes dokumentumtárának tartalmának indexelése.
useQuery	Használj lekérdezést a SharePoint tartalom szűrésére.

IndexedSharePointKnowledgeSource

Tárgy

A SharePoint tudásforrás konfigurálása.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
indexedSharePointParameters	IndexedSharePointKnowledgeSourceParameters	A tudásforrás paraméterei.
kind	string: indexedSharePoint	A tudásforrás típusa.
name	string	A tudásforrás neve.

IndexedSharePointKnowledgeSourceParameters

Tárgy

A SharePoint tudásforrás paraméterei.

Név	Típus	Description
connectionString	string	SharePoint-kapcsolati sztring formátumban: SharePointOnlineEndpoint=[SharePoint-webhely URL-címe]; ApplicationId=[Azure AD-alkalmazásazonosító]; ApplicationSecret=[Azure AD-alkalmazás titkos ügyfélkód]; TenantId=[SharePoint-webhely bérlőazonosítója]
containerName	IndexedSharePointContainerName	Megadja, hogy mely SharePoint-tárakat szeretné elérni.
createdResources	object	A tudásforrás által létrehozott erőforrások.
ingestionParameters	KnowledgeSourceIngestionParameters	Összevonja az összes általános betöltési beállítást.
query	string	Opcionális lekérdezés a SharePoint-tartalom szűréséhez.

IndexingSchedule

Tárgy

Az indexelő végrehajtásának ütemezését jelöli.

Név	Típus	Description
interval	string (duration)	Az indexelő végrehajtásai közötti időintervallum.
startTime	string (date-time)	Az az időpont, amikor az indexelő elindul.

KnowledgeBaseAzureOpenAIModel

Tárgy

Megadja a lekérdezések tervezéséhez használt Azure OpenAI-erőforrást.

Név	Típus	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Azure OpenAI paraméterek.
kind	string: azureOpenAI	A lekérdezések tervezéséhez használt AI-modell.

KnowledgeBaseModelKind

Felsorolás

A lekérdezések tervezéséhez használt AI-modell.

Érték	Description
azureOpenAI	Lekérdezéstervezéshez használja az Azure Open AI-modelleket.

KnowledgeSourceAzureOpenAIVectorizer

Tárgy

Megadja a lekérdezési sztring vektorizálásához használt Azure OpenAI-erőforrást.

Név	Típus	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Az Azure OpenAI beágyazott vektorizálásra jellemző paramétereket tartalmazza.
kind	string: azureOpenAI	A vektoros kereséshez konfigurált vektorizálási módszer neve.

KnowledgeSourceIngestionParameters

Tárgy

Összevonja a tudásforrások összes általános betöltési beállítását.

Név	Típus	Alapértelmezett érték	Description
aiServices	AIServices		Opcionális AI Services konfiguráció a tartalomfeldolgozáshoz.
chatCompletionModel	KnowledgeBaseModel: KnowledgeBaseAzureOpenAIModel		Opcionális csevegési befejezési modell a kép verbalizálásához vagy a kontextus kinyeréséhez.
contentExtractionMode	enum: minimal standard	minimal	Opcionális tartalomkinyerési mód. Az alapértelmezett érték a "minimális".
disableImageVerbalization	boolean	False	Azt jelzi, hogy a kép verbalizálását le kell-e tiltani. Az alapértelmezett érték false.
embeddingModel	KnowledgeSourceVectorizer: KnowledgeSourceAzureOpenAIVectorizer		Opcionális vektorizáló konfiguráció a tartalom vektorizálásához.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		A tudásforráshoz használandó explicit identitás.
ingestionPermissionOptions	KnowledgeSourceIngestionPermissionOption[]		A dokumentum tartalmával együtt betöltendő engedélytípusok opcionális listája. Ha meg van adva, beállítja az adatforrás indexelő engedélybeállításait.
ingestionSchedule	IndexingSchedule		Az adatbetöltés nem kötelező ütemezése.

KnowledgeSourceIngestionPermissionOption

Felsorolás

Engedélytípusok, amelyekkel együtt kell beolvasni a dokumentum tartalmát.

Érték	Description
userIds	Explicit felhasználói azonosítók betöltése a dokumentum tartalma mellett.
groupIds	Csoportazonosítók betöltése a dokumentum tartalma mellett.
rbacScope	Az RBAC-hatókörrel kapcsolatos információk betöltése a dokumentum tartalma mellett.

KnowledgeSourceKind

Felsorolás

A tudásforrás fajtája.

Érték	Description
searchIndex	Olyan tudásforrás, amely adatokat olvas be egy keresési indexből.
azureBlob	Olyan tudásforrás, amely adatokat olvas és tölt be az Azure Blob Storage-ból egy keresési indexbe.
indexedSharePoint	Egy tudásforrás, amely adatokat olvas az indexelt SharePoint-ről.
indexedOneLake	Egy tudásforrás, amely adatokat olvas az indexelt OneLake-ből.
web	Egy tudásforrás, amely adatokat olvas a webről.
remoteSharePoint	Egy tudásforrás, amely adatokat olvas a távoli SharePoint-ról.

RemoteSharePointKnowledgeSource

Tárgy

Távoli SharePoint-tudásforrás konfigurálása.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
kind	string: remoteSharePoint	A tudásforrás típusa.
name	string	A tudásforrás neve.
remoteSharePointParameters	RemoteSharePointKnowledgeSourceParameters	A távoli SharePoint tudásforrás paraméterei.

RemoteSharePointKnowledgeSourceParameters

Tárgy

A távoli SharePoint-tudásforrás paraméterei.

Név	Típus	Description
containerTypeId	string	SharePoint Embedded-kapcsolat tárolóazonosítója. Ha ez null, akkor a SharePoint Online-t fogja használni.
filterExpression	string	Kulcsszólekérdezési nyelv (KQL) kifejezés lekérdezhető SharePoint-tulajdonságokkal és attribútumokkal a lekérdezés futtatása előtti lekérés hatóköréhez.
resourceMetadata	string[]	A válasz egyes elemeihez visszaadandó metaadatmezők listája. Csak a lekért metaadat-tulajdonságok szerepelhetnek ebben a listában. Alapértelmezés szerint a rendszer nem ad vissza metaadatokat.

SearchIndexerDataNoneIdentity

Tárgy

Törli az adatforrás identitástulajdonságát.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Az identitás típusát meghatározó URI-töredék.

SearchIndexerDataUserAssignedIdentity

Tárgy

Megadja a használni kívánt adatforrás identitását.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Az identitás típusát meghatározó URI-töredék.
userAssignedIdentity	string	A felhasználó által hozzárendelt felügyelt identitás teljes Azure-erőforrás-azonosítója, általában a következő formátumban: "/subscriptions/12345678-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId", amelyet hozzá kellett volna rendelni a keresési szolgáltatáshoz.

SearchIndexFieldReference

Tárgy

Mezőreferenciát a keresési indexhez.

Név	Típus	Description
name	string	A mező neve.

SearchIndexKnowledgeSource

Tárgy

Tudásforrás keresési indexet céloz meg.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
kind	string: searchIndex	A tudásforrás típusa.
name	string	A tudásforrás neve.
searchIndexParameters	SearchIndexKnowledgeSourceParameters	A tudásforrás paraméterei.

SearchIndexKnowledgeSourceParameters

Tárgy

A keresési index tudásforrásának paraméterei.

Név	Típus	Description
searchFields	SearchIndexFieldReference[]	A keresési indexben keresendő mezők korlátozására szolgál.
searchIndexName	string	A keresési index neve.
semanticConfigurationName	string	Az alapértelmezetttől eltérő szemantikai konfiguráció megadására szolgál a cél keresési indexén.
sourceDataFields	SearchIndexFieldReference[]	A hivatkozott forrásadatok további mezőinek kérésére szolgál.

SearchResourceEncryptionKey

Tárgy

Ügyfél által felügyelt titkosítási kulcs az Azure Key Vaultban. A létrehozott és kezelt kulcsok az inaktív adatok, például az indexek és a szinonimatérképek titkosítására vagy visszafejtésére használhatók.

Név	Típus	Description
accessCredentials.applicationId	string	Egy AAD-alkalmazásazonosító, amely megkapta a szükséges hozzáférési engedélyeket az Azure Key Vaulthoz, amelyet az inaktív adatok titkosításához kell használni. Az alkalmazásazonosító nem tévesztendő össze az AAD-alkalmazás objektumazonosítójával.
accessCredentials.applicationSecret	string	A megadott AAD-alkalmazás hitelesítési kulcsa.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Explicit felügyelt identitás ehhez a titkosítási kulcshoz. Ha nincs megadva, és a hozzáférési hitelesítő adatok tulajdonság null értékű, akkor a rendszer a rendszer által hozzárendelt felügyelt identitást használja. Az erőforrás frissítésekor, ha az explicit identitás nincs meghatározva, az változatlan marad. Ha nincs megadva, a tulajdonság értéke törlődik.
keyVaultKeyName	string	A inaktív adatok titkosításához használandó Azure Key Vault-kulcs neve.
keyVaultKeyVersion	string	Az Azure Key Vault-kulcs inaktív adatok titkosításához használandó verziója.
keyVaultUri	string	Az Azure Key Vault URI-ja, más néven DNS-név, amely tartalmazza az inaktív adatok titkosításához használandó kulcsot. Példa URI lehet `https://my-keyvault-name.vault.azure.net`.

VectorSearchVectorizerKind

Felsorolás

A lekérdezés során használandó vektorizálási módszer.

Érték	Description
azureOpenAI	Beágyazásokat hozhat létre egy Azure OpenAI-erőforrás használatával lekérdezéskor.
customWebApi	Beágyazások létrehozása egyéni webes végpont használatával lekérdezéskor.
aiServicesVision	Az Azure AI Services Vision Vectorize API használatával beágyazásokat hozhat létre egy kép- vagy szövegbevitelhez lekérdezési időpontban.
aml	Beágyazásokat hozhat létre egy Azure Machine Learning végponttal, amely a lekérdezéskor az Azure AI Foundry modellkatalógusán keresztül van üzembe helyezve.

WebKnowledgeSource

Tárgy

Tudásforrás webes eredmények megcélzása.

Név	Típus	Description
@odata.etag	string	A tudásforrás ETag-ja.
description	string	Opcionális felhasználó által definiált leírás.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban létrehozott titkosítási kulcs leírása. Ezt a kulcsot arra használják, hogy további szintű titkosítást biztosítson a tudásforrás definíciójához, amikor teljes biztosítékot szeretnél arra, hogy senki, még a Microsoft sem tudja visszafejteni őket. Miután titkosítottad a tudásforrás definícióját, az mindig titkosított marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatod, ha szeretnéd elforgatni a titkosítási kulcsodat; A tudásforrás definíciója nem fog változni. Az ügyfél által felügyelt kulcsokkal rendelkező titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
kind	string: web	A tudásforrás típusa.
name	string	A tudásforrás neve.
webParameters	WebKnowledgeSourceParameters	A webes tudásforrás paraméterei.

WebKnowledgeSourceDomain

Tárgy

Webes tudásforrás-tartomány konfigurálása.

Név	Típus	Description
address	string	A domain címe.
includeSubpages	boolean	Hogy a domainből származó aloldalakat tartalmazzon-e vagy sem.

WebKnowledgeSourceDomains

Tárgy

Tartomány engedélyezési/blokkolási konfigurációja webes tudásforráshoz.

Név	Típus	Description
allowedDomains	WebKnowledgeSourceDomain[]	Domainek, amelyek engedélyezettek webes eredményekhez.
blockedDomains	WebKnowledgeSourceDomain[]	Olyan domainek, amelyeket a webes eredmények nem zárnak.

WebKnowledgeSourceParameters

Tárgy

A webes tudásforrás paraméterei.

Név	Típus	Description
domains	WebKnowledgeSourceDomains	Tartomány engedélyezési/letiltási konfigurációja webes eredményekhez.