Özel beceri şemasını tanımlama

• 3 dakika

Özel becerinizin, Azure AI Search beceri kümesindeki beceriler tarafından beklenen giriş ve çıkış verileri için beklenen şemayı uygulaması gerekir.

Giriş şeması

Özel becerinin giriş şeması, işlenecek her belge için bir kayıt içeren bir JSON yapısını tanımlar. Her belgenin benzersiz bir tanımlayıcısı ve aşağıdaki gibi bir veya daha fazla giriş içeren bir veri yükü vardır:

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

Çıkış şeması

Özel beceriniz tarafından döndürülen sonuçların şeması giriş şemasını yansıtır. Çıkışın, beceri tarafından üretilen sonuçlar veya oluşan hataların ayrıntılarıyla her giriş kaydı için bir kayıt içerdiği varsayılır.

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

Bu şemadaki çıkış değeri, herhangi bir JSON yapısı içerebilen, dizin alanlarının her zaman basit veri değerleri olmadığını, ancak karmaşık türler içerebildiğini yansıtan bir özellik paketidir .