Redefinir habilidades (API REST de versão prévia)
Aplica-se a: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
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.
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 novo conteúdo 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 de 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 | Obrigatórios. Defina isso como o nome exclusivo definido pelo usuário do serviço de pesquisa. |
| nome do conjunto de habilidades | Obrigatórios. O URI de solicitação especifica o nome do conjunto de habilidades a ser redefinido. |
| api-version | Obrigatórios. A versão prévia atual é 2023-07-01-Preview. Confira 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 necessários e opcionais
| Campos | Descrição |
|---|---|
| Tipo de conteúdo | Obrigatórios. Defina-o 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 api-key cabeçalho definido como sua chave de administrador (em vez de uma chave de consulta). Confira Conectar-se ao Azure AI Search usando a 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 sem Conteúdo para uma resposta bem-sucedida.