Upgrading to GPT-5.4

Upgrading to GPT-5.4 (GPT-5.4로 업그레이드)

사용자가 기존 통합을 GPT-5.4로 업그레이드하라고 명시적으로 요청할 때 이 가이드를 사용하세요. 최신 OpenAI 문서 조회와 함께 사용하세요. 기본 대상 문자열은 gpt-5.4예요.

출처: 문서

본문

업그레이드 자세 (Upgrade posture)

가장 좁고 안전한 변경 집합으로 업그레이드하세요.

  • 먼저 모델 문자열을 교체하세요
  • 해당 모델 사용에 직접 연결된 프롬프트만 업데이트하세요
  • 가능하면 프롬프트 전용 업그레이드를 선호하세요
  • 업그레이드에 API 표면 변경, 파라미터 재작성, 도구 재배선, 또는 더 넓은 코드 편집이 필요하다면, 범위를 확장하는 대신 차단(blocked)으로 표시하세요

업그레이드 워크플로

  1. 현재 모델 사용을 목록화하세요.
    • 모델 문자열, 클라이언트 호출, 프롬프트를 담은 파일을 검색하세요.
    • 인라인 프롬프트, 프롬프트 템플릿, YAML·JSON 구성, Markdown 문서, 저장된 프롬프트를 그것들이 모델 사용 지점과 명확히 연결될 때 포함하세요.
  2. 각 모델 사용을 프롬프트 표면과 짝지으세요.
    • 가장 가까운 프롬프트 표면을 먼저 선호하세요: 인라인 시스템·개발자 텍스트 → 인접 프롬프트 파일 → 공유 템플릿.
    • 프롬프트를 모델 사용과 자신 있게 연결할 수 없다면 추측 대신 그렇게 말하세요.
  3. 소스 모델 계열을 분류하세요.
    • 일반적인 버킷: gpt-4o 또는 gpt-4.1, o1 또는 o3 또는 o4-mini, 초기 gpt-5, 후기 gpt-5.x, 또는 혼합·불명확.
  4. 업그레이드 클래스를 결정하세요.
    • model string only
    • model string + light prompt rewrite
    • blocked without code changes
  5. 코드 없는 호환성 게이트를 실행하세요.
    • 현재 통합이 API 표면 변경이나 구현 변경 없이 gpt-5.4를 받아들일 수 있는지 확인하세요.
    • 장기 실행 Responses 또는 도구 중심 에이전트에서, 호스트가 어시스턴트 항목을 재생하거나 전조(preamble)를 사용할 때 phase가 이미 보존되거나 왕복(round-trip)되는지 확인하세요.
    • 호환성이 코드 변경에 의존하면 blocked를 반환하세요.
    • 호환성이 불명확하면 즉흥적으로 처리하지 말고 unknown을 반환하세요.
  6. 업그레이드를 권장하세요.
    • 기본 교체 문자열: gpt-5.4
    • 개입을 작게 유지하고 동작을 보존하세요.
  7. 구조화된 권장 사항을 전달하세요.
    • Current model usage
    • Recommended model-string updates
    • Starting reasoning recommendation
    • Prompt updates
    • 흐름이 장기 실행, 재생, 또는 도구 중심일 때의 Phase assessment
    • No-code compatibility check
    • Validation plan
    • Launch-day refresh items

출력 규칙:

  • 각 사용 지점에 항상 시작 reasoning_effort_recommendation을 방출하세요.
  • 저장소가 현재 reasoning 설정을 노출한다면, 소스 가이드가 그 외를 말하지 않는 한 먼저 그것을 보존하세요.
  • 저장소가 현재 설정을 노출하지 않으면 null을 반환하는 대신 소스 계열 시작 매핑을 사용하세요.

업그레이드 결과

model string only

다음을 선택하세요:

  • 기존 프롬프트가 이미 짧고, 명시적이며, 작업에 한정된 경우
  • 워크플로가 강하게 리서치 중심, 도구 중심, 다중 에이전트, 배치·완전성 민감, 또는 긴 지평선이 아닌 경우
  • 명백한 호환성 차단 요인이 없는 경우

기본 액션:

  • 모델 문자열을 gpt-5.4로 교체
  • 프롬프트는 그대로 유지
  • 기존 eval 또는 스팟 체크로 동작 검증

model string + light prompt rewrite

다음을 선택하세요:

  • 기존 프롬프트가 더 약한 지시 따르기를 보완하고 있었던 경우
  • 워크플로가 기본 도구 사용 동작이 제공할 것보다 더 많은 지속성이 필요한 경우
  • 작업이 더 강한 완전성, 인용 규율, 검증이 필요한 경우
  • 업그레이드된 모델이 지시하지 않으면 지나치게 장황하거나 덜 완전해지는 경우
  • 워크플로가 리서치 중심이고 희소하거나 빈 검색 결과를 더 강하게 처리해야 하는 경우
  • 워크플로가 코딩 중심, 도구 중심, 또는 다중 에이전트이지만 기존 API 표면과 도구 정의는 그대로 둘 수 있는 경우

기본 액션:

  • 모델 문자열을 gpt-5.4로 교체
  • 한두 개의 타게팅된 프롬프트 블록 추가
  • GPT-5.4 프롬프팅 모범 사례를 읽어 기존 동작을 회복하는 가장 작은 프롬프트 변경을 고르세요
  • 업그레이드와 무관한 광범위한 프롬프트 정리는 피하세요
  • 리서치 워크플로라면 기본적으로 research_mode + citation_rules + empty_result_handling을 사용하고, 호스트가 이미 검색 도구를 쓰면 tool_persistence_rules를 추가하세요
  • 의존성 인식 또는 도구 중심 워크플로라면 기본적으로 tool_persistence_rules + dependency_checks + verification_loop을 사용하고, 검색 단계가 정말 독립적일 때만 parallel_tool_calling을 추가하세요
  • 코딩 또는 터미널 워크플로라면 기본적으로 terminal_tool_hygiene + verification_loop을 사용하세요
  • 다중 에이전트 지원 또는 트리아지 워크플로라면 tool_persistence_rules, completeness_contract, verification_loop 중 적어도 하나를 사용하세요
  • 전조나 여러 어시스턴트 메시지가 있는 장기 실행 Responses 에이전트라면 phase가 이미 처리되는지 명시적으로 검토하고, phase를 추가·보존하려면 코드 편집이 필요하다면 경로를 blocked로 표시하세요
  • 보이는 코드 조각이 최소라 해서 코딩 또는 도구 사용 Responses 워크플로를 blocked로 분류하지 마세요. 저장소가 안전한 GPT-5.4 경로가 호스트 측 코드 변경을 요구함을 명확히 보여주지 않는 한 model string + light prompt rewrite를 선호하세요

blocked

다음을 선택하세요:

  • 업그레이드가 API 표면 변경을 요구하는 것처럼 보이는 경우
  • 업그레이드가 구현 코드 밖에 노출되지 않은 파라미터 재작성이나 reasoning 설정 변경을 요구하는 것처럼 보이는 경우
  • 업그레이드가 도구 정의, 도구 핸들러 배선, 또는 스키마 계약을 바꾸는 경우
  • 모델 사용에 연결된 프롬프트 표면을 자신 있게 식별할 수 없는 경우

기본 액션:

  • 더 넓은 업그레이드를 즉흥적으로 만들지 마세요
  • 차단 요인을 보고하고 수정이 이 가이드의 범위 밖임을 설명하세요

코드 없는 호환성 체크리스트

코드 없는 업그레이드를 권장하기 전에 다음을 확인하세요.

  1. 현재 호스트가 클라이언트 코드나 API 표면 변경 없이 gpt-5.4 모델 문자열을 받아들일 수 있는가?
  2. 관련 프롬프트가 식별·편집 가능한가?
  3. 호스트가 API 표면 변경, 파라미터 재작성, 도구 재배선이 필요할 것 같은 동작에 의존하는가?
  4. 예상 수정이 프롬프트 전용인가, 아니면 구현 변경이 필요한가?
  5. 프롬프트 표면이 모델 사용에 충분히 가까워 광범위한 정리 대신 타게팅된 변경을 할 수 있는가?
  6. 장기 실행 Responses 또는 도구 중심 에이전트에서, 호스트가 전조, 재생된 어시스턴트 항목, 여러 어시스턴트 메시지에 의존할 때 phase가 이미 보존되는가?

항목 1이 no이거나, 항목 3~4가 구현 작업을 가리키거나, 항목 6이 no이고 수정에 코드 변경이 필요하면 blocked를 반환하세요.

항목 2가 no이면, 사용자가 프롬프트 위치를 가리킬 수 없는 한 unknown을 반환하세요.

중요:

  • 도구, 에이전트, 또는 여러 사용 지점의 기존 사용 자체는 차단 요인이 아니에요.
  • 현재 호스트가 같은 API 표면과 같은 도구 정의를 유지할 수 있다면 blocked보다 model string + light prompt rewrite를 선호하세요.
  • blocked는 실제로 구현 변경이 필요한 경우에만, 더 강한 프롬프트 조종만 필요한 경우에는 예약하세요.

범위 경계

이 가이드는 다음을 할 수 있어요:

  • 모델 문자열 업데이트 또는 업데이트 권장
  • 프롬프트 업데이트 또는 업데이트 권장
  • 그러한 변경이 어디에 속하는지 이해하기 위해 코드·프롬프트 파일 검사
  • 기존 Responses 흐름이 이미 phase를 보존하는지 검사
  • 호환성 차단 요인 표시

이 가이드는 다음을 할 수 없어요:

  • Chat Completions 코드를 Responses로 이동
  • Responses 코드를 다른 API 표면으로 이동
  • 파라미터 형태 재작성
  • 도구 정의 또는 도구 호출 처리 변경
  • 구조화 출력 배선 변경
  • 구현 코드에 phase 처리 추가·개조
  • 리터럴 모델 문자열 교체를 넘어 비즈니스 로직, 오케스트레이션 로직, SDK 사용 편집

안전한 GPT-5.4 업그레이드가 그러한 변경 중 하나라도 요구하면 경로를 blocked 및 범위 밖으로 표시하세요.

검증 계획

  • 각 업그레이드 사용 지점을 기존 eval 또는 현실적 스팟 체크로 검증하세요.
  • 업그레이드된 모델이 기대 지연 시간, 출력 형태, 품질과 여전히 일치하는지 확인하세요.
  • 프롬프트 편집을 추가했다면 각 블록이 노이즈 추가가 아니라 실제 작업을 하는지 확인하세요.
  • 워크플로에 다운스트림 영향이 있다면 최종 확정 전에 가벼운 검증 패스를 추가하세요.

출시일 리프레시 항목

최종 GPT-5.4 지침이 바뀌면:

  1. 적절한 곳에서 릴리스 후보 가정을 최종 GPT-5.4 지침으로 교체하세요.
  2. 기본 대상 문자열이 모든 소스 계열에 대해 gpt-5.4로 유지되어야 하는지 다시 확인하세요.
  3. 의미가 바뀌었을 수 있는 프롬프트 블록 권장 사항을 다시 확인하세요.
  4. 최종 모델 동작에 맞춰 리서치, 인용, 호환성 지침을 다시 확인하세요.
  5. 같은 업그레이드 시나리오를 다시 실행하고 blocked 대 가능(viable) 경계가 여전히 유지되는지 확인하세요.

더 알아보기 (Learn more)