핵심 요약

OpenAI Responses API에서 함수 호출이 모델에 의해 요청되더라도 실제 함수 실행은 애플리케이션이 담당한다. 모델이 반환하는 응답 내에서 type이 function_call인 항목을 확인하여 함수 이름과 인자를 파악하고, 이를 기반으로 애플리케이션이 함수를 실행한다. 실행한 결과는 원래 호출의 call_id와 연결되는 function_call_output 타입으로 생성하여 API에 재전송한다.

호출 요청과 실행의 분리

  1. 함수 정의를 API에 제출한다.
  2. 응답 내 response.output에서 function_call 항목의 이름과 인자를 확인한다.
  3. 애플리케이션이 해당 함수와 인자를 바탕으로 실제 작업을 실행한다.
  4. 함수 실행 결과를 function_call_output 항목으로 만들어 원래 호출의 call_id를 포함시킨다.
  5. 결과를 포함한 입력으로 responses.create를 다시 호출하여 추가 응답을 받는다.

응답 내 함수 호출 항목 찾기

  • response.output은 메시지, 추론, 도구 또는 함수 호출 등 다양한 항목을 포함한다.
  • type이 function_call인 항목을 분리하여 해당 함수 호출 요청을 파악한다.
  • 예를 들어, 가상의 로컬 함수 get_note가 요청되면 이름과 인자를 추출하여 애플리케이션에서 실행 준비를 한다.

결과 연결 및 재호출

  • 실행 결과는 function_call_output 타입의 입력 항목으로 만들어야 한다.
  • 원호 출처 호출과 동일한 call_id를 사용하여 함수 호출의 결과임을 명확히 연결한다.
  • 결과가 포함된 입력을 다시 API에 보내 후속 응답을 이어받는다.

실무 유의점

  • 함수가 실행되지 않은 경우, 응답 내 function_call 항목 존재 여부를 반드시 확인한다.
  • 애플리케이션 단계에서 함수 이름과 인자를 반드시 검사하고 실행 절차를 거쳐야 한다.
  • 대화 상태를 직접 관리할 경우, 추론 항목, 함수 호출, 함수 결과 항목의 누락이 없도록 점검한다.
  • call_id가 올바르게 매칭되는지도 확인해야 데이터 연속성을 유지할 수 있다.
  • 테스트 시 비민감 가상 데이터와 로컬 함수를 사용하는 것을 권장한다.
  • 실제 API 이용 전에는 사용 환경 및 비용 정책을 반드시 검토한다.

1차 출처