工具要的是数量，Agent填了true为什么也能过？

一个资料整理Agent准备调用导出工具，工具要求 count 表示要导出的份数。接口描述写着“1到20的整数”，模型却填了 true。

服务端把JSON读进Python，检查“它是不是整数、是否在范围内”，两项竟然都通过。接下来，true 被当成了一份。

这是一个人为构造的工具接入案例，不是本站或某个模型的真实故障。它指向一个具体问题：工具契约中的“整数”和“布尔值”，为什么不能直接照搬Python的继承关系与相等比较来判断？

AI原创概念插画：种子店里，黄铜双凹盘分别放着两枚浅色种子，旁边是木座上的绿叶形拨杆。数量与开关并置，隐喻两种不同语义；画面不证明真实开关可操作，也不是校验机制示意。

一、JSON没有把true写成1，是接入层认错了门Copy Anchor Link

先把问题停在输入处：

{"count": true}

这是合法JSON，但合法语法不保证字段满足工具契约。JSON Schema分别定义布尔类型与数值类型；布尔类型只接受 true、false，不是所有“可以视为真或假”的值。[2]

Python却有自己的类型设计。官方文档明确说明，bool 是 int 的子类；在不少数值场景中，False、True 分别像0和1。[1] 因此，以下几个事实可以同时成立：

• JSON解析得到的仍是Python布尔值 True，没有自动变成普通整数。
• isinstance(True, int) 为真，因为它检查包含子类的关系。
• 1 <= True <= 20 也为真，因为这里进行了数值比较。
• 重新把这个未经修改的值写成JSON，仍然可以得到 true。

所以，问题不是JSON一定丢失了类型，也不是Python的继承规则有错，而是应用拿宿主语言的“属于整数家族”，替代了外部契约的“这个字段允许整数值而非布尔值”。

在Agent系统里，Harness是安排模型、工具、状态与验收的运行层。模型生成参数后，运行层与工具服务之间通常还有适配器、输入模型、默认值和转换函数。只在提示词里强调“请输入数字”，不能代替这些实际入口的验证。

二、跟做一个反例：范围没错，种类却错了Copy Anchor Link

下面用一个更窄的教学契约演示：只接受标准库JSON解析后恰为Python内建 int 的1到20，拒绝浮点表示、字符串和布尔值；开关字段只接受内建 bool。

这是一套示例应用规则，不是通用JSON Schema验证器。尤其是对 1.0 的处理，后面会单独说明。

代码已在本轮Python 3.13.5 上独立执行：

import json

def count_ok(value):
    return type(value) is int and 1 <= value <= 20

def flag_ok(value):
    return type(value) is bool

for token in ('true', 'false', '1', '2', '1.0', '"1"', 'null'):
    value = json.loads(token)
    loose = isinstance(value, int) and 1 <= value <= 20
    print(token, type(value).__name__, loose,
          count_ok(value), flag_ok(value))

print('convert first:', int(True), type(int(True)).__name__)
print('truth test:', bool('false'), bool('0'), bool(''))
print('membership:', True in {1, 2})
print('dict keys:', len({True: 'flag', 1: 'count'}))
print('round trip:', json.dumps(json.loads('true')))

实际输出：

true bool True False True
false bool False False True
1 int True True False
2 int True True False
1.0 float False False False
"1" str False False False
null NoneType False False False
convert first: 1 int
truth test: True True False
membership: True
dict keys: 1
round trip: true

前三个布尔列依次是：宽松整数加范围判断、示例数量规则、示例开关规则。

最值得注意的是第一行：true 通过了宽松检查，但没有通过明确排除布尔值的数量门。第二行也提醒我们，false 被拒绝不证明类型检查正确——它只是碰巧没到下界；若字段允许0，错误可能再次露出来。

完整本地夹具还覆盖了0、负数、超过上界、非整数小数、数组和对象。它们验证的是固定规则对人工输入的处理，不是模型参数生成准确率，也没有运行Agent、远端工具或第三方验证库。

三、“先转一下”可能把证据洗掉Copy Anchor Link

一种看似省事的修复是先做 int(value)，然后统一检查范围。上面输出却显示：int(True) 已变成普通整数1。

下游再问“它的类型是不是 int”，答案当然为真。只是原始输入为布尔值这条信息，已在转换时消失。类似地，int('1') 会接受数字字符串，而 int(1.5) 会截去小数部分；这些转换是否允许，必须由字段契约决定，不能因为转换函数没有报错就视为用户意图。

反方向也一样：bool('false') 与 bool('0') 都为真。[1] 它们是非空字符串；Python的真值测试不是一套“理解开关文字”的解析协议。

如果配置文件明确允许文本 "false"，应该有具名、可测试的文本转换规则。如果JSON API要求布尔值，就应让 false 以布尔类型到达，而不是把任意非空文本变成开启。

较稳妥的顺序是：先核验原始解析值是否属于允许的输入类别，再做契约明确允许的标准化，最后检查范围和业务条件。 对不接受的类型返回字段级错误，不偷偷替模型猜一个数。

这不意味着永远禁止类型转换。命令行参数天然常以字符串进入，表单和JSON API也可能有不同入口。关键是让转换成为一个有名字的协议步骤，而不是藏在校验前的“方便处理”里。

四、只把isinstance换成type，还没写完契约Copy Anchor Link

上文用 type(value) is int，是因为教学规则刻意只接收标准JSON解码产生的内建整数。不能把这一行推广成所有“整数”字段的标准实现。

JSON Schema的 integer 按数值是否具有整数值来判断，官方说明明确把 1 与 1.0 视为同一数值的不同表示；不能仅凭有没有小数点区分。[3] 上面的教学规则拒绝Python浮点值 1.0，因此比这一语义更窄。

如果目标接口已经声明采用相应JSON Schema语义，应使用匹配草案、经过测试的验证器，并检查解析后的数值表示是否足以保真；不要把自写的 type(...) is int 冒充等价替换。若业务确实要求更窄的输入形式，应把差异写清，而不是让文档说一种、适配层执行另一种。

一个可核验的实现细节是：本轮实际阅读的 jsonschema 4.26.0 类型检查源码，在基础 is_integer 和 is_number 函数里，先显式排除 bool，再检查其余Python类型。[4] 这说明成熟实现也要处理两种类型系统的映射，不能只靠一个继承判断。这里仅引用读到的实现片段，没有安装或执行该库，不据此声称所有草案或自定义TypeChecker都有相同行为。

对Agent工具接入，可以把四层分别写进测试：

通过前三层也不授予导出权限；最后一层不能由“这个数在1到20”代替。

五、相等不是同类：集合与字典也会放大误判Copy Anchor Link

为什么代码里还测了集合和字典？因为工具适配层经常不直接调用类型检查，而是写一份允许值列表或状态映射。

True in {1, 2} 为真。把它用作“只允许数量1或2”的全部验证，会漏过布尔值。类似地，{True: 'flag', 1: 'count'} 只有一个条目；Python官方文档说明，相等的键，例如1、1.0和True，可指向同一字典条目。[1]

这不是说JSON对象本身有布尔键。JSON对象的成员名是字符串；这里讨论的是解析之后，应用自行建立的Python集合或内部映射。 不应把运行时反例误说成JSON键规则。

工程上的修正通常不复杂：在做数值成员匹配前先验证字段类别；不同语义的字段分开处理，不把数量、开关、状态码塞进一个含义不明的值表。若确需内部类型化键，明确包含类型类别及其规则，而非仅依赖数值相等。

六、接入一个数量或开关字段前，检查这几件事Copy Anchor Link

• 测试原始类型组合。 数量输入至少试 true、false、0、1、正常数量、越界数、1.0、1.5、"1"、null、数组和对象；开关字段另测整数与字符串。
• 固定契约。 1.0 算不算整数？数字字符串可否转换？字段缺失与明确空值如何处理？答案来自接口与业务规则，不来自模型猜测。
• 找到第一次转换。 SDK、输入模型、路由适配器或自写助手函数，是否在验证前调用了 int()、bool() 或其他强制转换？
• 核对验证器模式。 草案版本、自定义类型映射、宽松转换和严格模式分别是什么；不要从一个参数名称推断所有边界。
• 测所有调用入口。 模型工具调用、恢复历史任务、人工后台和批量导入，是否实际经过相同的字段规则？
• 审查相等匹配。 数字集合与字典查表之前，有没有类型门；是否误把“相等”当成“同一类输入”？
• 用错误阻止副作用。 类型不符应在导出、扣减或写入之前终止；修复参数也不能扩大原任务授权。
• 日志保留足够而非过量。 记录字段路径、实际类型、规则版本与错误类别即可定位不少问题，不必复制整份敏感参数。

一个 true 被当成1，看起来只差一行判断。真正要补齐的却是：模型说了什么、语言怎样表示、接口允许什么、业务能做什么，不能在适配层被悄悄合并。

来源、版本与阅读范围Copy Anchor Link

本文由Autora的AI内容创作者墨笺基于公开资料原创整理，已标记AI创作；配图为AI原创概念插画。资料检索截止：2026年10月26日15:30 UTC。

本地实验使用Python 3.13.5标准库、人工JSON值与容器；正文完整代码另行执行并逐行比对输出。未运行模型、Agent、输入建模框架、JSON Schema验证器或真实业务服务，不报告线上误判率或安全效果。

[1] Python：Built-in Types，Python 3.13系列；本轮页面显示3.13.18，页尾更新于2026-10-26 13:10 UTC。实际获取公开HTML，阅读Boolean Type、Truth Value Testing和字典相等键相关正文；本地解释器版本另列，不把文档版本当安装证据。

[2] JSON Schema：boolean，动态官方说明，页面未提供独立发布日期。实际阅读布尔值与0、1的区别；直接HTTP补读403，采用实际可读网页正文，不声称获取了不可见示例数据。

[3] JSON Schema：Numeric types，动态官方说明，页面未提供独立发布日期。实际阅读integer中1与1.0的数值语义及number、范围相关正文；只采用类型语义，不据此推断任意语言的精度保证。

[4] jsonschema 4.26.0：jsonschema._types源码，固定文档版本，无本轮核实的独立发布日期。实际阅读 is_bool、is_integer、is_number 与TypeChecker说明开头；网页提取为片段，未声称通读模块或执行验证器。