함수 호출(function calling)을 사용하면 어떤 커스텀 함수나 외부 API든 어시스턴트에 설명할 수 있으며, 어시스턴트는 관련 인수가 담긴 JSON 객체를 출력해 지능적으로 해당 함수들을 호출할 수 있습니다.
Chat Playground에서 함수 호출을 사용하는 방법
새 함수를 추가하려면, Responses API의 경우 화면 왼쪽의 구성 패널에서 "+Tools > Functions"를 클릭하거나, Chat Completions API의 경우 간단히 "+Function"을 클릭하세요.
그런 다음 함수의 파라미터가 포함된 JSON 스키마를 입력합니다. Beta "Generate" 기능을 사용하면, 함수가 수행하길 원하는 내용을 일반 텍스트로 설명하고 추천 JSON 스키마를 받아볼 수 있습니다.
이제 화면 왼쪽에서 “Tools” 아래에 함수가 목록으로 표시됩니다.
플레이그라운드에서 함수를 테스트하려면, 모델이 함수를 호출하도록 유도하는 메시지를 입력하세요.
예를 들어 get_weather 함수의 경우 다음을 입력합니다: "what is the weather in Berkeley?"
함수가 호출되면, 예를 들어 "{temp: 80}"처럼 함수의 출력을 입력하고 “Run”을 누르세요. 그러면 어시스턴트는 제공한 함수 출력값을 사용해 응답을 생성합니다.
병렬 함수 호출(parallel function calling)을 지원하나요?
네, Chat Playground에서는 병렬 함수 호출을 지원합니다.
병렬 함수 호출은 모델이 여러 함수 호출을 함께 수행하는 기능으로, 이러한 함수 호출의 효과와 결과를 병렬로 해결할 수 있게 해줍니다. 특히 함수에 시간이 오래 걸릴 때 유용하며, API와의 왕복(round trip) 횟수를 줄여줍니다.
스키마에서 strict: "true"를 설정해 Structured Outputs 켜기
Structured Outputs를 켜면, 함수 호출을 위해 모델이 생성하는 인수는 사용자가 제공한 JSON Schema와 일치함이 보장됩니다.
Structured Outputs를 사용하지 않는 경우 인수의 구조가 올바르다고 보장되지 않으므로, 사용 전에 Pydantic 같은 검증 라이브러리로 인수를 먼저 검증하는 것을 권장합니다.
Playground에서 Function Choice를 강제하는 방법
모델 이름 옆의 "Settings" 아이콘을 클릭합니다
Tool Choice를 클릭합니다
"Auto"에서 "Required" 또는 원하는 함수(미리 생성한 함수)로 변경합니다.