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 스키마를 따라야 할 때 output_config.format을 사용하세요.
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"risk_level": {
"type": "문자열",
"enum": ["낮음", "중간", "높음"]
},
"findings": {
"type": "array",
"items": {
"type": "object",
"속성": {
"claim": {"type": "문자열"},
"source": {"type": "string"}
},
"required": ["청구", "출처"],
"additionalProperties": False
}
}
},
"required": ["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": "string"},
"severity": {
"type": "문자열",
"enum": ["낮음", "중간", "높음"]
},
"evidence_ids": {
"type": "배열",
"items": {"type": "문자열"}
}
},
"required": ["제목", "심각도", "evidence_ids"],
"additionalProperties": False
}
}]
엄격함은 형태를 보장할 뿐, 권한을 보장하지 않습니다. 서버는 여전히 사용자가 작업을 승인했는지, 각 증거 ID가 존재하는지 확인해야 합니다.
부주의하게 강제 도구 사용을 시뮬레이션하지 마십시오
현재 턴에 특정 도구가 필요한 경우, 모델에게 명확히 지시하고 사용 가능한 중간 대화 시스템 안내를 활용하세요. 그런 다음 오케스트레이션 계층에서 예상된 호출이 발생했는지 확인해야 합니다. 대체 수단으로 자유 형식 텍스트를 실행하지 마십시오.
실제 요구사항이 "유효한 JSON 반환"이라면, 가짜 도구를 만드는 대신 JSON 출력을 사용하세요.
모델 및 애플리케이션 신뢰성을 위한 디자인 스키마
스키마를 좁게 유지하세요
의미 있는 열거형, 필수 필드, 그리고 additionalProperties: false를 사용하세요. 임의의 내용을 숨길 수 있는 보편적인 "metadata" 객체는 피하세요.
증거와 결론을 분리하세요
결과와 함께 출처 식별자나 발췌문을 요구합니다. 유효한 high 값이라도 증거가 수반되지 않으면 여전히 지원되지 않습니다.
불확실성을 명시적으로 표현하세요
status: confirmed | inferred | unresolved와 같은 필드를 사용하여 불확실한 증거를 강제로 확정적인 부울 값으로 변환하지 마십시오.
구문 분석 후 의미 검증
애플리케이션 코드에서 범위, 데이터베이스 존재 여부, 권한, 통화 일관성 및 교차 필드 규칙을 확인하세요. 현재 구조화된 출력 지원에는 재귀 스키마가 없고 숫자, 문자열, 배열 및 정규식 제약 조건이 제한되는 등 JSON 스키마 제한 사항이 있습니다.
캐싱 및 토큰 고려 사항
구조화된 출력은 시스템 프롬프트에 형식 지침을 주입하여 입력 토큰을 약간 증가시킵니다. output_config.format을 변경하면 해당 대화의 프롬프트 캐시가 무효화됩니다. 스키마 버전을 관리하고 요청마다 약간 다른 스키마가 생성되지 않도록 하십시오.
암호화 키 제한
Anthropic은 고객 관리형 암호화 키를 사용하는 조직이 Claude Fable 5.2 또는 Mythos 5.2에서 구조화된 출력을 사용할 수 없다고 문서화합니다. 여기에는 JSON 출력과 엄격한 도구 사용이 포함됩니다. 해당 구성에서는 자동 도구 선택을 사용하고, strict를 생략하며, 입력을 로컬에서 검증하고, 안전한 재시도 또는 복구 경로를 설계하십시오.
오류 처리 전략
- 스키마를 보내기 전에 검증하세요.
- 지원되지 않는 스키마 기능을 일시적 오류가 아닌 개발 오류로 처리합니다.
- API 결과를 확인한 후에만 응답을 파싱하세요.
- 비즈니스 규칙을 로컬에서 검증하세요.
- JSON이 파싱되었다는 이유만으로 도구를 절대 실행하지 마십시오.
- 로그 스키마 버전 및 요청 ID.
자주 묻는 질문
왜 tool_choice: {"type":"도구"} Fable 5.2에서 실패하나요?
강제된 tool 및 any 선택은 지원되지 않습니다. 엄격한 도구 사용, JSON 출력 또는 지원되는 오케스트레이션 지침과 함께 auto를 사용하세요.
유효한 JSON이 답이 맞다는 것을 의미하나요?
아니요. 형식은 보장하지만, 진실, 증거, 권한 또는 안전한 비즈니스 행동은 보장하지 않습니다.
JSON 출력과 엄격한 도구를 함께 사용할 수 있나요?
네, 계정 구성이 구조화된 출력을 지원하는 경우입니다. 이들은 상호작용의 서로 다른 부분을 제어합니다.


















































































































