Amazon Bedrock 10 月 20 日正式支持 Claude 结构化输出后,output_config.format 和 strict 工具该怎么写 JSON Schema?

截至 2026 年 10 月 22 日:Bedrock 在 runtime 与 mantle 全面开放 Claude 结构化输出。InvokeModel 在 output_config.format 传 json_schema 对象;mantle 工具用 strict true。每个 object 要 additionalProperties false,并先读 stop_reason 再 JSON.parse。

先给结论:10 月 20 日 Amazon Bedrock 把 Claude 的结构化输出从公测推到正式可用,覆盖 bedrock-runtime 和 bedrock-mantle 两条入口。文本答案走 output_config.format,类型是 json_schema,schema 是嵌在请求体里的 JSON 对象,不是字符串。智能体工具在 mantle 上把 strict: true 和 input_schema 一起传。生成阶段就约束 token,不等于响应里永远只有合法业务 JSON:stop_reason 仍是 end_turn、max_tokens 或安全拒答,要先读再 JSON.parse。

这篇按 2026 年 10 月 22 日写,依据 10 月 19–20 日 AWS 博客与产品公告。昨天本站写过《Responses API 12 小时缓存的 usage 字段》。那边改 schema 会改缓存前缀;Bedrock 这边改 schema 结构会触发语法重新编译,但只改字段名或 description 通常仍用 24 小时内的缓存。

10 月 20 日实际开放了什么

公告写的是:在模型可用的区域里,所有 Anthropic Claude 模型都支持结构化输出;既可以用 boto3 调 bedrock-runtime,也可以用 Messages API 走 bedrock-mantle。两条路都能拿到符合你定义结构的 JSON,而不是先收一段自由文本再靠正则捞字段。

机制请求里写什么典型场景
JSON Schema 输出格式output_config.format 里 type: json_schema 加 schema抽取工单、合同字段、报表行
Strict tool use工具定义里 strict: true 加 input_schema多步 Agent、函数调用参数

实现方式是约束解码:模型在生成 token 时就不能走出 schema 允许的集合。这和「生成完再用 JSON Schema 校验、失败就重试」不是同一套成本模型。Bedrock 还支持批量推理、跨区域推理(runtime),以及把结构化结果流式打成类型化事件。

bedrock-runtime:InvokeModel 怎么带 schema

InvokeModel 的请求体仍是 Anthropic 原生 JSON。anthropic_version 常见为 bedrock-2023-05-31。schema 放在 output_config.format,且必须是对象,不能写成字符串包一层。

{
  "anthropic_version": "bedrock-2023-05-31",
  "max_tokens": 512,
  "messages": [
    {"role": "user", "content": "Paulo Santos (paulo@example.com) 想了解 Enterprise 方案并预约下周二下午 2 点演示。"}
  ],
  "output_config": {
    "format": {
      "type": "json_schema",
      "schema": {
        "type": "object",
        "properties": {
          "name": {"type": "string"},
          "email": {"type": "string"},
          "plan_interest": {"type": "string"},
          "demo_requested": {"type": "boolean"}
        },
        "required": ["name", "email", "plan_interest", "demo_requested"],
        "additionalProperties": false
      }
    }
  }
}

每个 object 都要写 additionalProperties: false,否则 Bedrock 不接受这份 schema。字段名和 description 会参与模型理解要抽什么;分类场景里用 enum 把标签锁在固定集合,比事后用 if 过滤更稳。

bedrock-mantle:strict 工具参数

mantle 面向带服务端工具、后台推理和有状态对话的 Agent。工具块里加 strict: true 后,tool_use 的 input 对象必须完全符合 input_schema,不能多字段,enum 外的字符串也不会出现。

{
  "name": "get_weather",
  "description": "查询指定地点当前天气",
  "strict": true,
  "input_schema": {
    "type": "object",
    "properties": {
      "location": {"type": "string"},
      "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
    },
    "required": ["location", "unit"],
    "additionalProperties": false
  }
}

文本结构化输出管的是 content 里 type: text 的那段 JSON 字符串;strict 工具管的是 type: tool_use 的 input 对象(在 Bedrock 响应里通常已是对象,不必再 parse 一层字符串)。同一条流水线里两种合同可能同时出现,日志要分字段存。

从响应体到可校验 JSON 的路径

InvokeModel 返回的 body 先 json.loads 成消息对象。先看 stop_reason:

  • end_turn:在 content 里找 type: text 的块,对其 text 再 JSON.parse,得到业务对象。
  • max_tokens:JSON 可能截断,不能当成功抽取;应加大 max_tokens 重试。
  • 安全拒答:可能没有符合 schema 的 text 块,要走人工或降级策略,不能假设 JSON.parse 一定成功。
{
  "stop_reason": "end_turn",
  "content": [
    {
      "type": "text",
      "text": "{\"name\":\"Paulo Santos\",\"email\":\"paulo@example.com\",\"plan_interest\":\"Enterprise\",\"demo_requested\":true}"
    }
  ]
}

解析成功后,仍建议用 JSON Schema 或本站工具做一次二次校验,确认必填键都在、类型没被你下游改坏。Bedrock 保证的是模型输出侧符合你提交的子集 schema,不是你应用里合并默认值之后的对象。

  • JSON 校验 — 确认 text 块里的字符串是合法 JSON。
  • JSONPath — 从批量响应里取出 $.content[?(@.type=='text')].text。
  • JSON Diff — 对比两次抽取结果,看是 schema 变了还是输入变了。

Schema 子集与 additionalProperties

Bedrock 按 JSON Schema Draft 2020-12 的一个子集校验你提交的 schema。支持 object、array、基本类型、enum、const、有限的 anyOf/allOf、内部 $ref,以及部分字符串 format(如 email、uuid、date-time)。

明确不支持的有:递归 schema、外部 $ref、数值约束(minimum/maximum)、字符串长度约束、以及把 additionalProperties 设成除 false 以外的值。数组只支持 minItems 为 0 或 1。设计 schema 时先用最少必填字段上线,再迭代;复杂嵌套会拉长首次编译时间,也增大 Converse 类接口的请求体体积(schema 计入 payload)。

语法编译与 24 小时缓存

新 schema 第一次请求时,Bedrock 会编译语法 artifact,首包延迟可能略高。编译结果按账号缓存 24 小时,同一结构重复调用开销很小。只改 property 的 title 或 description 一般不触发重新编译;改 properties 结构、required 或 enum 成员则会换一份语法。

应用层应尽量复用固定 schema 模板(例如「工单分类 v3」),把变长提示词放在 messages 里,而不是每次请求改 schema 形状。这和直连 Claude API 上结构化输出要稳定前缀、方便提示缓存的思路一致,只是 Bedrock 侧缓存的是语法而不是 OpenAI 式的 KV 前缀。

常见问题 FAQ

InvokeModel 上的 output_config 和直连 Claude API 一样吗?

字段名同为 output_config.format 和 json_schema,但 Bedrock 走 InvokeModel 原生体,且要 anthropic_version。直连 API 在 2026 年已把旧 output_format 迁到 output_config.format。两边都要 additionalProperties false,错误码与拒答形态仍按各自网关返回。

为什么每个 object 都必须 additionalProperties false?

这是 Bedrock 结构化输出的硬性要求。设为 true 或省略时,schema 校验阶段就会拒绝请求,不会进入约束生成。目的是让输出对象闭包在已知字段集内,避免模型偷偷加键。

stop_reason 是 max_tokens 时还能信任 JSON 吗?

不能。公告与博客都写明 token 用尽时输出可能不完整,不能当作合规抽取。应提高 max_tokens 或缩短 schema 与提示,然后重试。

只改字段 description 会触发重新编译吗?

AWS 文档写明:仅改名称或 description 通常保留已缓存语法;改 JSON 结构(字段增删、required、enum 集合)会失效缓存并重新编译。

json_schema 输出和 strict 工具有什么分工?

前者约束最终给用户或下游系统的 text JSON;后者约束 tool_use 的 input 对象。Agent 里可能先 strict 调工具,再在最后一步用 json_schema 汇总报告,两套 schema 应分开版本管理。

有了结构化输出就可以删掉所有 JSON.parse 吗?

不行。你仍要解析 InvokeModel 外层 body、从 content 取出 text,再 parse 内层字符串。拒答与截断路径下 parse 仍会失败。结构化输出消除的是「模型自由文本不符合 schema」这一类错误,不是解析栈上的全部异常。

总结

10 月 20 日的变化,是把 Claude 在 Bedrock 上的 JSON 合同变成一等公民。runtime 用 output_config.format,mantle 用 strict 工具;对象闭包靠 additionalProperties: false;上线前用真实工单或合同测 stop_reason 三分支。

留档时记下 modelId、schema 版本号、stop_reason 以及解析后的对象哈希,方便和《Sonnet 5.5 工具与 schema》对照直连 API 的差异。