Criar uma habilidade personalizada

Concluído

Sua habilidade personalizada deve implementar o esquema esperado para os dados de entrada e de saída esperados pelas habilidades em um conjunto de habilidades da Pesquisa de IA do Azure.

Esquema de entrada

O esquema de entrada para uma habilidade personalizada define uma estrutura JSON que contém um registro para cada documento a ser processado. Cada documento tem um identificador exclusivo e um conteúdo de dados com uma ou mais entradas, como este:

{
    "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 dos resultados retornados por uma 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 erros ocorridos.

{
    "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 nesse esquema é um recipiente de propriedades que pode conter qualquer estrutura JSON, refletindo o fato de que campos de índice não são necessariamente valores de dados simples, mas podem conter tipos complexos.