Upgrading to GPT-5.5

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

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

출처: 문서

본문

업그레이드 자세

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

• 먼저 모델 문자열을 교체하세요
• 해당 모델 사용에 직접 연결된 프롬프트만 업데이트하세요
• 역사적 문서, 예시, 테스트, eval 기준선, 비교 코드, 저비용 폴백·라우팅 경로처럼 의도적으로 고정(pinned)되었을 수 있는, 더 오래되거나 모호한 모델 사용은 자동으로 업그레이드하지 마세요. 사용자가 모든 모델 사용을 업그레이드하라고 명시적으로 요청하지 않는 한, 그 지점은 그대로 두고 확인 필요 목록으로 나열하세요
• 가능하면 프롬프트 전용 업그레이드를 선호하세요
• 업그레이드에 API 표면 변경, 파라미터 재작성, 도구 재배선, 프로바이더 마이그레이션, 또는 더 넓은 코드 편집이 필요하다면, 범위를 확장하는 대신 차단(blocked)으로 표시하세요

업그레이드 워크플로

1. 현재 모델 사용을 목록화하세요.
   • 모델 문자열, 클라이언트 호출, 프롬프트를 담은 파일을 검색하세요.
   • 인라인 프롬프트, 프롬프트 템플릿, YAML·JSON 구성, Markdown 문서, 저장된 프롬프트를 그것들이 모델 사용 지점과 명확히 연결될 때 포함하세요.
2. 각 모델 사용을 프롬프트 표면과 짝지으세요.
   • 가장 가까운 프롬프트 표면을 먼저 선호하세요: 인라인 시스템·개발자 텍스트 → 인접 프롬프트 파일 → 공유 템플릿.
   • 프롬프트를 모델 사용과 자신 있게 연결할 수 없다면 추측 대신 그렇게 말하세요.
3. 소스 모델 계열을 분류하세요.
   • 일반적인 버킷: GPT-5.4, GPT-5.3-Codex 또는 GPT-5.2-Codex, 이전 GPT-5.x, GPT-4o 또는 GPT-4.1, o1·o3·o4-mini 같은 추론 모델, 타사 모델, 또는 혼합·불명확.
4. 업그레이드 클래스를 결정하세요.
   • model string only
   • model string + light prompt rewrite
   • blocked without code changes
5. 호환성 게이트를 실행하세요.
   • 현재 통합이 API 표면 변경이나 구현 변경 없이 gpt-5.5를 받아들일 수 있는지 확인하세요.
   • 구조화 출력, 도구 스키마, 함수 이름, 다운스트림 파서가 그대로 유지될 수 있는지 확인하세요.
   • 장기 실행 Responses 또는 도구 중심 에이전트에서, 호스트가 어시스턴트 항목을 재생하거나 전조를 사용할 때 phase가 이미 보존되거나 왕복되는지 확인하세요.
   • 호환성이 코드 변경에 의존하면 blocked를 반환하세요.
   • 호환성이 불명확하면 즉흥적으로 처리하지 말고 unknown을 반환하세요.
6. 범위 내에 있을 때 업그레이드를 적용하세요.
   • 기본 교체 문자열: gpt-5.5.
   • 개입을 작게 유지하고 동작을 보존하세요.
   • 현재 reasoning effort가 보이면, 그것을 바꿀 측정된 이유가 없는 한 그에서 시작하세요.
   • 범위 내 변경은 모델 문자열과 직접 관련된 프롬프트를 업데이트하세요.
   • blocked 또는 unknown 변경은 편집하지 말고 차단 요인이나 불확실성을 보고하세요.
7. 결과를 요약하세요.
   • Current model usage
   • Model-string updates
   • Reasoning-effort handling
   • Prompt updates
   • Structured output and formatting assessment
   • 흐름이 도구, 검색, 터미널 액션을 사용할 때의 Tool-use assessment
   • 흐름이 장기 실행, 재생, 또는 도구 중심일 때의 Phase assessment
   • Compatibility check
   • Validation performed

출력 규칙:

• 각 사용 지점에 대해 시작 reasoning-effort 권장 사항을 명시하세요.
• 저장소가 현재 reasoning 설정을 노출한다면, 현재 OpenAI 문서가 그 외를 말하지 않는 한 먼저 그것을 보존하도록 권장하세요.
• 저장소가 현재 설정을 노출하지 않으면, 현재 OpenAI 문서가 요구하지 않는 한 추가하지 않도록 권장하세요.

업그레이드 결과

model string only

다음을 선택하세요:

• 소스 모델이 GPT-5.4인 경우
• 기존 프롬프트가 이미 짧고, 명시적이며, 작업에 한정된 경우
• 워크플로가 업그레이드 후 검증되어야 하는 엄격한 출력 형식, 도구 호출 동작, 배치 완전성, 긴 지평선 실행에 의존하지 않는 경우
• 명백한 호환성 차단 요인이 없는 경우

기본 액션:

• 모델 문자열을 gpt-5.5로 교체
• 현재 reasoning effort 보존
• 프롬프트는 그대로 유지
• 기존 테스트, 현실적 스팟 체크, 또는 이미 사용 가능한 기존 eval 스위트로 동작 검증

model string + light prompt rewrite

다음을 선택하세요:

• 작업이 더 강한 완전성, 인용 규율, 검증, 의존성 처리가 필요한 경우
• 업그레이드된 모델이 서식을 제한하지 않으면 지나치게 장황하거나, 너무 밀도 있거나, 스캔하기 어려워지는 경우
• 워크플로가 엄격한 출력 형태 요구 사항이 있고 명시적 형식 계약, 스키마, 파서 검증이 없는 경우
• 워크플로가 리서치 중심이고 희소하거나 빈 검색 결과를 더 강하게 처리해야 하는 경우
• 워크플로가 코딩 중심, 터미널 기반, 도구 중심, 또는 다중 에이전트이지만 기존 API 표면과 도구 정의는 그대로 둘 수 있는 경우

기본 액션:

• 모델 문자열을 gpt-5.5로 교체
• 첫 패스에서는 현재 reasoning effort 보존
• 관찰된 워크플로 위험에 필요한 가장 작은 프롬프트 편집만 수행
• GPT-5.5 프롬프팅 모범 사례를 읽어 동작을 회복·개선하는 가장 작은 프롬프트 변경을 고르세요
• 업그레이드와 무관한 광범위한 프롬프트 정리는 피하세요
• 리서치 워크플로라면 프롬프팅 가이드에서 인용 규칙, 검색 예산, 증거 누락 동작, 검증 지침을 추가하세요
• 의존성 인식 또는 도구 중심 워크플로라면 전제 조건 검사, 누락 컨텍스트 처리, 명시적 도구 예산, 중지 조건, 검증 지침을 추가하세요
• 코딩 또는 터미널 워크플로라면 저장소별 제약, 수용 기준, 구체적인 검증 명령을 추가하세요
• 다중 에이전트 지원 또는 트리아지 워크플로라면 작업 소유권, 핸드오프, 완전성, 중지 기준을 추가하세요
• 전조나 여러 어시스턴트 메시지가 있는 장기 실행 Responses 에이전트라면 phase가 이미 처리되는지 명시적으로 검토하고, phase를 추가·보존하려면 코드 편집이 필요하다면 경로를 blocked로 표시하세요
• 보이는 코드 조각이 최소라 해서 코딩 또는 도구 사용 Responses 워크플로를 blocked로 분류하지 마세요. 저장소가 안전한 GPT-5.5 경로가 호스트 측 코드 변경을 요구함을 명확히 보여주지 않는 한 model string + light prompt rewrite를 선호하세요

blocked

다음을 선택하세요:

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

기본 액션:

• 더 넓은 업그레이드를 즉흥적으로 만들지 마세요
• 차단 요인을 보고하고 수정이 이 가이드의 범위 밖임을 설명하세요
• 유용하다면 마이그레이션을 해제(unblock)할 가장 작은 후속 구현 작업을 설명하세요

호환성 체크리스트

모델·프롬프트 전용 업그레이드를 적용하거나 권장하기 전에 확인하세요.

1. 현재 호스트가 클라이언트 코드나 API 표면 변경 없이 gpt-5.5 모델 문자열을 받아들일 수 있는가?
2. 관련 프롬프트가 식별·편집 가능한가?
3. 호스트가 API 표면 변경, 파라미터 재작성, 프로바이더 마이그레이션, 도구 재배선이 필요할 것 같은 동작에 의존하는가?
4. 예상 수정이 프롬프트 전용인가, 아니면 구현 변경이 필요한가?
5. 프롬프트 표면이 모델 사용에 충분히 가까워 광범위한 정리 대신 타게팅된 변경을 할 수 있는가?
6. 엄격한 구조화 출력, 스키마, 다운스트림 파서가 여전히 명시적 계약을 가지는가?
7. 장기 실행 Responses 또는 도구 중심 에이전트에서, 호스트가 전조, 재생된 어시스턴트 항목, 여러 어시스턴트 메시지에 의존할 때 phase가 이미 보존되는가?
8. 지연 시간, 토큰, 가격 가정이 일반적인 모델 포지셔닝에서 추론된 것이 아니라 테스트, 현실적 스팟 체크, 기존 eval 스위트로 검증되는가?

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

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

중요:

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

범위 경계

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

• 모델 문자열 업데이트 또는 업데이트 권장
• 프롬프트 업데이트 또는 업데이트 권장
• 그러한 변경이 어디에 속하는지 이해하기 위해 코드·프롬프트 파일 검사
• 기존 Responses 흐름이 이미 phase를 보존하는지 검사
• 호환성 차단 요인 표시
• 기존 테스트, 현실적 스팟 체크, 기존 eval 스위트로 검증 제안

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

• Chat Completions 코드를 Responses로 이동
• Responses 코드를 다른 API 표면으로 이동
• SDK, API, IDE 구성, 셸 훅, 플러그인, 프로바이더별 도구링 마이그레이션
• 파라미터 형태 재작성
• 도구 정의 또는 도구 호출 처리 변경
• 구조화 출력 배선 변경
• 구현 코드에 phase 처리 추가·개조
• 모델 문자열 교체와 직접 관련된 프롬프트 편집을 제외한 비즈니스 로직, 오케스트레이션 로직, SDK 사용, IDE 구성, 셸 훅, 플러그인 통합 동작 편집

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

검증 계획

• 각 업그레이드 사용 지점을 기존 테스트, 현실적 스팟 체크, 또는 이미 사용 가능한 기존 eval 스위트로 검증하세요.
• 가능할 때 현재 GPT-5.4 기준선과 비교하세요.
• 작업 성공, 재시도 횟수, 도구 호출 횟수, 총 토큰, 지연 시간, 출력 형태, 사용자에게 보이는 품질을 확인하세요.
• 특수화된 워크플로라면 일반 출력 품질만 판단하는 대신 가장 중요한 계약을 검증하세요.
• 프롬프트 편집을 추가했다면 각 블록이 노이즈 추가가 아니라 실제 작업을 하는지 확인하세요.
• 워크플로에 다운스트림 영향이 있다면 최종 확정 전에 가벼운 검증 패스를 추가하세요.

더 알아보기 (Learn more)

• 최신 모델 프롬프팅 모범 사례를 참고하세요.
• Models에서 GPT-5.5 세부 사항을 확인하세요.