Definire lo schema della competenza personalizzata

Completato

La competenza personalizzata deve implementare lo schema previsto per i dati di input e di output previsti dalle competenze in un set di competenze di Azure AI Search.

Schema di input

Lo schema di input per una competenza personalizzata definisce una struttura JSON contenente un record per ogni documento da elaborare. Ogni documento ha un identificatore univoco e un payload di dati con uno o più input, come indicato di seguito:

{
    "values": [
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      {
        "recordId": "<unique_identifier>",
        "data":
           {
             "<input1_name>":  "<input1_value>",
             "<input2_name>": "<input2_value>",
             ...
           }
      },
      ...
    ]
}

Schema di output.

Lo schema per i risultati restituiti dalla competenza personalizzata rispecchia lo schema di input. Si presuppone che l'output contiene un record per ogni record di input, con i risultati generati dalla competenza o i dettagli di eventuali errori verificatisi.

{
    "values": [
      {
        "recordId": "<unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      {
        "recordId": "< unique_identifier_from_input>",
        "data":
           {
             "<output1_name>":  "<output1_value>",
              ...
           },
         "errors": [...],
         "warnings": [...]
      },
      ...
    ]
}

Il valore di output in questo schema è un contenitore delle proprietà che può includere qualsiasi struttura JSON, rispecchiando il fatto che i campi dell'indice non sono necessariamente valori di dati semplici, ma possono contenere tipi complessi.