gpt-oss Harmony 포맷 — 응답 구조와 도구 사용
gpt-oss Harmony 포맷
gpt-oss 모델은 Harmony 응답 포맷으로 훈련됐어요. 이 포맷이 아니면 결과가 제대로 나오지 않으니, 호출 전에 구조를 이해해 두는 것이 중요해요.
왜 Harmony인가요
Harmony는 추론·도구 호출·구조화된 출력을 하나의 일관된 응답 구조로 표현해요. 모델이 체인오브소트를 거쳐 도구(함수)를 호출하고 최종 답을 내는 과정을 파싱하기 쉽게 만들어 줘요.
에이전트 기능
모델이 네이티브로 지원하는 에이전트 기능은 다음과 같아요.
- Function calling — 함수 호출
- Web browsing — 브라우저 도구
- Python execution — 코드 실행
- Structured Outputs — 구조화된 출력
이들은 모두 Harmony 포맷 안에서 표현돼요.
주의
Harmony는 파이썬 패키지 openai-harmony로도 제공돼요. Transformers 채팅 템플릿을 쓰지 않고 model.generate를 직접 쓰는 경우엔 이 패키지 또는 채팅 템플릿으로 포맷을 적용해야 해요. 체인오브소트 정보는 엔드유저에게 노출하지 않는 것을 권장해요.