Het aangepaste vaardigheidsschema definiëren

Uw aangepaste vaardigheid moet het verwachte schema implementeren voor invoer- en uitvoergegevens die worden verwacht door vaardigheden in een Azure AI Search-vaardighedenset.

Invoerschema

Het invoerschema voor een aangepaste vaardigheid definieert een JSON-structuur die een record bevat voor elk document dat moet worden verwerkt. Elk document heeft een unieke identificator en een gegevenslading met een of meer invoergegevens, zoals deze:

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

Uitvoerschema

Het schema voor de resultaten die door uw aangepaste vaardigheid worden geretourneerd, weerspiegelt het invoerschema. Er wordt van uitgegaan dat de uitvoer een record bevat voor elke invoerrecord, met ofwel de resultaten die worden geproduceerd door de vaardigheid, of de details van eventuele fouten die zijn opgetreden.

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

De uitvoerwaarde in dit schema is een eigenschappenverzameling die elke JSON-structuur kan bevatten, wat het feit weergeeft dat indexvelden niet noodzakelijkerwijs eenvoudige gegevenswaarden zijn, maar complexe typen kunnen bevatten.