Réinitialiser les compétences (API REST en préversion)

  • Article

s’applique à: 2023-07-01-Preview. Cette version n’est plus prise en charge. mettre à niveau immédiatement vers une version plus récente.

Important

2023-07-01-Preview (aucune modification).

2021-04-30-Preview (aucune modification).

2020-06-30-Preview ajoute l’API. Il prend en charge enrichissements mis en cache et scénarios de réinitialisation.

La Réinitialiser les compétences demande traite de manière sélective une ou plusieurs compétences lors de l’exécution de l’indexeur suivant. Pour les indexeurs qui ont activé la mise en cache, vous pouvez demander explicitement le traitement des mises à jour des compétences que l’indexeur ne peut pas détecter. Par exemple, si vous apportez des modifications externes, telles que des révisions à une compétence personnalisée, vous pouvez utiliser cette API pour réexécuter la compétence. Les sorties, telles qu’une base de connaissances ou un index de recherche, sont actualisées à l’aide de données réutilisables à partir du cache et du nouveau contenu conformément à la compétence mise à jour.

Vous pouvez réinitialiser un ensemble de compétences existant à l’aide d’une requête HTTP POST, en spécifiant le nom de l’ensemble de compétences à mettre à jour sur l’URI de la requête.

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

Paramètres d’URI

Paramètre Description
nom du service Obligatoire. Définissez cette valeur sur le nom unique défini par l’utilisateur de votre service de recherche.
nom de l’ensemble de compétences Obligatoire. L’URI de requête spécifie le nom de l’ensemble de compétences à réinitialiser.
api-version Obligatoire. Consultez versions de l’API pour plus de versions.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.

Champs Description
Type de contenu Obligatoire. Définissez cette valeur sur application/json
api-key Facultatif si vous utilisez rôles Azure et qu’un jeton du porteur est fourni sur la demande, sinon une clé est requise. Une clé API est une chaîne unique générée par le système qui authentifie la requête auprès de votre service de recherche. Les demandes de réinitialisation doivent inclure un en-tête api-key défini sur votre clé d’administration (par opposition à une clé de requête). Pour plus d’informations, consultez Se connecter à Azure AI Search à l’aide de l’authentification par clé.

Corps de la demande

Le corps de la requête est un tableau de noms de compétences.

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

Réponse

Code d’état : 204 Aucun contenu pour une réponse réussie.

Voir aussi