Compartilhar via

Habilidades de redefinição (API REST de versão prévia)

  • Artigo

aplica-se a: 2023-07-01-Preview. Não há mais suporte para essa versão. Atualizar imediatamente para uma versão mais recente.

Importante

2023-07-01-Preview (sem alterações).

2021-04-30-Preview (sem alterações).

2020-06-30-Preview adiciona a API. Ele dá suporte a enriquecimentos armazenados em cache e cenários de redefinição de .

A solicitação Redefinir Habilidades processa seletivamente uma ou mais habilidades na próxima execução do indexador. Para indexadores que têm o cache habilitado, você pode solicitar explicitamente o processamento de atualizações de habilidades que o indexador não pode detectar. Por exemplo, se você fizer alterações externas, como revisões em uma habilidade personalizada, poderá usar essa API para executar novamente a habilidade. As saídas, como um repositório de conhecimento ou índice de pesquisa, são atualizadas usando dados reutilizáveis do cache e novos conteúdos de acordo com a habilidade atualizada.

Você pode redefinir um conjunto de habilidades existente usando um HTTP POST, especificando o nome do conjunto de habilidades a ser atualizado no URI da solicitação.

POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
    Content-Type: application/json
    api-key: [admin key]

Parâmetros de URI

Parâmetro Descrição
nome do serviço Necessário. Defina isso como o nome exclusivo definido pelo usuário do serviço de pesquisa.
Nome do conjunto de habilidades Necessário. O URI de solicitação especifica o nome do conjunto de habilidades a ser redefinido.
api-version Necessário. Consulte versões de API para obter mais versões.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Campos Descrição
Tipo de conteúdo Necessário. Defina isso como application/json
chave de api Opcional se você estiver usando funções do Azure e um token de portador for fornecido na solicitação, caso contrário, uma chave será necessária. Uma chave de api é uma cadeia de caracteres exclusiva gerada pelo sistema que autentica a solicitação para o serviço de pesquisa. As solicitações de redefinição devem incluir um cabeçalho api-key definido como sua chave de administrador (em vez de uma chave de consulta). Consulte Conectar-se ao Azure AI Search usando de autenticação de chave para obter detalhes.

Corpo da Solicitação

O corpo da solicitação é uma matriz de nomes de habilidades.

{   
    "skillNames" : ["<SKILL-1>", "SKILL-n"]
}

Resposta

Código de status: 204 Nenhum conteúdo para uma resposta bem-sucedida.

Consulte também