GPT-6.2 사용하기
TMThttps://developers.openai.com/api/docs/guides/latest-model?model=gpt-6-astra
가장 까다로운 작업에는 GPT-6.2 Astra를 사용하세요. 복잡한 작업을 더 낮은 비용으로 처리하려면 GPT-6.2 Sol을 사용하세요.
변경 사항
- 접두부 편집. GPT-6.2부터 Responses API는 대화 도중 앞선 대화 기록을 수정하거나, 하위 모델로 전환하는 등 일부 모델을 변경하거나, 최종 사용자 또는 조직을 바꾸면 추론 항목을 제외합니다. 모델이 추론 항목을 참조할 수 없게 되면 답변 품질이 떨어질 수 있고, 앞서 한 작업을 반복하느라 토큰을 더 사용할 수도 있습니다. 연동 코드를 검토해 이전 개발자 메시지나 도구 호출을 바꾸는 등 기록을 수정하는 부분이 있는지 확인하세요. 추론 항목을 유지하고 이전 입력에 프롬프트 캐싱을 적용할 수 있도록, 응답 사이에 설정을 바꾸더라도 접두부는 그대로 유지하세요.
- Responses API의
instructions필드 변경. GPT-6.2부터 Responses API를 사용하는 모델은 최상위instructions를input뒤에 붙입니다. 반복해서 쓰는 지침에 프롬프트 캐싱을 적용하려면 지침을developer메시지에 담아input의 첫 항목으로 넣으세요. 최상위instructions에는 현재 요청에만 적용되는 개발자 지침을 넣으세요. 자세한 내용은 접두부 일치 방식을 참고하세요.
프롬프트 작성 권장 사항
아래 예시를 GPT-6.2 모델군의 프롬프트를 작성할 때 참고하세요. GPT-6.2 Astra와 Sol을 사용하면서 관찰한 동작을 바탕으로 만든 예시입니다. 애플리케이션에서 같은 동작이 나타나면 해당 항목의 프롬프트를 써 보세요.
GPT-6.2 Astra의 응답 특성
글쓰기 스타일
GPT-6.2 Astra는 이전 모델보다 기본적으로 간결하고 직접적으로 답합니다. 전문적인 동료처럼 말할 수도, 좀 더 대화하듯 답하는 어시스턴트처럼 말할 수도 있도록 애플리케이션에 맞게 어조를 조정할 수 있습니다.
일상 업무에서 모델과 협업하고 함께 생각을 정리하고 싶다면 다음 프롬프트를 사용하세요.
사용자와 출처에서 쓰는 용어로 작성하세요. 기술적 세부 사항을 유지하고, 설명을 더 정확하게 전달할 수 있다면 해당 분야의 전문 용어를 쓰세요. 능동형 문장을 쓰고, 서로 밀접한 내용은 함께 배치하세요. 핵심을 앞에서 전달하고, 뒤를 읽어야만 뜻을 알 수 있는 표현은 피하세요. 사용자가 판단의 근거를 따라갈 수 있도록 필요한 맥락을 설명하세요.문서, 이메일, 메시지, 외부 게시물 등을 작성할 때는 누가 읽을지 고려해 글을 쓰도록 요청하세요.
사용자를 대신해 외부 독자에게 보낼 메시지나 자료를 작성할 때는 누가 읽을지 생각하고 그 독자에 맞게 쓰세요. 독자는 사용자와 같은 배경을 공유하지 않을 가능성이 크므로, 내용을 이해하는 데 필요한 배경이나 근거를 설명하세요. 기존 글을 검토하거나 편집할 때는 작성자의 내용과 표현을 살리고, 사용자가 요청한 수정 범위와 방향을 세심하게 따르세요.오래 걸리는 작업에서는 모델이 추론 과정에서 쓰거나 다른 에이전트에게서 받은 약식 표현을 최종 답변에 그대로 넣을 수 있습니다. 진행 상황을 지켜보지 않은 사람도 답변만 읽으면 이해할 수 있도록 쓰라고 알려 주세요.
최종 답변은 사용자가 작업 결과를 처음 접하는 글로 생각하고 작성하세요. 최종 답변을 표시할 때는 앞선 진행 메시지가 접힌 상태이므로, 사용자가 그 메시지를 읽지 않고도 내용을 모두 이해할 수 있어야 합니다.
최종 답변과 사람이 읽을 다른 모든 자료는 의도한 독자에 맞게 새로 쓰세요. 추론 과정의 문장을 그대로 가져오거나 비슷하게 옮기거나, 그 글투를 답습하지 마세요. 추론, 도구 호출, 서브에이전트나 자동화에 내린 지시에서 사용한 작업용 약식 표현이나 전문 용어, 약어를 옮겨 쓰지 마세요.작업 완료
사용자가 지켜보지 않아도 진행할 수 있는 작업이라면, 모델이 어떤 결과까지 완성해야 하는지와 어떤 결정에 사용자 의견이 필요한지를 명시하세요.
작업이 끝나지 않았거나 권한 범위 안에서 진행할 다음 단계가 있다면, 응답을 마치지 말고 작업 범위 안에서 필요한 조치를 이어 가세요. 응답을 끝내면서 다음 단계나 계획을 제안하거나, 통상적인 결정을 사용자에게 맡기거나, 사용자가 실행할 작업을 안내하는 식으로 넘기려 한다면, 그 단계를 직접 수행해 사용자가 요청한 결과에 다가가세요. 실행 권한이 있는지 확인하고, 어떤 가정을 했거나 어떤 결정을 내렸는지 사용자에게 알리세요.
작업 범위가 크게 바뀌거나, 실제로 진행이 막혔거나, 사용자가 결정해야 할 사안이 있거나, 되돌릴 수 없거나 데이터를 손상시킬 수 있는 조치를 앞둔 경우에만 멈추고 사용자에게 확인하세요.요청한 작업을 완료했는지 모델이 직접 확인하도록 하세요. 복잡하거나 오래 걸리는 작업에서는 추론 강도를 높이면 마지막 검증까지 이어 가는 데 도움이 됩니다. Responses API에서는 reasoning.effort로 강도를 설정합니다. 자세한 내용은 추론 강도를 참고하세요.
실행을 우선하고 사용자가 요청한 작업을 끝까지 완료하세요. 작업이 끝나지 않았거나 권한 범위 안에서 진행할 다음 단계가 있다면, 응답을 마치지 말고 작업 범위 안에서 필요한 조치를 이어 가세요. 요청의 모든 부분을 빠짐없이 다뤘는지 확인하고, 사용자의 목표를 온전히 충족하는 결과를 제공할 때까지 계속 진행하세요. 시간이 걸리는 작업이라도 의도한 결과를 완전히 달성할 때까지 필요한 일을 모두 수행하세요.
명백히 파괴적이거나 되돌릴 수 없는 작업을 제외하면 사용자의 목표를 향해 스스로 진행하세요. 필요하다면 격리된 워크트리나 체크아웃을 만들고, 병합 충돌을 해결하거나, 초안 PR을 만드는 등의 조치를 취하세요. 응답을 마치거나 작업을 완료했다고 알리기 전에 결과가 사용자의 요청을 모두 충족하는지 확인하세요. 남은 단계나 검증할 부분이 있다면 끝까지 처리한 뒤 마무리하세요.세부 사항이 불분명할 때는 모델이 어떤 가정을 했는지 밝히고 작업을 계속할 수 있도록 하세요.
작업을 진행하기 위해 합리적이며 되돌릴 수 있는 가정을 하세요. 그 가정이 작업 범위 안에서 진행에 도움이 된다면 어떤 가정을 했는지 밝히세요. 진행할 방법이 있다면 판단을 되짚느라 머뭇거리거나, 무엇을 할 수 있는지 설명하거나, 작업을 해 주겠다고 제안하거나, 부분 답변을 내놓는 데서 멈추지 마세요.애플리케이션에 request_user_input_async 같은 비동기 도구가 있으면 GPT-6.2는 사용자에게 확인을 요청한 뒤, 답변을 기다리는 동안에도 그 답변과 무관한 작업을 계속할 수 있습니다. 자세한 내용은 비동기 질문 도구 추가하기를 참고하세요.
코딩 스타일
코드베이스의 관례와 기존 호출 코드가 의존하는 동작을 설명하세요. 예를 들어 기존 로직을 언제 재사용할지, 변경 범위를 어디까지로 제한할지, 기존 테스트가 다루지 않는 동작에 언제 테스트를 추가할지 명시하세요.
사용자의 요청을 완전히 충족하는 정확하고 품질 높은 코드를 작성하세요. 다른 사람이 코드를 쉽게 읽을 수 있도록 하고, 결과가 사용자의 의도대로 동작하는지 확인하세요. 코드를 작성할 때는 다음 지침을 따르세요.
(a) 가능한 경우 사용자 저장소의 기존 로직을 재사용하세요. 정확성이 유지된다면 코드베이스의 기존 클래스, 메서드, 데이터 표현, API를 재사용하세요. 코드를 통합하거나 제거할 때는 이번 작업에서 변경해야 하는 동작을 제외하고, 호출 코드가 의존하는 동작을 유지하세요.
(b) 사용자가 요청했거나, 저장소 규칙에서 요구하거나, 기존 테스트가 포착하지 못하는 특정 회귀를 잡아야 할 때 새 테스트를 추가하세요.
(c) 사람이 읽기 쉬운 코드를 작성하세요. 줄 수나 변수명을 줄이고, 공백을 없애거나, 여러 동작을 한 줄에 몰아넣는다고 코드가 단순해지는 것은 아닙니다. 주석과 변수명은 사람이 읽고 뜻을 파악하기 쉽게 쓰세요. 코드를 최대한 짧게 줄인 표현에 여러 분기나 조건, 암묵적인 가정이 숨어 있다면 지나치게 복잡한 코드입니다.
(d) 불필요한 간접 참조와 추상화는 피하세요. 보조 함수, 유틸리티 함수, 클래스 추상화는 분기를 늘리지 않더라도 코드를 이해하기 어렵게 만들 수 있습니다.프런트엔드 디자인
애플리케이션에 특정한 시각 스타일이 필요하다면 프롬프트에 설명하세요. 어떤 유형의 이미지를 쓰고 어떤 타이포그래피를 따를지, 특정 글꼴이 중요하다면 그 이름까지 지정하세요. 인터페이스 문구에는 사용자가 알아야 하거나 해야 할 일에 필요한 내용을 담으세요.
프런트엔드 인터페이스가 있는 웹페이지나 앱을 만들 때는 다음 지침을 따르세요.
- 시각 자료를 고를 때는 일반적으로 프로젝트의 스타일과 목적에 맞는 사실적인 이미지를 사용하세요. ImageGen으로 만들거나 이미지 검색으로 찾을 수 있습니다. 사용자가 SVG를 명시적으로 요청했다면 SVG를 사용하세요.
- 사용자가 알아야 할 정보를 전달하거나, 탐색이나 조작을 돕거나, 명시적으로 요청한 내용을 담는 경우에만 텍스트 요소를 넣으세요. 장식용 번호, 별다른 정보를 주지 않는 배지, 중복 제목, 주변 인터페이스만 봐도 알 수 있는 내용을 되풀이하는 문구는 빼세요. 필요한 레이블, 안내, 상태 피드백은 유지하세요.시각 자료를 만들 때는 디자인 도구에서 가져온 참고 이미지를 공유하거나, GPT-6.2에서 이미지 생성 도구를 사용할 수 있게 한 뒤 GPT Image로 참고 이미지를 만들도록 요청하세요. 참고 이미지로 말로 설명하기 어려운 세부 사항을 프롬프트에 보탤 수 있습니다. 원하는 모습이 참고 이미지에 담겼다면 모델에 실제로 쓸 자료를 만들고 렌더링한 뒤, 참고 이미지와 비교해 다듬으라고 하세요.
빠른 마이그레이션 가이드
코딩 에이전트로 API 애플리케이션을 GPT-6.2 Astra로 전환하려면 OpenAI Docs 스킬을 사용하세요.
API 및 모델 매개변수 업데이트
model을 gpt-6.2-astra 또는 gpt-6.2-sol로 설정한 뒤 아래 항목을 확인하세요.
- 추론 강도. 새로 연동한다면
medium으로 시작하세요. 현재none이나minimal을 사용한다면low로 바꾸세요. Responses에서는reasoning.effort를, Chat Completions에서는reasoning_effort를 사용하세요. - 도구 호출. 도구를 호출하려면 Responses API를 사용하세요. GPT-6.2 Astra와 GPT-6.2 Sol은 Chat Completions를 지원하며, 도구 호출은 Responses에서 사용할 수 있습니다.
- 지원하지 않는 매개변수. Chat Completions 요청을 마이그레이션할 때는
temperature,top_p,logprobs,top_logprobs를 빼세요. Responses 요청에서는temperature,top_p,top_logprobs를 빼고,include에서message.output_text.logprobs를 제거하세요. - 프롬프트 캐싱. 변경 없이 반복해서 쓰는 지침을 최상위
instructions매개변수에서input의 첫 번째developer메시지로 옮겨 캐싱을 적용할 수 있게 하세요. GPT-5.5 또는 그 이전 모델에서 전환하는 경우prompt_cache_retention을prompt_cache_options.ttl로 바꾸고 값은"30m"으로 설정하세요. 캐시 적용 범위와 캐시 쓰기 요금 등 프롬프트 캐싱 변경 사항을 검토하세요. - 제로 데이터 보존. GPT-6.2 Astra와 Sol은 승인받은 조직이 적용 대상 엔드포인트와 기능을 사용할 때 제로 데이터 보존(Zero Data Retention, ZDR)을 지원합니다. ZDR을 활성화하면 Responses API는
store를false로 처리합니다. 여러 차례 요청을 주고받는 작업에서는 암호화된 추론 항목을 포함해 앞서 받은 출력 항목을 순서대로 다시 전달하세요. 적용 자격과 엔드포인트의 동작은 제로 데이터 보존을 참고하세요. - 서비스 등급 및 리전. 두 모델 모두 Standard, Fast, Batch 처리에서 미국과 유럽연합(EU)의 데이터 레지던시를 지원합니다. Ultrafast는 미국에서만 데이터 레지던시를 지원합니다. 자세한 내용은 데이터 레지던시와 가격을 참고하세요.
- 프롬프트 작성. 프롬프트 작성 방법은 프롬프트 작성 권장 사항을 참고하세요.