핵심 요약
OpenAI Responses API에서 함수 호출이 모델에 의해 요청되더라도 실제 함수 실행은 애플리케이션이 담당한다. 모델이 반환하는 응답 내에서 type이 function_call인 항목을 확인하여 함수 이름과 인자를 파악하고, 이를 기반으로 애플리케이션이 함수를 실행한다. 실행한 결과는 원래 호출의 call_id와 연결되는 function_call_output 타입으로 생성하여 API에 재전송한다.
호출 요청과 실행의 분리
- 함수 정의를 API에 제출한다.
- 응답 내
response.output에서function_call항목의 이름과 인자를 확인한다. - 애플리케이션이 해당 함수와 인자를 바탕으로 실제 작업을 실행한다.
- 함수 실행 결과를
function_call_output항목으로 만들어 원래 호출의call_id를 포함시킨다. - 결과를 포함한 입력으로
responses.create를 다시 호출하여 추가 응답을 받는다.
응답 내 함수 호출 항목 찾기
response.output은 메시지, 추론, 도구 또는 함수 호출 등 다양한 항목을 포함한다.type이function_call인 항목을 분리하여 해당 함수 호출 요청을 파악한다.- 예를 들어, 가상의 로컬 함수
get_note가 요청되면 이름과 인자를 추출하여 애플리케이션에서 실행 준비를 한다.
결과 연결 및 재호출
- 실행 결과는
function_call_output타입의 입력 항목으로 만들어야 한다. - 원호 출처 호출과 동일한
call_id를 사용하여 함수 호출의 결과임을 명확히 연결한다. - 결과가 포함된 입력을 다시 API에 보내 후속 응답을 이어받는다.
실무 유의점
- 함수가 실행되지 않은 경우, 응답 내
function_call항목 존재 여부를 반드시 확인한다. - 애플리케이션 단계에서 함수 이름과 인자를 반드시 검사하고 실행 절차를 거쳐야 한다.
- 대화 상태를 직접 관리할 경우, 추론 항목, 함수 호출, 함수 결과 항목의 누락이 없도록 점검한다.
call_id가 올바르게 매칭되는지도 확인해야 데이터 연속성을 유지할 수 있다.- 테스트 시 비민감 가상 데이터와 로컬 함수를 사용하는 것을 권장한다.
- 실제 API 이용 전에는 사용 환경 및 비용 정책을 반드시 검토한다.