소개

새 모델과 API 기능을 출시할 때마다 최신 개선 사항을 활용할 수 있도록 통합을 업그레이드하는 것이 좋습니다. 한 모델에서 다른 모델로 전환할 때는 모델 이름만 업데이트하면 되는 단순한 작업이 아닌 경우가 많습니다.

API에도 변경 사항이 있을 수 있습니다. 예를 들어 GPT-5.4 모델의 경우 어시스턴트 메시지에 새로운 phase 매개변수를 추가했으며, 통합에 이 매개변수를 포함하는 것이 중요합니다. 하지만 무엇보다 모델의 동작이 달라질 수 있어 기존 프롬프트를 변경해야 할 수도 있습니다.

새 모델로 마이그레이션할 때는 필요한 코드를 변경하는 데 그치지 말고 워크플로우에 미치는 영향도 평가해야 합니다.

OpenAI 문서 스킬 활용하기

모델 가이드 페이지에서는 모델 세대별로 API 기능, 모델 동작, 마이그레이션 및 프롬프팅 지침을 한데 모아 제공합니다.

OpenAI 문서 스킬에는 마이그레이션에 직접 참고할 수 있는 구체적인 지침도 포함되어 있습니다. 현재 업그레이드 대상의 경우 모델 가이드 페이지를 활용하세요.

Codex에는 이제 OpenAI 문서 스킬이 자동으로 포함됩니다. OpenAI API로 개발할 때 최신 문서와 지침을 모두 이용할 수 있도록 프롬프트에 이 스킬을 명시하세요.

견고한 평가 파이프라인 구축하기

Codex는 최신 프롬프트 지침에 따라 프롬프트를 자동으로 업데이트할 수 있습니다. 하지만 통합이 예상대로 작동하는지 자동으로 검증할 방법을 마련해야 합니다.

통합을 변경할 때마다 실행해 동작에 회귀가 발생하지 않았는지 확인할 수 있는 평가 파이프라인을 구축하세요.

이 쿡북 가이드에서는 Evals API를 사용해 이를 수행하는 방법을 자세히 설명합니다.