Ajouter une compétence personnalisée

Effectué

Pour intégrer une compétence personnalisée dans votre solution d’indexation, vous devez ajouter une compétence pour celle-ci à un ensemble de compétences à l’aide du type de compétence Custom.WebApiSkill.

La définition de compétence doit :

• Indiquer l’URI de votre point de terminaison d’API web, dont les paramètres et les en-têtes si nécessaire
• Définissez le contexte pour spécifier à quel point dans la hiérarchie de documents la compétence doit être appelée.
• Attribuez des valeurs d’entrée, généralement à partir de champs de document existants.
• Stockez la sortie dans un nouveau champ, en spécifiant éventuellement un nom de champ cible (sinon, le nom de sortie est utilisé).

{
    "skills": [
      ...,
      {
        "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
        "description": "<custom skill description>",
        "uri": "https://<web_api_endpoint>?<params>",
        "httpHeaders": {
            "<header_name>": "<header_value>"
        },
        "context": "/document/<where_to_apply_skill>",
        "inputs": [
          {
            "name": "<input1_name>",
            "source": "/document/<path_to_input_field>"
          }
        ],
        "outputs": [
          {
            "name": "<output1_name>",
            "targetName": "<optional_field_name>"
          }
        ]
      }
  ]
}

Votre ensemble de compétences peut inclure des compétences intégrées et des compétences personnalisées, en fonction de votre cas d’usage. Le tableau skills vu dans l’exemple ci-dessus contient toutes vos compétences, avec le code des compétences personnalisées exécuté en dehors du service de recherche (le cas échéant) que nous allons voir dans l’exercice plus loin de ce module.

Les unités suivantes explorent des types spécifiques de compétences personnalisées via l’utilisation de ressources Azure supplémentaires.