For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme
Codex

Codex use case

API 연동 업그레이드하기

앱을 업그레이드해 최신 OpenAI API 모델을 사용하세요.

Difficulty Intermediate
Time horizon 1h

Codex로 기존 OpenAI API 연동에 최신 권장 모델과 API 기능을 적용하고, 배포 전에 회귀 문제가 없는지 확인하세요.

Best for

  • 이전 모델이나 API 인터페이스에서 최신 버전으로 전환하는 팀
  • 마이그레이션 시 기존 동작을 유지하고 이를 명확한 절차에 따라 검증해야 하는 레포지토리

Contents

    ← All use cases

    API 연동 업그레이드하기

    앱을 업그레이드해 최신 OpenAI API 모델을 사용하세요.

    Codex로 기존 OpenAI API 연동에 최신 권장 모델과 API 기능을 적용하고, 배포 전에 회귀 문제가 없는지 확인하세요.

    Intermediate
    1h

    Codex로 기존 OpenAI API 연동에 최신 권장 모델과 API 기능을 적용하고, 배포 전에 회귀 문제가 없는지 확인하세요.

    Intermediate
    1h

    Best for

    • 이전 모델이나 API 인터페이스에서 최신 버전으로 전환하는 팀
    • 마이그레이션 시 기존 동작을 유지하고 이를 명확한 절차에 따라 검증해야 하는 레포지토리

    Skills & Plugins

    • Codex가 코드를 수정하기 전에 모델, 마이그레이션, API에 관한 최신 가이드를 가져옵니다.
    Skill Why use it
    OpenAI Docs Codex가 코드를 수정하기 전에 모델, 마이그레이션, API에 관한 최신 가이드를 가져옵니다.

    Starter prompt

    $openai-docs를 사용해 이 OpenAI API 연동에 최신 권장 모델과 API 기능을 적용해 주세요. 특히 대상 모델의 최신 사용 가이드와 이 모델에 맞는 최신 프롬프트 작성 지침을 찾아 주세요. 요구 사항: - 먼저 레포지토리에서 현재 사용하는 모델과 엔드포인트를 나열하고, 코드가 도구 사용에 대해 어떤 가정을 하는지 정리해 주세요. - 변경을 최소화하면서 현재 지원되는 최신 방식으로 전환할 수 있는 마이그레이션 계획을 세워 주세요. - 새 API나 모델에서 변경을 요구하는 경우를 제외하고 기존 동작을 유지해 주세요. - 해당 모델의 최신 프롬프트 작성 지침에 따라 프롬프트를 업데이트해 주세요. - 프롬프트, 도구, 응답 구조의 변경 사항 중 직접 검토해야 할 항목을 명시해 주세요.
    $openai-docs를 사용해 이 OpenAI API 연동에 최신 권장 모델과 API 기능을 적용해 주세요. 특히 대상 모델의 최신 사용 가이드와 이 모델에 맞는 최신 프롬프트 작성 지침을 찾아 주세요. 요구 사항: - 먼저 레포지토리에서 현재 사용하는 모델과 엔드포인트를 나열하고, 코드가 도구 사용에 대해 어떤 가정을 하는지 정리해 주세요. - 변경을 최소화하면서 현재 지원되는 최신 방식으로 전환할 수 있는 마이그레이션 계획을 세워 주세요. - 새 API나 모델에서 변경을 요구하는 경우를 제외하고 기존 동작을 유지해 주세요. - 해당 모델의 최신 프롬프트 작성 지침에 따라 프롬프트를 업데이트해 주세요. - 프롬프트, 도구, 응답 구조의 변경 사항 중 직접 검토해야 할 항목을 명시해 주세요.

    소개

    OpenAI가 새 모델과 API 기능을 출시하면 최신 개선 사항을 활용할 수 있도록 API 연동을 업그레이드하는 것이 좋습니다. 다른 모델로 전환할 때는 모델 이름만 바꾸는 것으로 충분하지 않은 경우가 많습니다.

    API 자체가 바뀌기도 합니다. 예를 들어 GPT-5.4에서는 어시스턴트 메시지에 phase 매개변수가 새로 추가되었으며, API 연동 시 이 매개변수를 포함하는 것이 중요합니다. 무엇보다 모델마다 동작이 다를 수 있으므로 기존 프롬프트를 수정해야 할 수도 있습니다.

    새 모델로 마이그레이션할 때는 필요한 코드를 수정하고, 모델 변경이 워크플로우에 미치는 영향도 평가하세요.

    OpenAI Docs 스킬 활용하기

    모델 가이드에서는 모델 세대별로 API 기능과 모델 동작을 설명하고, 마이그레이션과 프롬프트 작성 방법을 안내합니다.

    OpenAI Docs 스킬에는 마이그레이션할 때 참고할 수 있는 구체적인 지침도 있습니다. 현재 업그레이드 대상 모델에 대한 안내는 모델 가이드를 참고하세요.

    이제 Codex에는 OpenAI Docs 스킬이 기본으로 포함되어 있습니다. OpenAI API로 개발할 때는 최신 문서와 지침을 모두 참고할 수 있도록 프롬프트에 이 스킬을 명시하세요.

    신뢰할 수 있는 평가 파이프라인 구축하기

    Codex는 최신 프롬프트 작성 지침에 따라 프롬프트를 자동으로 업데이트할 수 있습니다. API 연동이 예상대로 동작하는지 자동으로 검증할 방법도 마련하세요.

    API 연동을 변경할 때마다 실행할 수 있는 평가 파이프라인을 구축해 기존에 잘 동작하던 기능에 문제가 생기지 않았는지 확인하세요.

    쿡북 가이드에서는 OpenAI의 Evals API로 평가 파이프라인을 구축하는 방법을 자세히 설명합니다.

    Related use cases