10월 20일 Amazon Bedrock에서 Claude 구조화 출력이 GA 되었고 bedrock-runtime과 bedrock-mantle 모두에서 쓸 수 있습니다. 텍스트는 output_config.format의 json_schema와 중첩 schema 객체입니다. mantle에서는 도구에 strict: true. 파싱 전 stop_reason을 확인하세요.
2026년 10월 22일 기준. 어제 글: 12시간 캐시 usage. schema 구조 변경은 문법 재컴파일, description만 바꾸면 24시간 캐시가 남는 경우가 많습니다.
10월 20일 내용
가용한 모든 Claude 모델에서 JSON Schema 출력과 strict tool use, 생성 시 토큰 제약.
InvokeModel
output_config.format에 schema 객체. 각 object에 additionalProperties: false 필수.
strict 도구
strict: true가 tool_use.input을 묶습니다. 텍스트 JSON과 도구 입력은 별도 계약입니다.
응답에서 JSON
end_turn이면 text 블록 parse. max_tokens는 신뢰하지 않음. JSON 검증.
schema 부분집합
Draft 2020-12 부분집합. 재귀·외부 $ref 불가, additionalProperties는 false만.
24시간 캐시
새 schema 첫 요청은 컴파일로 느릴 수 있음. 구조는 고정하고 messages만 바꿈.
FAQ
직접 Claude API와 같은 output_config?
경로는 같지만 Bedrock은 InvokeModel 본문. additionalProperties false는 공통.
additionalProperties false가 필수?
예. 없으면 schema 거절.
max_tokens에서 JSON 신뢰?
아니요. max_tokens 늘리거나 prompt·schema 줄이기.
description 변경 시 재컴파일?
보통 아니요. 구조 변경은 예.
json_schema vs strict?
최종 text JSON vs tool_use.input. 버전 분리.
JSON.parse 전부 삭제?
아니요. 외부 body와 거부 경로는 남습니다.
요약
10월 20일 Bedrock에서 JSON 계약이 정식화. runtime은 output_config, mantle은 strict. stop_reason을 실데이터로 검증.