定義自訂技能結構描述

已完成

您的自訂技能必須針對 Azure AI 搜尋服務技能集中技能所預期的輸入和輸出資料，執行預期的結構描述。

輸入結構描述

自訂技能的輸入結構描述定義了 JSON 結構，而其中包含了每份待處理文件的紀錄。 每份文件都擁有唯一識別碼，以及具有一項或多項輸入的資料承載，如下所示：

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

輸出結構描述

自訂技能所傳回結果的結構描述會反映輸入架構。 假設輸出會納入每個輸入記錄的記錄，其中包含技能產生的結果，或是任何所發生錯誤的詳細資料。

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

此結構描述中的輸出值為可以包含任何 JSON 結構的屬性包，反映了索引欄位不一定都是簡單的資料值，其實也能包含複雜類型。