Knowledge Sources - Create

Služba:: Search Service

Verze rozhraní API:: 2025-08-01-preview

Vytvoří nový zdroj znalostí.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
api-version	query	True	string	Verze rozhraní API klienta.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string (uuid)	ID sledování odeslané s požadavkem na pomoc s laděním.

Text požadavku

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

Name	Description
AzureBlobKnowledgeSource	Konfigurace pro zdroj znalostí Azure Blob Storage.
SearchIndexKnowledgeSource	Zdroj znalostí: Cílení na vyhledávací index.

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	Značka ETag agenta.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč se používá k poskytnutí další úrovně šifrování neaktivních uložených dat pro definici agenta, když chcete mít plnou jistotu, že je nikdo, ani Microsoft, nemůže dešifrovat. Jakmile definici agenta zašifrujete, 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 změnit, pokud chcete šifrovací klíč otočit; Definice agenta nebude ovlivněna. Š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.

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	Značka ETag agenta.
description		string	Volitelný uživatelsky definovaný popis.
encryptionKey		SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč se používá k poskytnutí další úrovně šifrování neaktivních uložených dat pro definici agenta, když chcete mít plnou jistotu, že je nikdo, ani Microsoft, nemůže dešifrovat. Jakmile definici agenta zašifrujete, 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 změnit, pokud chcete šifrovací klíč otočit; Definice agenta nebude ovlivněna. Š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: SearchIndexKnowledgeSource AzureBlobKnowledgeSource	Úspěšně vytvořený zdroj znalostí
Other Status Codes	ErrorResponse	Chybová odpověď.

Příklady

SearchServiceCreateKnowledgeSource

SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSource

Ukázkový požadavek

HTTP

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


{
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "sourceDataSelect": "description,category"
  },
  "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",
    "sourceDataSelect": "description,category"
  }
}

SearchServiceCreateKnowledgeSourceAzureBlob

Ukázkový požadavek

HTTP

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


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

Definice

Name	Description
AIFoundryModelCatalogName	Název modelu vkládání z katalogu Azure AI Foundry, který se bude volat.
AIServicesVisionParameters	Určuje parametry AI Services Vision pro vektorizaci obrázku nebo textu dotazu.
AIServicesVisionVectorizer	Určuje parametry AI Services Vision pro vektorizaci obrázku nebo textu dotazu.
AMLParameters	Určuje vlastnosti pro připojení k vektorizátoru AML.
AMLVectorizer	Určuje koncový bod Azure Machine Learning nasazený prostřednictvím katalogu modelů Azure AI Foundry pro generování vektorového vkládání řetězce dotazu.
AzureActiveDirectoryApplicationCredentials	Přihlašovací údaje registrované aplikace vytvořené pro vaši vyhledávací službu, která se používá pro ověřený přístup k šifrovacím klíčům uloženým v Azure Key Vault.
AzureBlobKnowledgeSource	Konfigurace pro zdroj znalostí Azure Blob Storage.
AzureBlobKnowledgeSourceParameters	Parametry pro zdroj znalostí služby Azure Blob Storage.
AzureOpenAIEmbeddingSkill	Umožňuje vygenerovat vektorové vložení pro daný textový vstup pomocí prostředku Azure OpenAI.
AzureOpenAIModelName	Název modelu Azure Open AI, který se bude volat.
AzureOpenAIParameters	Určuje parametry pro připojení k prostředku Azure OpenAI.
AzureOpenAIVectorizer	Určuje prostředek Azure OpenAI použitý k vektorizaci řetězce dotazu.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
IndexingSchedule	Představuje plán provádění indexeru.
InputFieldMappingEntry	Mapování vstupního pole pro dovednost.
KnowledgeAgentAzureOpenAIModel	Určuje prostředek Azure OpenAI používaný k plánování dotazů.
KnowledgeAgentModelKind	Model umělé inteligence, který se má použít pro plánování dotazů.
KnowledgeSourceKind	Druh zdroje znalostí.
OutputFieldMappingEntry	Mapování výstupního pole pro dovednost.
SearchIndexerDataNoneIdentity	Vymaže vlastnost identity zdroje dat.
SearchIndexerDataUserAssignedIdentity	Určuje identitu zdroje dat, který se má použít.
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.
VectorSearchVectorizerKind	Metoda vektorizace, která se má použít během doby dotazu.
WebApiParameters	Určuje vlastnosti pro připojení k uživatelsky definovanému vektorizátoru.
WebApiVectorizer	Určuje uživatelem definovaný vektorizátor pro generování vektorového vkládání řetězce dotazu. Integrace externího vektorizátoru se provádí pomocí vlastního rozhraní webového rozhraní API sady dovedností.

AIFoundryModelCatalogName

Výčet

Název modelu vkládání z katalogu Azure AI Foundry, který se bude volat.

Hodnota	Description
OpenAI-CLIP-Image-Text-Embeddings-vit-base-patch32
OpenAI-CLIP-Image-Text-Embeddings-ViT-Large-Patch14-336
Facebook-DinoV2-Image-Embeddings-ViT-Base
Facebook-DinoV2-Image-Embeddings-ViT-Giant
Cohere-embed-v3-english
Cohere-embed-v3-multilingual
Cohere-embed-v4	Cohere embed v4 model pro generování vkládání z textu i obrázků.

AIServicesVisionParameters

Objekt

Určuje parametry AI Services Vision pro vektorizaci obrázku nebo textu dotazu.

Name	Typ	Description
apiKey	string	Klíč rozhraní API určeného prostředku služeb AI.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Spravovaná identita přiřazená uživatelem používaná pro odchozí připojení. Pokud je zadán authResourceId a není zadaný, použije se spravovaná identita přiřazená systémem. Pokud při aktualizacích indexu není identita určena, hodnota zůstane nezměněna. Pokud je nastavena na "none", hodnota této vlastnosti je vymazána.
modelVersion	string	Verze modelu, která se má použít při volání služby AI Services Vision. Pokud není zadáno, použije se jako výchozí nejnovější dostupný.
resourceUri	string (uri)	Identifikátor URI prostředku služby AI.

AIServicesVisionVectorizer

Objekt

Určuje parametry AI Services Vision pro vektorizaci obrázku nebo textu dotazu.

Name	Typ	Description
aiServicesVisionParameters	AIServicesVisionParameters	Obsahuje parametry specifické pro vektorizaci vkládání AI Services Vision.
kind	string: aiServicesVision	Název druhu metody vektorizace, která je konfigurována pro použití s vektorovým vyhledáváním.
name	string	Název, který má být spojen s touto konkrétní metodou vektorizace.

AMLParameters

Objekt

Určuje vlastnosti pro připojení k vektorizátoru AML.

Name	Typ	Description
key	string	(Vyžadováno pro ověření klíče) Klíč ke službě AML.
modelName	AIFoundryModelCatalogName	Název modelu vkládání z katalogu Azure AI Foundry, který je nasazený v poskytnutém koncovém bodu.
region	string	(Volitelné pro ověřování pomocí tokenu). Oblast, ve které je služba AML nasazena.
resourceId	string	(Vyžadováno pro ověření tokenem). ID prostředku Azure Resource Manager služby AML. Měl by být ve formátu subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/services/{service_name}.
timeout	string (duration)	(Volitelné) Pokud je tato možnost zadána, označuje časový limit pro klienta http, který provádí volání rozhraní API.
uri	string (uri)	(Vyžadováno bez ověření nebo ověření klíče) Hodnoticí identifikátor URI služby AML, do které bude datová část JSON odeslána. Je povoleno pouze schéma https URI.

AMLVectorizer

Objekt

Určuje koncový bod Azure Machine Learning nasazený prostřednictvím katalogu modelů Azure AI Foundry pro generování vektorového vkládání řetězce dotazu.

Name	Typ	Description
amlParameters	AMLParameters	Určuje vlastnosti vektorizátoru AML.
kind	string: aml	Název druhu metody vektorizace, která je konfigurována pro použití s vektorovým vyhledáváním.
name	string	Název, který má být spojen s touto konkrétní metodou vektorizace.

AzureActiveDirectoryApplicationCredentials

Objekt

Přihlašovací údaje registrované aplikace vytvořené pro vaši vyhledávací službu, která se používá pro ověřený přístup k šifrovacím klíčům uloženým v Azure Key Vault.

Name	Typ	Description
applicationId	string	ID aplikace AAD, kterému byla udělena požadovaná přístupová oprávnění k 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.
applicationSecret	string	Ověřovací klíč zadané aplikace AAD.

AzureBlobKnowledgeSource

Objekt

Konfigurace pro zdroj znalostí Azure Blob Storage.

Name	Typ	Description
@odata.etag	string	Značka ETag agenta.
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íč se používá k poskytnutí další úrovně šifrování neaktivních uložených dat pro definici agenta, když chcete mít plnou jistotu, že je nikdo, ani Microsoft, nemůže dešifrovat. Jakmile definici agenta zašifrujete, 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 změnit, pokud chcete šifrovací klíč otočit; Definice agenta nebude ovlivněna. Š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	Description
chatCompletionModel	KnowledgeAgentModel: KnowledgeAgentAzureOpenAIModel	Volitelný model doplňování chatu pro verbalizaci obrázků nebo extrakci kontextu.
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í.
disableImageVerbalization	boolean	Označuje, zda má být verbalizace obrazu vypnutá.
embeddingModel	VectorSearchVectorizer: AIServicesVisionVectorizer AMLVectorizer AzureOpenAIVectorizer WebApiVectorizer	Volitelná konfigurace vektorizátoru pro vektorizaci obsahu.
folderPath	string	Volitelná cesta ke složce v rámci kontejneru.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Explicitní identita, která se má použít pro tento zdroj znalostí.
ingestionSchedule	IndexingSchedule	Volitelný plán pro příjem dat.

AzureOpenAIEmbeddingSkill

Objekt

Umožňuje vygenerovat vektorové vložení pro daný textový vstup pomocí prostředku Azure OpenAI.

Name	Typ	Description
@odata.type	string: #Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill	Fragment identifikátoru URI určující typ dovednosti.
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í.
context	string	Představuje úroveň, na které probíhají operace, jako je kořen dokumentu nebo obsah dokumentu (například /document nebo /document/content). Výchozí hodnota je /document.
deploymentId	string	ID nasazení modelu Azure OpenAI na určeném zdroji.
description	string	Popis dovednosti, který popisuje vstupy, výstupy a použití dovednosti.
dimensions	integer (int32)	Početdimenzích Podporováno pouze v modelech pro vkládání textu-3 a novějších.
inputs	InputFieldMappingEntry[]	Vstupy dovedností mohou být sloupec ve zdrojové datové sadě nebo výstup nadřazené dovednosti.
modelName	AzureOpenAIModelName	Název modelu vkládání, který je nasazen na zadané cestě deploymentId.
name	string	Název dovednosti, který ji v sadě dovedností jednoznačně identifikuje. Dovednost, která nemá definovaný žádný název, bude mít v poli dovedností výchozí název indexu založeného na hodnotě 1, kterému předchází znak #.
outputs	OutputFieldMappingEntry[]	Výstupem dovednosti je buď pole ve vyhledávacím indexu, nebo hodnota, která může být zpracována jako vstup jinou dovedností.
resourceUri	string (uri)	Identifikátor URI prostředku Azure OpenAI.

AzureOpenAIModelName

Výčet

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

Hodnota	Description
text-embedding-ada-002
text-embedding-3-large
text-embedding-3-small
gpt-4o
gpt-4o-mini
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano

AzureOpenAIParameters

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 na určeném zdroji.
modelName	AzureOpenAIModelName	Název modelu vkládání, který je nasazen na zadané cestě deploymentId.
resourceUri	string (uri)	Identifikátor URI prostředku Azure OpenAI.

AzureOpenAIVectorizer

Objekt

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

Name	Typ	Description
azureOpenAIParameters	AzureOpenAIParameters: AzureOpenAIEmbeddingSkill	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.
name	string	Název, který má být spojen s touto konkrétní metodou vektorizace.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

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.

InputFieldMappingEntry

Objekt

Mapování vstupního pole pro dovednost.

Name	Typ	Description
inputs	InputFieldMappingEntry[]	Rekurzivní vstupy používané při vytváření komplexního typu.
name	string	Název vstupu.
source	string	Zdroj vstupu.
sourceContext	string	Zdrojový kontext používaný pro výběr rekurzivních vstupů.

KnowledgeAgentAzureOpenAIModel

Objekt

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

Name	Typ	Description
azureOpenAIParameters	AzureOpenAIParameters: AzureOpenAIEmbeddingSkill	Obsahuje parametry specifické pro koncový bod modelu Azure OpenAI.
kind	string: azureOpenAI	Typ modelu AI.

KnowledgeAgentModelKind

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.

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í.

OutputFieldMappingEntry

Objekt

Mapování výstupního pole pro dovednost.

Name	Typ	Description
name	string	Název výstupu definovaného dovedností.
targetName	string	Cílový název výstupu. Je to volitelné a výchozí název.

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.
userAssignedIdentity	string	Plně kvalifikované ID prostředku Azure spravované identity přiřazené uživatelem obvykle ve formátu "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId", které by mělo být přiřazeno vyhledávací službě.

SearchIndexKnowledgeSource

Objekt

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

Name	Typ	Description
@odata.etag	string	Značka ETag agenta.
description	string	Volitelný uživatelsky definovaný popis.
encryptionKey	SearchResourceEncryptionKey	Popis šifrovacího klíče, který vytvoříte v Azure Key Vault. Tento klíč se používá k poskytnutí další úrovně šifrování neaktivních uložených dat pro definici agenta, když chcete mít plnou jistotu, že je nikdo, ani Microsoft, nemůže dešifrovat. Jakmile definici agenta zašifrujete, 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 změnit, pokud chcete šifrovací klíč otočit; Definice agenta nebude ovlivněna. Š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
searchIndexName	string	Název indexu vyhledávání.
sourceDataSelect	string	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	Description
accessCredentials	AzureActiveDirectoryApplicationCredentials	Volitelné přihlašovací údaje Azure Active Directory používané pro přístup k Azure Key Vault. Není vyžadováno, pokud místo toho používáte spravovanou identitu.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Explicitní spravovaná identita, která se má použít pro tento šifrovací klíč. Pokud není zadán a vlastnost přístupových přihlašovacích údajů má hodnotu null, použije se spravovaná identita přiřazená systémem. Pokud při aktualizaci prostředku není explicitní identita určena, zůstane nezměněna. Pokud je zadáno "none", hodnota této vlastnosti je vymazána.
keyVaultKeyName	string	Název vašeho klíče Azure Key Vault, který se má použít k šifrování neaktivních uložených dat.
keyVaultKeyVersion	string	Verze klíče Azure Key Vault, která se má použít k šifrování neaktivních uložených dat.
keyVaultUri	string	Identifikátor URI vašeho 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`.

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	Vygenerujte vkládání pomocí vlastního webového koncového bodu v době dotazu.
aiServicesVision	Generujte vkládání pro obrázek nebo textový vstup v době dotazu pomocí rozhraní API Vision Vectorize služeb Azure AI.
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.

WebApiParameters

Objekt

Určuje vlastnosti pro připojení k uživatelsky definovanému vektorizátoru.

Name	Typ	Description
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Spravovaná identita přiřazená uživatelem používaná pro odchozí připojení. Pokud je zadán authResourceId a není zadaný, použije se spravovaná identita přiřazená systémem. Pokud při aktualizacích indexeru není identita určena, hodnota zůstane nezměněna. Pokud je nastavena na "none", hodnota této vlastnosti je vymazána.
authResourceId	string	Platí pro vlastní koncové body, které se připojují k externímu kódu ve funkci Azure nebo jiné aplikaci, která poskytuje transformace. Tato hodnota by měla být ID aplikace vytvořené pro funkci nebo aplikaci při registraci v Azure Active Directory. Pokud je tato možnost zadaná, vektorizace se připojí k funkci nebo aplikaci pomocí spravovaného ID (buď systémového, nebo přiřazeného uživatelem) vyhledávací služby a přístupového tokenu funkce nebo aplikace, přičemž tato hodnota se použije jako ID prostředku pro vytvoření oboru přístupového tokenu.
httpHeaders	object	Hlavičky potřebné k vytvoření požadavku HTTP.
httpMethod	string	Metoda pro požadavek HTTP.
timeout	string (duration)	Požadovaný časový limit požadavku. Výchozí hodnota je 30 sekund.
uri	string (uri)	Identifikátor URI webového rozhraní API, které poskytuje vektorizátor.

WebApiVectorizer

Objekt

Určuje uživatelem definovaný vektorizátor pro generování vektorového vkládání řetězce dotazu. Integrace externího vektorizátoru se provádí pomocí vlastního rozhraní webového rozhraní API sady dovedností.

Name	Typ	Description
customWebApiParameters	WebApiParameters	Určuje vlastnosti uživatelem definovaného vektorizátoru.
kind	string: customWebApi	Název druhu metody vektorizace, která je konfigurována pro použití s vektorovým vyhledáváním.
name	string	Název, který má být spojen s touto konkrétní metodou vektorizace.