Definiowanie niestandardowego schematu umiejętności

Ukończone

Twoja niestandardowa umiejętność musi zaimplementować oczekiwany schemat dla danych wejściowych i wyjściowych, które są oczekiwane przez umiejętności w zestawie umiejętności usługi Azure AI Search.

Schemat wejściowy

Schemat wejściowy dla umiejętności niestandardowej definiuje strukturę JSON zawierającą rekord dla każdego dokumentu do przetworzenia. Każdy dokument ma unikatowy identyfikator i ładunek danych z co najmniej jednym wejściem, w następujący sposób:

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

Schemat danych wyjściowych

Schemat wyników zwracanych przez umiejętności niestandardowe odzwierciedla schemat wejściowy. Zakłada się, że dane wyjściowe zawierają rekord dla każdego rekordu wejściowego z wynikami wygenerowanymi przez umiejętności lub szczegółami błędów, które wystąpiły.

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

Wartość wyjściowa w tym schemacie to torba właściwości, która może zawierać dowolną strukturę JSON, odzwierciedlając fakt, że pola indeksu nie muszą być prostymi wartościami danych, ale mogą zawierać typy złożone.