使用Text.SplitSkill时pageOverlapLength等属性报错求助

你遇到的问题核心是属性层级或模式匹配错误，以下是具体解决步骤：

• 严格遵循属性嵌套规则：pageOverlapLength和maximumPagesToTake仅在textSplitMode设置为pages时生效，且必须嵌套在技能的parameters对象内。正确的技能定义示例：

  {
    "@odata.type": "#Microsoft.Skills.Text.SplitSkill",
    "name": "page-split-skill",
    "inputs": [{"name": "text", "source": "/document/content"}],
    "outputs": [{"name": "textItems", "targetName": "splitPages"}],
    "parameters": {
      "textSplitMode": "pages",
      "pageOverlapLength": 150,
      "maximumPagesToTake": 10
    }
  }
  

  若未设置textSplitMode: "pages"就添加这两个参数，或者把它们放在parameters之外，都会触发"Unexpected properties"错误。

• 检查拼写与整体结构：确认属性名完全匹配官方定义，无拼写错误（比如把pageOverlapLength写成pageOverlap）。同时确保整个技能集JSON结构合规——所有技能必须放在skills数组中，技能集顶级不能出现不属于它的属性。

• API版本兼容性验证：你使用的2020-06-30-Preview和2023-07-01-Preview版本均支持这两个参数，版本本身不是问题，重点仍在属性层级和模式匹配。

若调整后仍报错，建议直接对照官方文档的完整技能集示例，排查是否遗漏了格式细节（如context、description等非必填但可能影响结构校验的字段）。

内容的提问来源于stack exchange，提问作者Adolfo Socorro