Definir o esquema de habilidades personalizado

Concluído

Sua habilidade personalizada deve implementar o esquema esperado para dados de entrada e saída que são esperados pelas habilidades em um conjunto de habilidades do Azure AI Search.

Esquema de entrada

O esquema de entrada para uma habilidade personalizada define uma estrutura JSON contendo um registro para cada documento a ser processado. Cada documento tem um identificador exclusivo e uma carga útil de dados com uma ou mais entradas, como esta:

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

Esquema de saída

O esquema para os resultados retornados por sua habilidade personalizada reflete o esquema de entrada. Supõe-se que a saída contenha um registro para cada registro de entrada, com os resultados produzidos pela habilidade ou detalhes de quaisquer erros que ocorreram.

{
    "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": [...]
      },
      ...
    ]
}

O valor de saída neste esquema é um conjunto de propriedades que pode conter qualquer estrutura JSON, refletindo o fato de que os campos de índice não são necessariamente valores de dados simples, mas podem conter tipos complexos.