OpenAI 개발자 문서는 함수 호출을 체계적으로 설명합니다. 요청에서 함수(도구)를 선언하면 모델은 필요할 때 호출할 함수 이름과 매개변수를 반환합니다. 그런 다음 애플리케이션은 함수를 실행하고 결과를 모델에 반환하여 "추론-호출-피드백"의 닫힌 루프를 형성합니다. 이 기능은 이제 Responses API 를 통해 권장되며, 텍스트 및 이미지와 같은 다중 모드 상호작용과 호스팅된 도구와의 협업을 지원하여 주로 채팅 완성에 의존했던 기존 방식을 대체합니다.
이 가이드는 JSON 스키마를 사용하여 함수 매개변수를 설명하는 것을 강조하고, 더 엄격한 제약 조건(예: 추가 속성 허용 안 함)을 권장합니다. 이는 구조화된 출력 과 결합되어 구문 분석 가능성과 일관성을 크게 향상시킵니다. 또한 tool_choice (자동/필수/없음) 및 다중/병렬 도구 호출 패러다임을 제공하여, 지속적인 추론을 위해 후속 컨텍스트에 도구 반환 결과를 포함할 수 있도록 지원합니다. 마이그레이션 문서는 Assistant/Chat Completions에서 Responses로 전환하는 차이점과 예시를 제공합니다. 또한 이 문서는 개발자에게 모델이 "호출 제안"만 담당하며, 실제 실행 및 보안 검증은 개발자가 관리해야 하며, 매개변수 검증 및 권한 제어가 필요하다는 점을 상기시킵니다.
자주 묻는 질문
질문: 함수 호출과 응답 API의 관계는 무엇입니까?
답변: 응답은 현재 권장되는 인터페이스로, 도구 호출, 이벤트 출력, 멀티모달리티를 기본적으로 지원하며 주로 채팅 완성에 기반을 둔 이전 버전을 대체합니다.
질문: 모델이 함수를 호출하도록 "필수"로 만드는 방법은 무엇입니까?
답변: 요청에서 tool_choice을 required로 설정하거나, 필요한 도구만 제공하고 프롬프트에서 제약 조건을 지정하세요.
질문: 구조화된 출력과 함께 사용할 수 있나요?
A: 네. JSON 스키마를 사용하여 함수 매개변수를 엄격하게 제한할 수 있습니다. 구조화된 출력과 함께 사용하면 최종 결과가 스키마에 따라 반환되도록 하여 구문 분석 및 오류 발생을 줄일 수 있습니다.
질문: 여러 함수를 동시에 호출할 수 있나요?
A: 여러 도구 호출이 하나의 응답으로 반환될 수 있습니다. 애플리케이션은 이를 순차적으로 실행하고 그 결과를 후속 라운드의 입력으로 사용해야 합니다.
질문: 이민의 핵심은 무엇인가요?
답변: 함수 정의와 반환 항목은 응답의 새로운 이벤트/항목 형식을 사용합니다. 요청 본문과 구문 분석 로직은 마이그레이션 가이드에 따라 업데이트해야 합니다.
