Aggiungere una competenza personalizzata

Completato

Per integrare una competenza personalizzata nella soluzione di indicizzazione, è necessario aggiungere una competenza a un set di competenze usando il tipo di competenza Custom.WebApiSkill.

La definizione della competenza deve:

• Specificare l'URI dell'endpoint dell'API Web, inclusi i parametri e le intestazioni, se necessario.
• Impostare il contesto per specificare in quale punto della gerarchia del documento è necessario eseguire la chiamata alla competenza.
• Assegnare i valori di input, in genere dai campi esistenti del documento.
• Archiviare l'output in un nuovo campo, specificando facoltativamente il nome del campo di destinazione (in caso contrario, viene usato il nome dell'output).

{
    "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>"
          }
        ]
      }
  ]
}

Il set di competenze può includere competenze predefinite e competenze personalizzate, a seconda del caso d'uso. La matrice skills illustrata nell'esempio precedente conterrà tutte le competenze, con il codice di competenze personalizzato in esecuzione all'esterno del servizio di ricerca (come applicabile) che verrà illustrato nell'esercizio più avanti in questo modulo.

Le unità seguenti esplorano tipi specifici di competenze personalizzate tramite l'uso di risorse di Azure aggiuntive.