Claude Fable 5.2 结构化输出:无需强制工具使用即可生成可靠的 JSON
使用Claude Fable 5.2生成符合模式的JSON和可靠工具参数,支持JSON输出、严格工具使用和本地语义验证

Claude Fable 5.2 不支持将 tool_choice 设置为 any 或指定 tool 名称的强制工具选择;这些配置会返回 400 错误。但这并不妨碍实现可靠的自动化。请根据所需合约使用正确的功能:
- JSON 输出限制了模型的最终响应。
- 严格的工具使用会验证Claude选择进行的任何工具调用的名称和输入。
- 当代理需要可靠的函数参数和结构化的最终结果时,两者都使用。
模式有效性并不等同于事实或业务有效性。您的应用程序仍需检查权限、标识符、日期、总额以及某项操作是否被允许。
选项 1:JSON 输出
当响应本身必须遵循 JSON Schema 时,请使用 output_config.format。
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"风险等级": {
"type": "字符串",
"enum": ["低", "中等", "高"]
},
"findings": {
"type": "array",
"items": {
"type": "object",
"属性": {
"claim": {"type": "字符串"},
"source": {"type": "字符串"}
},
"必填": ["索赔", "源"],
"additionalProperties": False
}
}
},
"必填": ["risk_level", "发现"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "用户",
"content": "评估所提供的变更日志,并为每项发现引用证据。"
}],
output_config={
"format": {
"type": "json_schema",
"schema": 模式
}
}
)
当前生产字段为 output_config.format。较旧的测试版示例可能使用 output_format;请更新 SDK 和请求结构,而非复制过渡代码。
选项 2:严格工具使用
在工具定义中设置 strict: true,以确保 Claude 调用工具时,工具输入与其架构匹配。将 tool_choice 保持为 auto。
tools = [{
"name": "create_review_ticket",
"description": "仅在用户批准后创建审核工单。",
"strict": True,
"input_schema": {
"type": "object",
"属性": {
"title": {"type": "字符串"},
"severity": {
"type": "字符串",
"enum": ["低", "中等", "高"]
},
"evidence_ids": {
"type": "数组",
"items": {"type": "字符串"}
}
},
"必填": ["标题", "严重程度", "evidence_ids"],
"additionalProperties": False
}
}]
严格性保证的是形状,而非授权。服务器仍需确认用户已批准该操作,且每个证据ID确实存在。
不要随意模拟强制工具使用
如果当前轮次需要使用特定工具,请明确指示模型,并在可用时使用支持的对话中系统引导。随后,你的编排层应验证是否发生了预期的调用。不要将自由格式文本作为备选方案执行。
如果实际要求是“返回有效的JSON”,请使用JSON输出,而不是编造一个虚假的工具。
为模型和应用程序可靠性设计架构
保持模式简洁
使用有意义的枚举、必填字段以及 additionalProperties: false。避免使用可以隐藏任意内容的通用“metadata”对象。
将证据与结论分开
要求提供与发现结果一同出现的来源标识符或摘录。若没有证据支持,即使 high 值有效,仍视为不支持。
明确表示不确定性
使用诸如 status: confirmed | inferred | unresolved 这样的字段,而不是将不确定的证据强制转换为确定的布尔值。
解析后验证语义
检查范围、数据库存在性、权限、货币一致性以及应用代码中的跨字段规则。当前的结构化输出支持存在JSON Schema限制,包括不支持递归模式,以及数值、字符串、数组和正则表达式约束受限。
缓存与令牌注意事项
结构化输出将格式指导注入系统提示中,略微增加输入令牌数。更改 output_config.format 会使该对话的提示缓存失效。请对模式进行版本管理,避免为每个请求生成略有不同的模式。
加密密钥限制
Anthropic 文档指出,使用客户管理加密密钥的组织无法在 Claude Fable 5.2 或 Mythos 5.2 中使用结构化输出。这包括 JSON 输出和严格的工具使用。在此配置下,请使用自动工具选择,省略 strict,在本地验证输入,并设计安全的重新尝试或修复路径。
错误处理策略
- 发送前验证架构。
- 将不支持的 schema 特性视为开发错误,而非临时故障。
- 仅在检查API结果后解析响应。
- 在本地验证业务规则。
- 切勿仅因 JSON 解析成功就执行工具。
- 日志模式版本和请求ID。
常见问题解答
为什么 `tool_choice: {"type":"工具"}在 Fable 5.2 上失败?
强制使用 tool 和 any 选择不受支持。请使用带有严格工具使用的自动模式、JSON 输出或支持的编排指令。
有效的 JSON 是否意味着答案是正确的?
不。它保证的是格式,而非真实性、证据、授权或安全的商业行为。
JSON 输出和严格工具可以一起使用吗?
是的,账户配置支持结构化输出的地方。它们控制交互的不同部分。


















































































































