Skillsets - Create Or Update

Cria um novo conjunto de habilidades em um serviço de pesquisa ou atualiza o conjunto de habilidades se ele já existir.

PUT {endpoint}/skillsets('{skillsetName}')?api-version=2023-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string

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

skillsetName
path True

string

O nome do conjunto de habilidades a ser criado ou atualizado.

api-version
query True

string

Versão da API do cliente.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
x-ms-client-request-id

string (uuid)

A ID de acompanhamento enviada com a solicitação para ajudar na depuração.

If-Match

string

Define a condição de If-Match. A operação será executada somente se a ETag no servidor corresponder a esse valor.

If-None-Match

string

Define a condição If-None-Match. A operação será executada somente se a ETag no servidor não corresponder a esse valor.

Prefer True

string

Para solicitações HTTP PUT, instrui o serviço a retornar o recurso criado/atualizado com êxito.

Corpo da solicitação

Nome Obrigatório Tipo Description
name True

string

O nome do conjunto de habilidades.

skills True SearchIndexerSkill[]:

Uma lista de habilidades no conjunto de habilidades.

@odata.etag

string

A ETag do conjunto de habilidades.

cognitiveServices CognitiveServicesAccount:

Detalhes sobre o serviço de IA do Azure a ser usado ao executar habilidades.

description

string

A descrição do conjunto de habilidades.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Azure Key Vault. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de conjunto de habilidades quando você quiser ter total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografar sua definição de conjunto de habilidades. Depois de criptografar sua definição de conjunto de habilidades, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como nula. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de conjunto de habilidades 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 1º de janeiro de 2019 ou depois de 1º de janeiro de 2019.

knowledgeStore

SearchIndexerKnowledgeStore

Definição de projeções adicionais para blob, tabela ou arquivos do Azure de dados enriquecidos.

Respostas

Nome Tipo Description
200 OK

SearchIndexerSkillset

O conjunto de habilidades é atualizado com êxito.

201 Created

SearchIndexerSkillset

O conjunto de habilidades é criado com êxito.

Other Status Codes

SearchError

Resposta de erro.

Exemplos

SearchServiceCreateOrUpdateSkillset

Solicitação de exemplo

PUT https://myservice.search.windows.net/skillsets('demoskillset')?api-version=2023-11-01


{
  "name": "demoskillset",
  "description": "Extract entities, detect language and extract key-phrases",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "categories": [
        "organization"
      ],
      "defaultLanguageCode": "en",
      "minimumPrecision": 0.7,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "organizations"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "textSplitMode": "pages",
      "maximumPageLength": 4000,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "MyCustomWebApiSkill",
      "uri": "https://contoso.example.org",
      "httpMethod": "POST",
      "timeout": "PT30S",
      "batchSize": 1,
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ],
      "httpHeaders": {}
    }
  ],
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": null
  }
}

Resposta de exemplo

{
  "name": "demoskillset",
  "description": "Extract entities, detect language and extract key-phrases",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "name": "#1",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "organizations"
        }
      ],
      "categories": [
        "organization"
      ],
      "defaultLanguageCode": "en",
      "minimumPrecision": 0.7
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "#2",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "name": "#3",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ],
      "defaultLanguageCode": null,
      "textSplitMode": "pages",
      "maximumPageLength": 4000
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "name": "#4",
      "description": null,
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ],
      "defaultLanguageCode": null,
      "maxKeyPhraseCount": null
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "MyCustomWebApiSkill",
      "description": null,
      "context": "/document",
      "uri": "https://contoso.example.org",
      "httpMethod": "POST",
      "timeout": "PT30S",
      "batchSize": 1,
      "degreeOfParallelism": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ],
      "httpHeaders": {}
    }
  ],
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": null
  }
}
{
  "name": "demoskillset",
  "description": "Extract entities, detect language and extract key-phrases",
  "skills": [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "name": "#1",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "organizations"
        }
      ],
      "categories": [
        "organization"
      ],
      "defaultLanguageCode": "en",
      "minimumPrecision": 0.7
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
      "name": "#2",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "languageCode",
          "targetName": "languageCode"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
      "name": "#3",
      "description": null,
      "context": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "textItems",
          "targetName": "pages"
        }
      ],
      "defaultLanguageCode": null,
      "textSplitMode": "pages",
      "maximumPageLength": 4000
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
      "name": "#4",
      "description": null,
      "context": "/document/pages/*",
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "keyPhrases",
          "targetName": "keyPhrases"
        }
      ],
      "defaultLanguageCode": null,
      "maxKeyPhraseCount": null
    },
    {
      "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
      "name": "MyCustomWebApiSkill",
      "description": null,
      "context": "/document",
      "uri": "https://contoso.example.org",
      "httpMethod": "POST",
      "timeout": "PT30S",
      "batchSize": 1,
      "degreeOfParallelism": null,
      "inputs": [
        {
          "name": "text",
          "source": "/document/pages/*"
        },
        {
          "name": "languageCode",
          "source": "/document/languageCode"
        }
      ],
      "outputs": [
        {
          "name": "customresult",
          "targetName": "result"
        }
      ],
      "httpHeaders": {}
    }
  ],
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": null
  }
}

Definições

Nome Description
AzureActiveDirectoryApplicationCredentials

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

CognitiveServicesAccountKey

Um recurso de serviço de IA do Azure provisionado com uma chave anexada a um conjunto de habilidades.

ConditionalSkill

Uma habilidade que permite cenários que exigem uma operação booliana para determinar os dados a serem atribuídos a uma saída.

CustomEntity

Um objeto que contém informações sobre as correspondências que foram encontradas e metadados relacionados.

CustomEntityAlias

Um objeto complexo que pode ser usado para especificar ortografias ou sinônimos alternativos para o nome da entidade raiz.

CustomEntityLookupSkill

Uma habilidade procura texto de uma lista personalizada definida pelo usuário de palavras e frases.

CustomEntityLookupSkillLanguage

Os códigos de idioma com suporte para texto de entrada por CustomEntityLookupSkill.

DefaultCognitiveServicesAccount

Um objeto vazio que representa o recurso de serviço de IA do Azure padrão para um conjunto de habilidades.

DocumentExtractionSkill

Uma habilidade que extrai conteúdo de um arquivo dentro do pipeline de enriquecimento.

EntityCategory

Uma cadeia de caracteres que indica quais categorias de entidade devem ser retornadas.

EntityLinkingSkill

Usando a API de Análise de Texto, extrai entidades vinculadas do texto.

EntityRecognitionSkill

Reconhecimento de entidade de análise de texto.

EntityRecognitionSkillLanguage

Os códigos de idioma compatíveis com o texto de entrada por EntityRecognitionSkill.

EntityRecognitionSkillV3

Usando a API de Análise de Texto, extrai entidades de diferentes tipos do texto.

ImageAnalysisSkill

Uma habilidade que analisa arquivos de imagem. Ele extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem.

ImageAnalysisSkillLanguage

Os códigos de idioma com suporte para entrada por ImageAnalysisSkill.

ImageDetail

Uma cadeia de caracteres que indica quais detalhes específicos do domínio devem ser retornados.

InputFieldMappingEntry

Mapeamento de campo de entrada para uma habilidade.

KeyPhraseExtractionSkill

Uma habilidade que usa a análise de texto para extração de frases-chave.

KeyPhraseExtractionSkillLanguage

Os códigos de idioma com suporte para texto de entrada por KeyPhraseExtractionSkill.

LanguageDetectionSkill

Uma habilidade que detecta o idioma do texto de entrada e relata um único código de idioma para cada documento enviado na solicitação. O código de idioma é emparelhado com uma pontuação que indica a confiança da análise.

MergeSkill

Uma habilidade para mesclar duas ou mais cadeias de caracteres em uma única cadeia de caracteres unificada, com um delimitador opcional definido pelo usuário separando cada parte do componente.

OcrSkill

Uma habilidade que extrai texto de arquivos de imagem.

OcrSkillLanguage

Os códigos de idioma com suporte para entrada pelo OcrSkill.

OutputFieldMappingEntry

Mapeamento de campo de saída para uma habilidade.

PIIDetectionSkill

Usando a API de Análise de Texto, extrai informações pessoais de um texto de entrada e oferece a opção de mascara-la.

PIIDetectionSkillMaskingMode

Uma cadeia de caracteres que indica qual maskingMode usar para mascarar as informações pessoais detectadas no texto de entrada.

SearchError

Descreve uma condição de erro para a API.

SearchIndexerKnowledgeStore

Definição de projeções adicionais para blob, tabela ou arquivos do Azure de dados enriquecidos.

SearchIndexerKnowledgeStoreFileProjectionSelector

Definição de projeção para quais dados armazenar nos Arquivos do Azure.

SearchIndexerKnowledgeStoreObjectProjectionSelector

Definição de projeção para quais dados armazenar no Blob do Azure.

SearchIndexerKnowledgeStoreProjection

Objeto de contêiner para vários seletores de projeção.

SearchIndexerKnowledgeStoreTableProjectionSelector

Descrição de quais dados armazenar nas Tabelas do Azure.

SearchIndexerSkillset

Uma lista de habilidades.

SearchResourceEncryptionKey

Uma chave de criptografia gerenciada pelo cliente no Azure Key Vault. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso em seu serviço de pesquisa, como índices e mapas de sinônimos.

SentimentSkill

Análise de sentimento positivo-negativo da análise de texto, pontuada como um valor de ponto flutuante em um intervalo de zero a 1.

SentimentSkillLanguage

Os códigos de idioma com suporte para texto de entrada pelo SentimentSkill.

SentimentSkillV3

Usando a API de Análise de Texto, avalia o texto não estruturado e, para cada registro, fornece rótulos de sentimento (como "negativo", "neutro" e "positivo") com base na pontuação de confiança mais alta encontrada pelo serviço em uma frase e no nível do documento.

ShaperSkill

Uma habilidade para remodelar as saídas. Ele cria um tipo complexo para dar suporte a campos compostos (também conhecidos como campos de várias partes).

SplitSkill

Uma habilidade para dividir uma cadeia de caracteres em partes de texto.

SplitSkillLanguage

Os códigos de idioma compatíveis com o texto de entrada por SplitSkill.

TextSplitMode

Um valor que indica qual modo de divisão executar.

TextTranslationSkill

Uma habilidade para traduzir texto de um idioma para outro.

TextTranslationSkillLanguage

Os códigos de idioma com suporte para texto de entrada por TextTranslationSkill.

VisualFeature

As cadeias de caracteres que indicam quais tipos de recursos visuais devem ser retornados.

WebApiSkill

Uma habilidade que pode chamar um ponto de extremidade de API Web, permitindo que você estenda um conjunto de habilidades fazendo com que ele chame seu código personalizado.

AzureActiveDirectoryApplicationCredentials

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

Nome Tipo Description
applicationId

string

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

applicationSecret

string

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

CognitiveServicesAccountKey

Um recurso de serviço de IA do Azure provisionado com uma chave anexada a um conjunto de habilidades.

Nome Tipo Description
@odata.type string:

#Microsoft.Azure.Search.CognitiveServicesByKey

Um fragmento de URI que especifica o tipo de recurso de serviço de IA do Azure anexado a um conjunto de habilidades.

description

string

Descrição do recurso de serviço de IA do Azure anexado a um conjunto de habilidades.

key

string

A chave usada para provisionar o recurso de serviço de IA do Azure anexado a um conjunto de habilidades.

ConditionalSkill

Uma habilidade que permite cenários que exigem uma operação booliana para determinar os dados a serem atribuídos a uma saída.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Util.ConditionalSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

description

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

CustomEntity

Um objeto que contém informações sobre as correspondências que foram encontradas e metadados relacionados.

Nome Tipo Description
accentSensitive

boolean

O padrão é false. Valor booliano que indica se as comparações com o nome da entidade devem ser sensíveis ao acento.

aliases

CustomEntityAlias[]

Uma matriz de objetos complexos que podem ser usados para especificar ortografias ou sinônimos alternativos para o nome da entidade raiz.

caseSensitive

boolean

O padrão é false. Valor booliano que indica se as comparações com o nome da entidade devem ser sensíveis à caixa de caracteres. Correspondências sem diferenciação de maiúsculas de minúsculas de "Microsoft" podem ser: microsoft, microSoft, MICROSOFT.

defaultAccentSensitive

boolean

Altera o valor de confidencialidade de ênfase padrão para essa entidade. Ele será usado para alterar o valor padrão de todos os valores aliases accentSensitive.

defaultCaseSensitive

boolean

Altera o valor de confidencialidade de maiúsculas e minúsculas padrão para essa entidade. Ele será usado para alterar o valor padrão de todos os valores caseSensitive de aliases.

defaultFuzzyEditDistance

integer (int32)

Altera o valor de distância de edição difusa padrão para essa entidade. Ele pode ser usado para alterar o valor padrão de todos os valores de aliases fuzzyEditDistance.

description

string

Esse campo pode ser usado como uma passagem para metadados personalizados sobre os textos correspondentes. O valor desse campo será exibido com cada correspondência de sua entidade na saída da habilidade.

fuzzyEditDistance

integer (int32)

O valor padrão é 0. Valor máximo de 5. Indica o número aceitável de caracteres divergentes que ainda constituiria uma correspondência com o nome da entidade. A menor confusão possível para qualquer correspondência é retornada. Por exemplo, se a distância de edição for definida como 3, "Windows10" ainda corresponderá a "Windows", "Windows10" e "Windows 7". Quando a confidencialidade de maiúsculas e minúsculas é definida como false, as diferenças de maiúsculas e minúsculas NÃO contam para a tolerância à difusa, mas o contrário.

id

string

Esse campo pode ser usado como uma passagem para metadados personalizados sobre os textos correspondentes. O valor desse campo será exibido com cada correspondência de sua entidade na saída da habilidade.

name

string

O descritor de entidade de nível superior. As correspondências na saída da habilidade serão agrupadas por esse nome e devem representar a forma "normalizada" do texto que está sendo encontrado.

subtype

string

Esse campo pode ser usado como uma passagem para metadados personalizados sobre os textos correspondentes. O valor desse campo será exibido com cada correspondência de sua entidade na saída da habilidade.

type

string

Esse campo pode ser usado como uma passagem para metadados personalizados sobre os textos correspondentes. O valor desse campo será exibido com cada correspondência de sua entidade na saída da habilidade.

CustomEntityAlias

Um objeto complexo que pode ser usado para especificar ortografias ou sinônimos alternativos para o nome da entidade raiz.

Nome Tipo Description
accentSensitive

boolean

Determine se o alias é sensível ao acento.

caseSensitive

boolean

Determine se o alias diferencia maiúsculas de minúsculas.

fuzzyEditDistance

integer (int32)

Determine a distância de edição difusa do alias.

text

string

O texto do alias.

CustomEntityLookupSkill

Uma habilidade procura texto de uma lista personalizada definida pelo usuário de palavras e frases.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.CustomEntityLookupSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

CustomEntityLookupSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

entitiesDefinitionUri

string

Caminho para um arquivo JSON ou CSV que contém todo o texto de destino com o qual corresponder. Essa definição de entidade é lida no início de uma execução do indexador. Todas as atualizações para esse arquivo durante uma execução do indexador não entrarão em vigor até as execuções subsequentes. Essa configuração deve estar acessível por HTTPS.

globalDefaultAccentSensitive

boolean

Um sinalizador global para AccentSensitive. Se AccentSensitive não estiver definido em CustomEntity, esse valor será o valor padrão.

globalDefaultCaseSensitive

boolean

Um sinalizador global para CaseSensitive. Se CaseSensitive não estiver definido em CustomEntity, esse valor será o valor padrão.

globalDefaultFuzzyEditDistance

integer (int32)

Um sinalizador global para FuzzyEditDistance. Se FuzzyEditDistance não estiver definido em CustomEntity, esse valor será o valor padrão.

inlineEntitiesDefinition

CustomEntity[]

A definição de Entidade Personalizada embutida.

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

CustomEntityLookupSkillLanguage

Os códigos de idioma com suporte para texto de entrada por CustomEntityLookupSkill.

Valor Description
da

Dinamarquês

de

Alemão

en

Inglês

es

Espanhol

fi

Finlandês

fr

Francês

it

Italiano

ko

Coreano

pt

Português

DefaultCognitiveServicesAccount

Um objeto vazio que representa o recurso de serviço de IA do Azure padrão para um conjunto de habilidades.

Nome Tipo Description
@odata.type string:

#Microsoft.Azure.Search.DefaultCognitiveServices

Um fragmento de URI que especifica o tipo de recurso de serviço de IA do Azure anexado a um conjunto de habilidades.

description

string

Descrição do recurso de serviço de IA do Azure anexado a um conjunto de habilidades.

DocumentExtractionSkill

Uma habilidade que extrai conteúdo de um arquivo dentro do pipeline de enriquecimento.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Util.DocumentExtractionSkill

Um fragmento de URI que especifica o tipo de habilidade.

configuration

object

Um dicionário de configurações para a habilidade.

context

string

Representa o nível em que 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.

dataToExtract

string

O tipo de dados a serem extraídos para a habilidade. Será definido como 'contentAndMetadata' se não for definido.

description

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

parsingMode

string

O parsingMode para a habilidade. Será definido como "padrão" se não for definido.

EntityCategory

Uma cadeia de caracteres que indica quais categorias de entidade devem ser retornadas.

Valor Description
location

Entidades que descrevem um local físico.

organization

Entidades que descrevem uma organização.

person

Entidades que descrevem uma pessoa.

quantity

Entidades que descrevem uma quantidade.

datetime

Entidades que descrevem uma data e hora.

url

Entidades que descrevem uma URL.

email

Entidades que descrevem um endereço de email.

EntityLinkingSkill

Usando a API de Análise de Texto, extrai entidades vinculadas do texto.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.V3.EntityLinkingSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

string

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

inputs

InputFieldMappingEntry[]

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

minimumPrecision

number (double)

minimum: 0
maximum: 1

Um valor entre 0 e 1 que será usado apenas para incluir entidades cuja pontuação de confiança é maior que o valor especificado. Se não for definido (padrão) ou se definido explicitamente como nulo, todas as entidades serão incluídas.

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

EntityRecognitionSkill

Reconhecimento de entidade de análise de texto.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.EntityRecognitionSkill

Um fragmento de URI que especifica o tipo de habilidade.

categories

EntityCategory[]

Uma lista de categorias de entidade que devem ser extraídas.

context

string

Representa o nível em que 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.

defaultLanguageCode

EntityRecognitionSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

includeTypelessEntities

boolean

Determina se as entidades são conhecidas ou não, mas não estão em conformidade com um tipo predefinido. Se essa configuração não estiver definida (padrão), definida como nula ou definida como false, as entidades que não estão em conformidade com um dos tipos predefinidos não serão exibidas.

inputs

InputFieldMappingEntry[]

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

minimumPrecision

number (double)

Um valor entre 0 e 1 que será usado apenas para incluir entidades cuja pontuação de confiança é maior que o valor especificado. Se não for definido (padrão) ou se definido explicitamente como nulo, todas as entidades serão incluídas.

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, prefixado 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 entrada por outra habilidade.

EntityRecognitionSkillLanguage

Os códigos de idioma compatíveis com o texto de entrada por EntityRecognitionSkill.

Valor Description
ar

Árabe

cs

Tcheco

zh-Hans

Chinês-simplificado

zh-Hant

Chinese-Traditional

da

Dinamarquês

nl

Holandês

en

Inglês

fi

Finlandês

fr

Francês

de

Alemão

el

Grego

hu

Húngaro

it

Italiano

ja

Japonês

ko

Coreano

no

Norueguês (Bokmaal)

pl

Polonês

pt-PT

Português (Portugal)

pt-BR

Português (Brasil)

ru

Russo

es

Espanhol

sv

Sueco

tr

Turco

EntityRecognitionSkillV3

Usando a API de Análise de Texto, extrai entidades de diferentes tipos do texto.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.V3.EntityRecognitionSkill

Um fragmento de URI que especifica o tipo de habilidade.

categories

string[]

Uma lista de categorias de entidade que devem ser extraídas.

context

string

Representa o nível em que 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.

defaultLanguageCode

string

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

inputs

InputFieldMappingEntry[]

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

minimumPrecision

number (double)

minimum: 0
maximum: 1

Um valor entre 0 e 1 que será usado apenas para incluir entidades cuja pontuação de confiança é maior que o valor especificado. Se não for definido (padrão) ou se definido explicitamente como nulo, todas as entidades serão incluídas.

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

ImageAnalysisSkill

Uma habilidade que analisa arquivos de imagem. Ele extrai um conjunto avançado de recursos visuais com base no conteúdo da imagem.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Vision.ImageAnalysisSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

ImageAnalysisSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

details

ImageDetail[]

Uma cadeia de caracteres que indica quais detalhes específicos do domínio devem ser retornados.

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

visualFeatures

VisualFeature[]

Uma lista de recursos visuais.

ImageAnalysisSkillLanguage

Os códigos de idioma com suporte para entrada por ImageAnalysisSkill.

Valor Description
ar

Árabe

az

Azerbaijano

bg

Búlgaro

bs

Latim bósnio

ca

Catalão

cs

Tcheco

cy

Galês

da

Dinamarquês

de

Alemão

el

Grego

en

Inglês

es

Espanhol

et

Estoniano

eu

Basque

fi

Finlandês

fr

Francês

ga

Irlandês

gl

Galego

he

Hebraico

hi

Hindi

hr

Croata

hu

Húngaro

id

Indonésio

it

Italiano

ja

Japonês

kk

Cazaque

ko

Coreano

lt

Lituano

lv

Letão

mk

Macedónio

ms

Malásia malaia

nb

Norueguês (Bokmal)

nl

Holandês

pl

Polonês

prs

Dari

pt-BR

Português – Brasil

pt

Portuguese-Portugal

pt-PT

Portuguese-Portugal

ro

Romeno

ru

Russo

sk

Eslovaco

sl

Esloveno

sr-Cyrl

Sérvio - RS cirílico

sr-Latn

Sérvio - RS latino

sv

Sueco

th

Tailandês

tr

Turco

uk

Ucraniano

vi

Vietnamita

zh

Chinês simplificado

zh-Hans

Chinês simplificado

zh-Hant

Chinês tradicional

ImageDetail

Uma cadeia de caracteres que indica quais detalhes específicos do domínio devem ser retornados.

Valor Description
celebrities

Detalhes reconhecidos como celebridades.

landmarks

Detalhes reconhecidos como pontos de referência.

InputFieldMappingEntry

Mapeamento de campo de entrada para uma habilidade.

Nome Tipo Description
inputs

InputFieldMappingEntry[]

As entradas recursivas usadas ao criar um tipo complexo.

name

string

O nome da entrada.

source

string

A origem da entrada.

sourceContext

string

O contexto de origem usado para selecionar entradas recursivas.

KeyPhraseExtractionSkill

Uma habilidade que usa a análise de texto para extração de frases-chave.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.KeyPhraseExtractionSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

KeyPhraseExtractionSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

inputs

InputFieldMappingEntry[]

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

maxKeyPhraseCount

integer (int32)

Um número que indica quantas frases-chave devem ser retornadas. Se ausente, todas as frases-chave identificadas serão retornadas.

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

KeyPhraseExtractionSkillLanguage

Os códigos de idioma com suporte para texto de entrada por KeyPhraseExtractionSkill.

Valor Description
da

Dinamarquês

nl

Holandês

en

Inglês

fi

Finlandês

fr

Francês

de

Alemão

it

Italiano

ja

Japonês

ko

Coreano

no

Norueguês (Bokmaal)

pl

Polonês

pt-PT

Português (Portugal)

pt-BR

Português (Brasil)

ru

Russo

es

Espanhol

sv

Sueco

LanguageDetectionSkill

Uma habilidade que detecta o idioma do texto de entrada e relata um único código de idioma para cada documento enviado na solicitação. O código de idioma é emparelhado com uma pontuação que indica a confiança da análise.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.LanguageDetectionSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultCountryHint

string

Um código de país a ser usado como uma dica para o modelo de detecção de idioma se ele não puder desambiguar o idioma.

description

string

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

inputs

InputFieldMappingEntry[]

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

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

MergeSkill

Uma habilidade para mesclar duas ou mais cadeias de caracteres em uma única cadeia de caracteres unificada, com um delimitador opcional definido pelo usuário separando cada parte do componente.

Nome Tipo Valor padrão Description
@odata.type string:

#Microsoft.Skills.Text.MergeSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

description

string

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

inputs

InputFieldMappingEntry[]

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

insertPostTag

string

A marca indica o final do texto mesclado. Por padrão, a marca é um espaço vazio.

insertPreTag

string

A marca indica o início do texto mesclado. Por padrão, a marca é um espaço vazio.

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, prefixado 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 entrada por outra habilidade.

OcrSkill

Uma habilidade que extrai texto de arquivos de imagem.

Nome Tipo Valor padrão Description
@odata.type string:

#Microsoft.Skills.Vision.OcrSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

OcrSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

detectOrientation

boolean

False

Um valor que indica ativar ou não a detecção de orientação. O padrão é false.

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

OcrSkillLanguage

Os códigos de idioma com suporte para entrada pelo OcrSkill.

Valor Description
af

africâner

sq

Albanês

anp

Angika (Devanagiri)

ar

Árabe

ast

Asturiano

awa

Awadhi-Hindi (Devanagiri)

az

Azerbaijano (alfabeto latino)

bfy

Bagheli

eu

Basque

be

Bielorrusso (cirílico e latino)

be-cyrl

Bielorrusso (cirílico)

be-latn

Bielorrusso (latino)

bho

Bhojpuri-Hindi (Devanagiri)

bi

Bislama

brx

Bodo (Devanagiri)

bs

Latim bósnio

bra

Brajbha

br

Bretão

bg

Búlgaro

bns

Bundeli

bua

Buryat (cirílico)

ca

Catalão

ceb

Cebuano

rab

Chamling

ch

Chamorro

hne

Chhattisgarhi (Devanagiri)

zh-Hans

Chinês simplificado

zh-Hant

Chinês tradicional

kw

Córnico

co

Corso

crh

Tártaro da Criméia (latino)

hr

Croata

cs

Tcheco

da

Dinamarquês

prs

Dari

dhi

Dhimal (Devanagiri)

doi

Dogri (Devanagiri)

nl

Holandês

en

Inglês

myv

Erzya (cirílico)

et

Estoniano

fo

Faroês

fj

Fijiano

fil

Filipino

fi

Finlandês

fr

Francês

fur

Frulian

gag

Gagauz (latino)

gl

Galego

de

Alemão

gil

Gilbertese

gon

Gondi (Devanagiri)

el

Grego

kl

Gronelandês

gvr

Gurung (Devanagiri)

ht

Crioulo haitiano

hlb

Halbi (Devanagiri)

hni

Hani

bgc

Haryanvi

haw

Havaiano

hi

Hindi

mww

Hmong Daw (latino)

hoc

Ho (Devanagiri)

hu

Húngaro

is

Islandês

smn

Inari Sami

id

Indonésio

ia

Interlíngua

iu

Inuktitut (Latim)

ga

Irlandês

it

Italiano

ja

Japonês

Jns

Jaunsari (Devanagiri)

jv

Javanês

kea

Kabuverdianu

kac

Kachin (latino)

xnr

Kangri (Devanagiri)

krc

Karachay-Balkar

kaa-cyrl

Kara-Kalpak (cirílico)

kaa

Kara-Kalpak (latino)

csb

Cassúbio

kk-cyrl

Cazaque (Cirílico)

kk-latn

Cazaque (latino)

klr

Khaling

kha

Khasi

quc

K'iche'

ko

Coreano

kfq

Korku

kpy

Koryak

kos

Kosraano

kum

Kumyk (cirílico)

ku-arab

Curdo (árabe)

ku-latn

Curdo (latino)

kru

Kurukh (Devanagiri)

ky

Quirguistão (cirílico)

lkt

Dacota

la

Latim

lt

Lituano

dsb

Baixo sorábio

smj

Lule Sami

lb

Luxemburguês

bfz

Mahasu Pahari (Devanagiri)

ms

Malaio (latino)

mt

Maltês

kmj

Malto (Devanagiri)

gv

Manx

mi

Maori

mr

Maráthi

mn

Mongol (cirílico)

cnr-cyrl

Montenegrino (cirílico)

cnr-latn

Montenegrino (latino)

nap

Napolitano

ne

Nepalês

niu

Niuean

nog

Nogay

sme

Sami do Norte (Latino)

nb

Norueguês

no

Norueguês

oc

Occitano

os

Ossético

ps

Pashto

fa

Persa

pl

Polonês

pt

Português

pa

Punjabi (árabe)

ksh

Ripuário

ro

Romeno

rm

Romanche

ru

Russo

sck

Sadri (Devanagiri)

sm

Samoano (latino)

sa

Sânscrito (Devanagiri)

sat

Santali (Devanagiri)

sco

Scots

gd

Gaélico escocês

sr

Sérvio (latino)

sr-Cyrl

Sérvio (Cirílico)

sr-Latn

Sérvio (latino)

xsr

Sherpa (Devanagiri)

srx

Sirmauri (Devanagiri)

sms

Skolt Sami

sk

Eslovaco

sl

Esloveno

so

Somali (árabe)

sma

Sami do Sul

es

Espanhol

sw

Swahili (latino)

sv

Sueco

tg

Tajique (cirílico)

tt

Tártaro (latino)

tet

Tétum

thf

Thangmi

to

Tonga

tr

Turco

tk

Turcomenos (latino)

tyv

Tuvan

hsb

Alto Sorábio

ur

Urdu

ug

Uigure (árabe)

uz-arab

Uzbeque (árabe)

uz-cyrl

Uzbeque (Cirílico)

uz

Uzbeque (Latino)

vo

Volapuque

wae

Walser

cy

Galês

fy

Frísia Ocidental

yua

Maia Iucateque

za

Zhuang

zu

Zulu

unk

Desconhecido (Todos)

OutputFieldMappingEntry

Mapeamento de campo de saída para uma habilidade.

Nome Tipo Description
name

string

O nome da saída definida pela habilidade.

targetName

string

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

PIIDetectionSkill

Usando a API de Análise de Texto, extrai informações pessoais de um texto de entrada e oferece a opção de mascara-la.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.PIIDetectionSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

string

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

domain

string

Se especificado, definirá o domínio PII para incluir apenas um subconjunto das categorias de entidade. Os valores possíveis incluem: 'phi', 'none'. O padrão é 'none'.

inputs

InputFieldMappingEntry[]

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

maskingCharacter

string

maxLength: 1

O caractere usado para mascarar o texto se o parâmetro maskingMode estiver definido para substituir. O padrão é *.

maskingMode

PIIDetectionSkillMaskingMode

Um parâmetro que fornece várias maneiras de mascarar as informações pessoais detectadas no texto de entrada. O padrão é 'none'.

minimumPrecision

number (double)

minimum: 0
maximum: 1

Um valor entre 0 e 1 que será usado apenas para incluir entidades cuja pontuação de confiança é maior que o valor especificado. Se não for definido (padrão) ou se definido explicitamente como nulo, todas as entidades serão incluídas.

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

piiCategories

string[]

Uma lista de categorias de entidade pii que devem ser extraídas e mascaradas.

PIIDetectionSkillMaskingMode

Uma cadeia de caracteres que indica qual maskingMode usar para mascarar as informações pessoais detectadas no texto de entrada.

Valor Description
none

Nenhuma máscara ocorre e a saída maskedText não será retornada.

replace

Substitui as entidades detectadas pelo caractere dado no parâmetro maskingCharacter. O caractere será repetido até o comprimento da entidade detectada para que os deslocamentos correspondam corretamente ao texto de entrada, bem como ao maskedText de saída.

SearchError

Descreve uma condição de erro para a API.

Nome Tipo Description
code

string

Um de um conjunto definido pelo servidor de códigos de erro.

details

SearchError[]

Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.

message

string

Uma representação legível pelo ser humano do erro.

SearchIndexerKnowledgeStore

Definição de projeções adicionais para blob, tabela ou arquivos do Azure de dados enriquecidos.

Nome Tipo Description
projections

SearchIndexerKnowledgeStoreProjection[]

Uma lista de projeções adicionais a serem executadas durante a indexação.

storageConnectionString

string

A cadeia de conexão para as projeções da conta de armazenamento será armazenada.

SearchIndexerKnowledgeStoreFileProjectionSelector

Definição de projeção para quais dados armazenar nos Arquivos do Azure.

Nome Tipo Description
generatedKeyName

string

Nome da chave gerada na qual armazenar a projeção.

inputs

InputFieldMappingEntry[]

Entradas aninhadas para projeções complexas.

referenceKeyName

string

Nome da chave de referência para projeção diferente.

source

string

Dados de origem para projeto.

sourceContext

string

Contexto de origem para projeções complexas.

storageContainer

string

Contêiner de blob no qual armazenar projeções.

SearchIndexerKnowledgeStoreObjectProjectionSelector

Definição de projeção para quais dados armazenar no Blob do Azure.

Nome Tipo Description
generatedKeyName

string

Nome da chave gerada na qual armazenar a projeção.

inputs

InputFieldMappingEntry[]

Entradas aninhadas para projeções complexas.

referenceKeyName

string

Nome da chave de referência para projeção diferente.

source

string

Dados de origem para projeto.

sourceContext

string

Contexto de origem para projeções complexas.

storageContainer

string

Contêiner de blob no qual armazenar projeções.

SearchIndexerKnowledgeStoreProjection

Objeto de contêiner para vários seletores de projeção.

Nome Tipo Description
files

SearchIndexerKnowledgeStoreFileProjectionSelector[]

Projeções para o Armazenamento de Arquivos do Azure.

objects

SearchIndexerKnowledgeStoreObjectProjectionSelector[]

Projeções para o Armazenamento de Blobs do Azure.

tables

SearchIndexerKnowledgeStoreTableProjectionSelector[]

Projeções para o Armazenamento de Tabelas do Azure.

SearchIndexerKnowledgeStoreTableProjectionSelector

Descrição de quais dados armazenar nas Tabelas do Azure.

Nome Tipo Description
generatedKeyName

string

Nome da chave gerada na qual armazenar a projeção.

inputs

InputFieldMappingEntry[]

Entradas aninhadas para projeções complexas.

referenceKeyName

string

Nome da chave de referência para projeção diferente.

source

string

Dados de origem para projeto.

sourceContext

string

Contexto de origem para projeções complexas.

tableName

string

Nome da tabela do Azure na qual os dados projetados serão armazenados.

SearchIndexerSkillset

Uma lista de habilidades.

Nome Tipo Description
@odata.etag

string

A ETag do conjunto de habilidades.

cognitiveServices CognitiveServicesAccount:

Detalhes sobre o serviço de IA do Azure a ser usado ao executar habilidades.

description

string

A descrição do conjunto de habilidades.

encryptionKey

SearchResourceEncryptionKey

Uma descrição de uma chave de criptografia que você cria no Azure Key Vault. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para sua definição de conjunto de habilidades quando você quiser ter total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografar sua definição de conjunto de habilidades. Depois de criptografar sua definição de conjunto de habilidades, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como nula. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; Sua definição de conjunto de habilidades 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 1º de janeiro de 2019 ou depois de 1º de janeiro de 2019.

knowledgeStore

SearchIndexerKnowledgeStore

Definição de projeções adicionais para blob, tabela ou arquivos do Azure de dados enriquecidos.

name

string

O nome do conjunto de habilidades.

skills SearchIndexerSkill[]:

Uma lista de habilidades no conjunto de habilidades.

SearchResourceEncryptionKey

Uma chave de criptografia gerenciada pelo cliente no Azure Key Vault. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso em seu serviço de pesquisa, como índices e mapas de sinônimos.

Nome Tipo Description
accessCredentials

AzureActiveDirectoryApplicationCredentials

Credenciais opcionais do Azure Active Directory usadas para acessar o Azure Key Vault. Não é necessário se estiver usando a identidade gerenciada.

keyVaultKeyName

string

O nome da chave do Azure Key Vault a ser usada para criptografar seus dados em repouso.

keyVaultKeyVersion

string

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

keyVaultUri

string

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

SentimentSkill

Análise de sentimento positivo-negativo da análise de texto, pontuada como um valor de ponto flutuante em um intervalo de zero a 1.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.SentimentSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

SentimentSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

SentimentSkillLanguage

Os códigos de idioma com suporte para texto de entrada pelo SentimentSkill.

Valor Description
da

Dinamarquês

nl

Holandês

en

Inglês

fi

Finlandês

fr

Francês

de

Alemão

el

Grego

it

Italiano

no

Norueguês (Bokmaal)

pl

Polonês

pt-PT

Português (Portugal)

ru

Russo

es

Espanhol

sv

Sueco

tr

Turco

SentimentSkillV3

Usando a API de Análise de Texto, avalia o texto não estruturado e, para cada registro, fornece rótulos de sentimento (como "negativo", "neutro" e "positivo") com base na pontuação de confiança mais alta encontrada pelo serviço em uma frase e no nível do documento.

Nome Tipo Valor padrão Description
@odata.type string:

#Microsoft.Skills.Text.V3.SentimentSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

string

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

includeOpinionMining

boolean

False

Se definido como true, a saída da habilidade incluirá informações da Análise de Texto para mineração de opinião, ou seja, destinos (substantivos ou verbos) e sua avaliação associada (adjetiva) no texto. O padrão é false.

inputs

InputFieldMappingEntry[]

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

modelVersion

string

A versão do modelo a ser usada ao chamar o serviço de Análise de Texto. Ele usará o padrão para o mais recente disponível quando não for especificado. Recomendamos que você não especifique esse valor, a menos que seja absolutamente necessário.

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, prefixado 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 entrada por outra habilidade.

ShaperSkill

Uma habilidade para remodelar as saídas. Ele cria um tipo complexo para dar suporte a campos compostos (também conhecidos como campos de várias partes).

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Util.ShaperSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

description

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

SplitSkill

Uma habilidade para dividir uma cadeia de caracteres em partes de texto.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.SplitSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultLanguageCode

SplitSkillLanguage

Um valor que indica qual código de idioma usar. O padrão é en.

description

string

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

inputs

InputFieldMappingEntry[]

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

maximumPageLength

integer (int32)

O comprimento máximo de página desejado. O padrão é 10000.

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, prefixado 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 entrada por outra habilidade.

textSplitMode

TextSplitMode

Um valor que indica qual modo de divisão executar.

SplitSkillLanguage

Os códigos de idioma compatíveis com o texto de entrada por SplitSkill.

Valor Description
am

Amárico

bs

Bósnio

cs

Tcheco

da

Dinamarquês

de

Alemão

en

Inglês

es

Espanhol

et

Estoniano

fi

Finlandês

fr

Francês

he

Hebraico

hi

Hindi

hr

Croata

hu

Húngaro

id

Indonésio

is

Islandês

it

Italiano

ja

Japonês

ko

Coreano

lv

Letão

nb

Norueguês

nl

Holandês

pl

Polonês

pt

Português (Portugal)

pt-br

Português (Brasil)

ru

Russo

sk

Eslovaco

sl

Esloveno

sr

Sérvio

sv

Sueco

tr

Turco

ur

Urdu

zh

Chinês (simplificado)

TextSplitMode

Um valor que indica qual modo de divisão executar.

Valor Description
pages

Divida o texto em páginas individuais.

sentences

Divida o texto em frases individuais.

TextTranslationSkill

Uma habilidade para traduzir texto de um idioma para outro.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Text.TranslationSkill

Um fragmento de URI que especifica o tipo de habilidade.

context

string

Representa o nível em que 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.

defaultFromLanguageCode

TextTranslationSkillLanguage

O código de idioma do qual traduzir documentos para documentos que não especificam o idioma explicitamente.

defaultToLanguageCode

TextTranslationSkillLanguage

O código de idioma para traduzir documentos para documentos que não especificam o idioma explicitamente.

description

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

suggestedFrom

TextTranslationSkillLanguage

O código de idioma para traduzir documentos de quando nem a entrada fromLanguageCode nem o parâmetro defaultFromLanguageCode são fornecidos e a detecção automática de idioma não é bem-sucedida. O padrão é en.

TextTranslationSkillLanguage

Os códigos de idioma com suporte para texto de entrada por TextTranslationSkill.

Valor Description
af

africâner

ar

Árabe

bn

Bengali

bs

Bósnio (Latino)

bg

Búlgaro

yue

Cantonês (tradicional)

ca

Catalão

zh-Hans

Chinês simplificado

zh-Hant

Chinês tradicional

hr

Croata

cs

Tcheco

da

Dinamarquês

nl

Holandês

en

Inglês

et

Estoniano

fj

Fijiano

fil

Filipino

fi

Finlandês

fr

Francês

de

Alemão

el

Grego

ht

Crioulo haitiano

he

Hebraico

hi

Hindi

mww

Hmong daw

hu

Húngaro

is

Islandês

id

Indonésio

it

Italiano

ja

Japonês

sw

Kiswahili

tlh

Klingon

ko

Coreano

lv

Letão

lt

Lituano

mg

Malgaxe

ms

Malaio

mt

Maltês

nb

Norueguês

fa

Persa

pl

Polonês

pt

Português

otq

Querétaro Otomi

ro

Romeno

ru

Russo

sm

Samoano

sr-Cyrl

Sérvio (Cirílico)

sr-Latn

Sérvio (latino)

sk

Eslovaco

sl

Esloveno

es

Espanhol

sv

Sueco

ty

Taitiano

ta

Tâmil

te

Telugu

th

Tailandês

to

Tonga

tr

Turco

uk

Ucraniano

ur

Urdu

vi

Vietnamita

cy

Galês

yua

Maia Iucateque

VisualFeature

As cadeias de caracteres que indicam quais tipos de recursos visuais devem ser retornados.

Valor Description
adult

Recursos visuais reconhecidos como pessoas adultas.

brands

Recursos visuais reconhecidos como marcas comerciais.

categories

Categorias.

description

Descrição.

faces

Recursos visuais reconhecidos como rostos de pessoas.

objects

Recursos visuais reconhecidos como objetos.

tags

Tags.

WebApiSkill

Uma habilidade que pode chamar um ponto de extremidade de API Web, permitindo que você estenda um conjunto de habilidades fazendo com que ele chame seu código personalizado.

Nome Tipo Description
@odata.type string:

#Microsoft.Skills.Custom.WebApiSkill

Um fragmento de URI que especifica o tipo de habilidade.

batchSize

integer (int32)

O tamanho do lote desejado que indica o número de documentos.

context

string

Representa o nível em que 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.

degreeOfParallelism

integer (int32)

Se definido, o número de chamadas paralelas que podem ser feitas na API Web.

description

string

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

httpHeaders

object

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

httpMethod

string

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

inputs

InputFieldMappingEntry[]

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

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, prefixado 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 entrada por outra habilidade.

timeout

string (duration)

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

uri

string

A URL da API Web.