Amazon Bedrock이 10월 20일 Claude 구조화 출력을 GA한 뒤, output_config.format과 strict 도구에 JSON Schema를 어떻게 쓰나

2026년 10월 22일 기준: runtime과 mantle에서 구조화 출력. InvokeModel은 output_config.format에 json_schema 객체. mantle은 strict true. 각 object에 additionalProperties false. JSON.parse 전 stop_reason.

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을 실데이터로 검증.