구조화된 출력(이동됨)

structured-outputs 가이드가 최상위 섹션으로 이동했으며, 구축하려는 항목에 따라 나뉘어 있습니다. 적합한 경로를 선택하세요.

• 개요 — 구조화된 출력의 정의, 스키마 라이브러리 선택지, provider 지원, "어느 페이지를 읽어야 하나요?"를 설명합니다.
• 일회성 추출 — 프롬프트 하나를 입력하고 타입이 지정된 객체 하나를 출력합니다. 스트리밍이나 채팅 기록이 필요하지 않을 때 사용합니다.
• 스트리밍 UI — useChat({ outputSchema })에서 partial과 final이 UI를 필드별로 채웁니다.
• 멀티턴 채팅 — 성공적으로 완료된 각 structured-output 실행이 타입이 지정된 응답을 메시지 기록에 추가하며, messages[i].parts.find(p => p.type === "structured-output").data의 타입은 스키마에 따라 지정됩니다.
• 도구와 함께 사용 — 에이전트 루프와 outputSchema를 결합하며, 서버 도구 승인과 클라이언트 도구 호출을 위한 일시 중지/재개를 포함합니다.
• 하네스 에이전트 — 샌드박스의 코딩 에이전트가 파일을 검사한 후 타입이 지정된 객체를 반환합니다.

참고: 이 URL은 이전 버전과의 호환성을 위해 유지됩니다. 새 콘텐츠는 /structured-outputs/* 아래에 있으므로 가능할 때 기존 북마크를 업데이트하세요.