Knowledge Sources - Create

Cria uma nova fonte de conhecimento.

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

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
path True

string

A URL do ponto de extremidade do serviço de pesquisa.

api-version
query True

string

Versão da API do cliente.

Cabeçalho do Pedido

Name Necessário Tipo Description
x-ms-client-request-id

string (uuid)

O ID de rastreamento enviado com a solicitação para ajudar com a depuração.

Corpo do Pedido

O corpo de pedido pode ser um dos seguintes:

Name Description
AzureBlobKnowledgeSource

Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.

SearchIndexKnowledgeSource

Fonte de conhecimento direcionada a um índice de pesquisa.

AzureBlobKnowledgeSource

Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.

Name Necessário Tipo Description
azureBlobParameters True

AzureBlobKnowledgeSourceParameters

O tipo de fonte de conhecimento.

kind True string:

azureBlob

O tipo de fonte de conhecimento.

name True

string

O nome da fonte de conhecimento.

@odata.etag

string

O ETag do agente.

description

string

Descrição opcional definida pelo usuário.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Cofre de Chaves do Azure. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de agente quando você quiser garantia total de que ninguém, nem mesmo a Microsoft, pode descriptografá-los. Depois de ter criptografado sua definição de agente, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como null. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de agente não será afetada. A criptografia com chaves gerenciadas pelo cliente não está disponível para serviços de pesquisa gratuitos e só está disponível para serviços pagos criados em ou após 1º de janeiro de 2019.

SearchIndexKnowledgeSource

Fonte de conhecimento direcionada a um índice de pesquisa.

Name Necessário Tipo Description
kind True string:

searchIndex

O tipo de fonte de conhecimento.

name True

string

O nome da fonte de conhecimento.

searchIndexParameters True

SearchIndexKnowledgeSourceParameters

Os parâmetros para a fonte de conhecimento.

@odata.etag

string

O ETag do agente.

description

string

Descrição opcional definida pelo usuário.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Cofre de Chaves do Azure. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de agente quando você quiser garantia total de que ninguém, nem mesmo a Microsoft, pode descriptografá-los. Depois de ter criptografado sua definição de agente, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como null. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de agente não será afetada. A criptografia com chaves gerenciadas pelo cliente não está disponível para serviços de pesquisa gratuitos e só está disponível para serviços pagos criados em ou após 1º de janeiro de 2019.

Respostas

Name Tipo Description
201 Created KnowledgeSource:

Criou com sucesso uma fonte de conhecimento

Other Status Codes

ErrorResponse

Resposta de erro.

Exemplos

SearchServiceCreateKnowledgeSource
SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSource

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
AIFoundryModelCatalogName

O nome do modelo de incorporação do Catálogo do Azure AI Foundry que será chamado.

AIServicesVisionParameters

Especifica os parâmetros do AI Services Vision para vetorizar uma imagem ou texto de consulta.

AIServicesVisionVectorizer

Especifica os parâmetros do AI Services Vision para vetorizar uma imagem ou texto de consulta.

AMLParameters

Especifica as propriedades para conexão a um vetorizador AML.

AMLVectorizer

Especifica um ponto de extremidade do Azure Machine Learning implantado por meio do Catálogo de Modelo do Azure AI Foundry para gerar a incorporação vetorial de uma cadeia de caracteres de consulta.

AzureActiveDirectoryApplicationCredentials

Credenciais de um aplicativo registrado criado para seu serviço de pesquisa, usado para acesso autenticado às chaves de criptografia armazenadas no Cofre de Chaves do Azure.

AzureBlobKnowledgeSource

Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.

AzureBlobKnowledgeSourceParameters

Parâmetros para a fonte de conhecimento do Armazenamento de Blobs do Azure.

AzureOpenAIEmbeddingSkill

Permite gerar uma incorporação vetorial para uma determinada entrada de texto usando o recurso Azure OpenAI.

AzureOpenAIModelName

O nome do modelo de IA aberta do Azure que será chamado.

AzureOpenAIParameters

Especifica os parâmetros para se conectar ao recurso OpenAI do Azure.

AzureOpenAIVectorizer

Especifica o recurso do Azure OpenAI usado para vetorizar uma cadeia de caracteres de consulta.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

IndexingSchedule

Representa uma agenda para a execução do indexador.

InputFieldMappingEntry

Mapeamento de campo de entrada para uma habilidade.

KnowledgeAgentAzureOpenAIModel

Especifica o recurso OpenAI do Azure usado para fazer o planejamento de consultas.

KnowledgeAgentModelKind

O modelo de IA a ser usado para o planejamento de consultas.

KnowledgeSourceKind

O tipo de fonte de conhecimento.

OutputFieldMappingEntry

Mapeamento de campo de saída para uma habilidade.

SearchIndexerDataNoneIdentity

Limpa a propriedade identity de uma fonte de dados.

SearchIndexerDataUserAssignedIdentity

Especifica a identidade a ser usada por uma fonte de dados.

SearchIndexKnowledgeSource

Fonte de conhecimento direcionada a um índice de pesquisa.

SearchIndexKnowledgeSourceParameters

Parâmetros para a fonte de conhecimento do índice de pesquisa.

SearchResourceEncryptionKey

Uma chave de criptografia gerenciada pelo cliente no Cofre de Chaves do Azure. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso, como índices e mapas de sinônimos.

VectorSearchVectorizerKind

O método de vetorização a ser usado durante o tempo de consulta.

WebApiParameters

Especifica as propriedades para conexão a um vetorizador definido pelo usuário.

WebApiVectorizer

Especifica um vetorizador definido pelo usuário para gerar a incorporação vetorial de uma cadeia de caracteres de consulta. A integração de um vetorizador externo é obtida usando a interface personalizada da API Web de um conjunto de habilidades.

AIFoundryModelCatalogName

O nome do modelo de incorporação do Catálogo do Azure AI Foundry que será chamado.

Valor 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 incorpora o modelo v4 para gerar incorporações a partir de texto e imagens.

AIServicesVisionParameters

Especifica os parâmetros do AI Services Vision para vetorizar uma imagem ou texto de consulta.

Name Tipo Description
apiKey

string

Chave de API do recurso designado AI Services.

authIdentity SearchIndexerDataIdentity:

A identidade gerenciada atribuída pelo usuário usada para conexões de saída. Se um authResourceId for fornecido e não for especificado, a identidade gerenciada atribuída ao sistema será usada. Nas atualizações do índice, se a identidade não for especificada, o valor permanecerá inalterado. Se definido como "nenhum", o valor dessa propriedade será limpo.

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço AI Services Vision. O padrão será o mais recente disponível quando não especificado.

resourceUri

string (uri)

O URI do recurso Serviços de IA.

AIServicesVisionVectorizer

Especifica os parâmetros do AI Services Vision para vetorizar uma imagem ou texto de consulta.

Name Tipo Description
aiServicesVisionParameters

AIServicesVisionParameters

Contém os parâmetros específicos para a vetorização de incorporação do AI Services Vision.

kind string:

aiServicesVision

O nome do tipo de método de vetorização que está sendo configurado para uso com a pesquisa vetorial.

name

string

O nome a ser associado a esse método de vetorização específico.

AMLParameters

Especifica as propriedades para conexão a um vetorizador AML.

Name Tipo Description
key

string

(Necessário para autenticação de chave) A chave para o serviço AML.

modelName

AIFoundryModelCatalogName

O nome do modelo de incorporação do Catálogo do Azure AI Foundry que é implantado no ponto de extremidade fornecido.

region

string

(Opcional para autenticação de token). A região em que o serviço AML está implantado.

resourceId

string

(Necessário para autenticação de token). A ID de recurso do Azure Resource Manager do serviço AML. Deve estar no formato subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/services/{service_name}.

timeout

string (duration)

(Opcional) Quando especificado, indica o tempo limite para o cliente http que faz a chamada de API.

uri

string (uri)

(Necessário para nenhuma autenticação ou autenticação de chave) O URI de pontuação do serviço AML para o qual a carga JSON será enviada. Somente o esquema de URI https é permitido.

AMLVectorizer

Especifica um ponto de extremidade do Azure Machine Learning implantado por meio do Catálogo de Modelo do Azure AI Foundry para gerar a incorporação vetorial de uma cadeia de caracteres de consulta.

Name Tipo Description
amlParameters

AMLParameters

Especifica as propriedades do vetorizador AML.

kind string:

aml

O nome do tipo de método de vetorização que está sendo configurado para uso com a pesquisa vetorial.

name

string

O nome a ser associado a esse método de vetorização específico.

AzureActiveDirectoryApplicationCredentials

Credenciais de um aplicativo registrado criado para seu serviço de pesquisa, usado para acesso autenticado às chaves de criptografia armazenadas no Cofre de Chaves do Azure.

Name Tipo Description
applicationId

string

Uma ID de Aplicativo AAD que recebeu as permissões de acesso necessárias ao Cofre da Chave do Azure que deve ser usada ao criptografar seus dados em repouso. A ID do aplicativo não deve ser confundida com a ID do objeto do seu aplicativo AAD.

applicationSecret

string

A chave de autenticação do aplicativo AAD especificado.

AzureBlobKnowledgeSource

Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.

Name Tipo Description
@odata.etag

string

O ETag do agente.

azureBlobParameters

AzureBlobKnowledgeSourceParameters

O tipo de fonte de conhecimento.

description

string

Descrição opcional definida pelo usuário.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Cofre de Chaves do Azure. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de agente quando você quiser garantia total de que ninguém, nem mesmo a Microsoft, pode descriptografá-los. Depois de ter criptografado sua definição de agente, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como null. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de agente não será afetada. A criptografia com chaves gerenciadas pelo cliente não está disponível para serviços de pesquisa gratuitos e só está disponível para serviços pagos criados em ou após 1º de janeiro de 2019.

kind string:

azureBlob

O tipo de fonte de conhecimento.

name

string

O nome da fonte de conhecimento.

AzureBlobKnowledgeSourceParameters

Parâmetros para a fonte de conhecimento do Armazenamento de Blobs do Azure.

Name Tipo Description
chatCompletionModel KnowledgeAgentModel:

KnowledgeAgentAzureOpenAIModel

Modelo opcional de conclusão de chat para verbalização de imagem ou extração de contexto.

connectionString

string

Cadeia de conexão baseada em chave ou o formato ResourceId se estiver usando uma identidade gerenciada.

containerName

string

O nome do contêiner de armazenamento de blob.

createdResources

object

Recursos criados pela fonte de conhecimento.

disableImageVerbalization

boolean

Indica se a verbalização da imagem deve ser desativada.

embeddingModel VectorSearchVectorizer:

Configuração opcional do vetorizador para vetorização de conteúdo.

folderPath

string

Caminho de pasta opcional dentro do contêiner.

identity SearchIndexerDataIdentity:

Uma identidade explícita a ser usada para essa fonte de conhecimento.

ingestionSchedule

IndexingSchedule

Horário opcional para ingestão de dados.

AzureOpenAIEmbeddingSkill

Permite gerar uma incorporação vetorial para uma determinada entrada de texto usando o recurso Azure OpenAI.

Name Tipo Description
@odata.type string:

#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill

Um fragmento de URI especificando o tipo de habilidade.

apiKey

string

Chave de API do recurso OpenAI do Azure designado.

authIdentity SearchIndexerDataIdentity:

A identidade gerenciada atribuída pelo usuário usada para conexões de saída.

context

string

Representa o nível no qual as operações ocorrem, como a raiz do documento ou o conteúdo do documento (por exemplo, /document ou /document/content). O padrão é /document.

deploymentId

string

ID da implantação do modelo OpenAI do Azure no recurso designado.

description

string

A descrição da habilidade que descreve as entradas, saídas e uso da habilidade.

dimensions

integer (int32)

O número de dimensões que as incorporações de saída resultantes devem ter. Suportado apenas em text-embedding-3 e modelos posteriores.

inputs

InputFieldMappingEntry[]

As entradas das habilidades podem ser uma coluna no conjunto de dados de origem ou a saída de uma habilidade a montante.

modelName

AzureOpenAIModelName

O nome do modelo de incorporação implantado no caminho deploymentId fornecido.

name

string

O nome da habilidade que a identifica exclusivamente dentro do conjunto de habilidades. Uma habilidade sem nome definido receberá um nome padrão de seu índice baseado em 1 na matriz de habilidades, prefixada com o caractere '#'.

outputs

OutputFieldMappingEntry[]

A saída de uma habilidade é um campo em um índice de pesquisa ou um valor que pode ser consumido como uma entrada por outra habilidade.

resourceUri

string (uri)

O URI do recurso Azure OpenAI.

AzureOpenAIModelName

O nome do modelo de IA aberta do Azure que será chamado.

Valor 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

Especifica os parâmetros para se conectar ao recurso OpenAI do Azure.

Name Tipo Description
apiKey

string

Chave de API do recurso OpenAI do Azure designado.

authIdentity SearchIndexerDataIdentity:

A identidade gerenciada atribuída pelo usuário usada para conexões de saída.

deploymentId

string

ID da implantação do modelo OpenAI do Azure no recurso designado.

modelName

AzureOpenAIModelName

O nome do modelo de incorporação implantado no caminho deploymentId fornecido.

resourceUri

string (uri)

O URI do recurso Azure OpenAI.

AzureOpenAIVectorizer

Especifica o recurso do Azure OpenAI usado para vetorizar uma cadeia de caracteres de consulta.

Name Tipo Description
azureOpenAIParameters AzureOpenAIParameters:

AzureOpenAIEmbeddingSkill

Contém os parâmetros específicos para a vetorização de incorporação do Azure OpenAI.

kind string:

azureOpenAI

O nome do tipo de método de vetorização que está sendo configurado para uso com a pesquisa vetorial.

name

string

O nome a ser associado a esse método de vetorização específico.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

IndexingSchedule

Representa uma agenda para a execução do indexador.

Name Tipo Description
interval

string (duration)

O intervalo de tempo entre as execuções do indexador.

startTime

string (date-time)

A hora em que um indexador deve começar a ser executado.

InputFieldMappingEntry

Mapeamento de campo de entrada para uma habilidade.

Name Tipo Description
inputs

InputFieldMappingEntry[]

As entradas recursivas usadas ao criar um tipo complexo.

name

string

O nome da entrada.

source

string

A fonte da entrada.

sourceContext

string

O contexto de origem usado para selecionar entradas recursivas.

KnowledgeAgentAzureOpenAIModel

Especifica o recurso OpenAI do Azure usado para fazer o planejamento de consultas.

Name Tipo Description
azureOpenAIParameters AzureOpenAIParameters:

AzureOpenAIEmbeddingSkill

Contém os parâmetros específicos para o ponto de extremidade do modelo OpenAI do Azure.

kind string:

azureOpenAI

O tipo de modelo de IA.

KnowledgeAgentModelKind

O modelo de IA a ser usado para o planejamento de consultas.

Valor Description
azureOpenAI

Use modelos de IA aberta do Azure para planejamento de consultas.

KnowledgeSourceKind

O tipo de fonte de conhecimento.

Valor Description
searchIndex

Uma fonte de conhecimento que lê dados de um índice de pesquisa.

azureBlob

Uma fonte de conhecimento que lê e ingere dados do Armazenamento de Blobs do Azure para um Índice de Pesquisa.

OutputFieldMappingEntry

Mapeamento de campo de saída para uma habilidade.

Name Tipo Description
name

string

O nome da saída definida pela habilidade.

targetName

string

O nome de destino da saída. É opcional e padrão para nomear.

SearchIndexerDataNoneIdentity

Limpa a propriedade identity de uma fonte de dados.

Name Tipo Description
@odata.type string:

#Microsoft.Azure.Search.DataNoneIdentity

Um fragmento de URI especificando o tipo de identidade.

SearchIndexerDataUserAssignedIdentity

Especifica a identidade a ser usada por uma fonte de dados.

Name Tipo Description
@odata.type string:

#Microsoft.Azure.Search.DataUserAssignedIdentity

Um fragmento de URI especificando o tipo de identidade.

userAssignedIdentity

string

A ID de recurso do Azure totalmente qualificada de uma identidade gerenciada atribuída ao usuário normalmente no formato "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" que deveria ter sido atribuída ao serviço de pesquisa.

SearchIndexKnowledgeSource

Fonte de conhecimento direcionada a um índice de pesquisa.

Name Tipo Description
@odata.etag

string

O ETag do agente.

description

string

Descrição opcional definida pelo usuário.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Cofre de Chaves do Azure. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de agente quando você quiser garantia total de que ninguém, nem mesmo a Microsoft, pode descriptografá-los. Depois de ter criptografado sua definição de agente, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como null. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de agente não será afetada. A criptografia com chaves gerenciadas pelo cliente não está disponível para serviços de pesquisa gratuitos e só está disponível para serviços pagos criados em ou após 1º de janeiro de 2019.

kind string:

searchIndex

O tipo de fonte de conhecimento.

name

string

O nome da fonte de conhecimento.

searchIndexParameters

SearchIndexKnowledgeSourceParameters

Os parâmetros para a fonte de conhecimento.

SearchIndexKnowledgeSourceParameters

Parâmetros para a fonte de conhecimento do índice de pesquisa.

Name Tipo Description
searchIndexName

string

O nome do índice de pesquisa.

sourceDataSelect

string

Usado para solicitar campos adicionais para dados de origem referenciados.

SearchResourceEncryptionKey

Uma chave de criptografia gerenciada pelo cliente no Cofre de Chaves do Azure. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso, como índices e mapas de sinônimos.

Name Tipo Description
accessCredentials

AzureActiveDirectoryApplicationCredentials

Credenciais opcionais do Azure Ative Directory usadas para acessar seu Cofre da Chave do Azure. Não é necessário se estiver usando a identidade gerenciada.

identity SearchIndexerDataIdentity:

Uma identidade gerenciada explícita a ser usada para essa chave de criptografia. Se não for especificado e a propriedade de credenciais de acesso for nula, a identidade gerenciada atribuída ao sistema será usada. Na atualização do recurso, se a identidade explícita não for especificada, ela permanecerá inalterada. Se "nenhum" for especificado, o valor dessa propriedade será limpo.

keyVaultKeyName

string

O nome da sua chave do Cofre da Chave do Azure a ser usada para criptografar seus dados em repouso.

keyVaultKeyVersion

string

A versão da chave do Cofre da Chave do Azure a ser usada para criptografar seus dados em repouso.

keyVaultUri

string

O URI do seu Cofre da Chave do Azure, também conhecido como nome DNS, que contém a chave a ser usada para criptografar seus dados em repouso. Um exemplo de URI pode ser https://my-keyvault-name.vault.azure.net.

VectorSearchVectorizerKind

O método de vetorização a ser usado durante o tempo de consulta.

Valor Description
azureOpenAI

Gere incorporações usando um recurso do Azure OpenAI no momento da consulta.

customWebApi

Gere incorporações usando um ponto de extremidade da Web personalizado no momento da consulta.

aiServicesVision

Gere incorporações para uma entrada de imagem ou texto no momento da consulta usando a API de Vetorização de Visão dos Serviços de IA do Azure.

aml

Gere incorporações usando um ponto de extremidade do Azure Machine Learning implantado por meio do Catálogo de Modelo do Azure AI Foundry no momento da consulta.

WebApiParameters

Especifica as propriedades para conexão a um vetorizador definido pelo usuário.

Name Tipo Description
authIdentity SearchIndexerDataIdentity:

A identidade gerenciada atribuída pelo usuário usada para conexões de saída. Se um authResourceId for fornecido e não for especificado, a identidade gerenciada atribuída ao sistema será usada. Nas atualizações do indexador, se a identidade não for especificada, o valor permanecerá inalterado. Se definido como "nenhum", o valor dessa propriedade será limpo.

authResourceId

string

Aplica-se a pontos de extremidade personalizados que se conectam a código externo em uma função do Azure ou em algum outro aplicativo que fornece as transformações. Esse valor deve ser a ID do aplicativo criada para a função ou aplicativo quando ela foi registrada no Azure Ative Directory. Quando especificado, a vetorização se conecta à função ou aplicativo usando uma ID gerenciada (atribuída pelo sistema ou pelo usuário) do serviço de pesquisa e o token de acesso da função ou aplicativo, usando esse valor como a id do recurso para criar o escopo do token de acesso.

httpHeaders

object

Os cabeçalhos necessários para fazer a solicitação HTTP.

httpMethod

string

O método para a solicitação HTTP.

timeout

string (duration)

O tempo limite desejado para a solicitação. O padrão é 30 segundos.

uri

string (uri)

O URI da API Web que fornece o vetorizador.

WebApiVectorizer

Especifica um vetorizador definido pelo usuário para gerar a incorporação vetorial de uma cadeia de caracteres de consulta. A integração de um vetorizador externo é obtida usando a interface personalizada da API Web de um conjunto de habilidades.

Name Tipo Description
customWebApiParameters

WebApiParameters

Especifica as propriedades do vetorizador definido pelo usuário.

kind string:

customWebApi

O nome do tipo de método de vetorização que está sendo configurado para uso com a pesquisa vetorial.

name

string

O nome a ser associado a esse método de vetorização específico.