공통 학습 / 주제별 해설

Converse 요청과 스트림

제품 설명 기준 2026.09.20–21 · 한영 용어 대조 2026.09.25 · 약 2분 읽기

공식 자료를 바탕으로 쓴 비공식 해설입니다. 제품별 지원 조건은 적용 전에 확인하고, 예시 수치는 해당 상황의 설명으로 읽어주세요.

이 문서의 목차 1개 절

Converse 요청에서는 대화를 messages, 시스템 지침을 system, 공통 추론 설정을 inferenceConfig에 넣는다. 모델 전용 설정은 별도 필드로 전달한다. 모델을 교체할 때는 지원 모달리티(modality)와 필드를 다시 검증해야 한다. 스트리밍(streaming) 응답은 contentBlockIndex별로 나누어 델타(delta), 즉 차례로 도착한 변경분을 합친다. 이후 messageStop의 stopReason과 metadata를 확인해 종료 상태를 판단한다. 일부만 도착한 toolUse JSON을 완성된 도구 인수(tool arguments)로 보고 실행해서는 안 된다. Prompt Management의 프롬프트를 사용할 때는 함께 보낼 수 없는 필드가 있으므로 API의 입력 조건을 확인한다.

적용 범위: 모델별 추가 필드·제약과 실제 스트림 조립은 API 계약에 따라 검증한다.

공식 출처와 이어 읽기

학습 기록은 이 브라우저에만 저장되며 동기화되지 않습니다.