더북(TheBook)

response.output: 응답 구조 이해하기

Responses API에서는 모델의 출력이 response.output 배열 형태로 반환됩니다. 이 배열에는 모델이 생성한 여러 종류의 출력 객체가 포함될 수 있으며, 각 항목은 type 값으로 구분합니다.

표 3-2 response.output 항목 유형

type

의미

워크플로 처리

message

일반 텍스트 응답

최종 사용자 응답

function_call

함수 호출 요청

함수 실행 단계

특히 function_call 유형은 LLM이 외부 도구를 사용해야 한다고 판단했음을 의미합니다. 이 경우 애플리케이션은 다음과 같은 처리 단계를 거쳐야 합니다.

1. function_call 객체에서 요청한 함수 이름과 인수를 확인합니다.

2. 해당 함수를 실제로 실행합니다.

3. 실행 결과를 다시 LLM에 전달합니다.

4. LLM이 최종 사용자 응답을 생성합니다.

이와 같은 response.output 구조를 이해하면 LLM이 어떤 작업을 수행하려는지 판단할 수 있고, Tool Use 기반 애플리케이션의 실행 흐름을 제어할 수 있습니다.