AI工具参数校验：required与additionalProperties

为AI工具定义JSON Schema时，properties描述已有字段怎样校验，并不自动要求字段出现。需要必填就写required，需要拒绝未知字段则配置additionalProperties；三者承担不同职责。

浅色主题概念配图，选自本站AI生成图库；非事件现场或产品实测截图。

先用一个没有副作用的查询参数做练习

自拟工具只有query字段，要求它是非空字符串，不接受其他字段。Schema采用2020-12草案。下面代码需在隔离Python环境安装jsonschema包；本站已用该包运行这些断言，没有调用真实工具。

from jsonschema import Draft202012Validator

schema = {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {"query": {"type": "string", "minLength": 1}},
    "required": ["query"],
    "additionalProperties": False,
}
Draft202012Validator.check_schema(schema)
v = Draft202012Validator(schema)
assert v.is_valid({"query": "CSV"})
assert not v.is_valid({})
assert not v.is_valid({"query": ""})
assert not v.is_valid({"query": None})
assert not v.is_valid({"query": "CSV", "debug": True})
print("five cases passed")