GPT-5 프롬프팅 가이드

📋 GPT-5 개요

주요 개선사항

GPT-5는 에이전트 작업 성능, 코딩, 순수 지능, 조향성에서 상당한 도약을 이뤘습니다.

🛠️ 향상된 도구 호출

더 정확하고 효율적인 API 호출과 도구 사용

📝 정밀한 지시 따르기

외과적 정밀도로 프롬프트 지시사항 준수

🧠 장문맥 이해

긴 대화와 복잡한 맥락에서도 뛰어난 성능

🔄 Responses API

도구 호출 간 추론 맥락 유지로 효율성 향상

🤖 에이전트 워크플로우 제어

핵심 매개변수

reasoning_effort

minimal: 빠른 응답, 간단한 작업
medium: 균형잡힌 성능 (기본값)
high: 복잡한 다단계 작업

verbosity

추론 길이와 독립적으로 최종 답변의 길이 조절

에이전트 적극성 조절

🔽 덜 적극적으로 만들기

낮은 reasoning_effort 사용
탐색 깊이를 줄여 효율성과 지연시간 개선

<context_gathering> 목표: 빠르게 충분한 맥락 수집. 병렬 탐색 후 행동 가능하면 즉시 중단. 방법: - 넓게 시작한 후 집중된 하위 쿼리로 확장 - 병렬로 다양한 쿼리 실행, 쿼리별 상위 결과 읽기 - 과도한 맥락 검색 방지 조기 중단 기준: - 변경할 정확한 내용을 명명할 수 있을 때 - 상위 결과의 ~70%가 한 영역/경로에 수렴할 때 </context_gathering>

🔼 더 적극적으로 만들기

높은 reasoning_effort 사용
모델 자율성 증가, 도구 호출 지속성 향상

<persistence> - 당신은 에이전트입니다 - 사용자의 쿼리가 완전히 해결될 때까지 계속 진행하세요 - 문제가 해결되었다고 확신할 때만 턴을 종료하세요 - 불확실성을 만났을 때 중단하거나 사용자에게 돌리지 마세요 - 가장 합리적인 가정을 결정하고 진행하세요 </persistence>

도구 프리앰블

사용자 경험 개선을 위해 도구 호출 전 명확한 계획과 지속적인 진행 상황 업데이트 제공:

<tool_preambles> - 도구를 호출하기 전에 항상 사용자의 목표를 친근하고 명확하며 간결하게 재구성 - 즉시 따를 각 논리적 단계를 상세히 설명하는 구조화된 계획 개요 작성 - 파일 편집 실행 시 각 단계를 간결하고 순차적으로 설명 - 사전 계획과 구별되게 완료된 작업 요약으로 마무리 </tool_preambles>

💻 코딩 성능 최대화

GPT-5 코딩 역량

대규모 코드베이스에서 버그 수정, 대용량 diff 처리, 다파일 리팩토링, 새로운 앱 전체 구현까지 모든 프론트엔드 모델을 선도합니다.

🎨 프론트엔드 개발 권장사항

프레임워크

Next.js (TypeScript)
React
HTML

스타일링/UI

Tailwind CSS
shadcn/ui
Radix Themes

아이콘

Material Symbols
Heroicons
Lucide

애니메이션 & 폰트

Motion (애니메이션)
Inter, Geist, IBM Plex Sans

🚀 제로-투-원 앱 생성

<self_reflection> - 먼저 확신할 수 있을 때까지 루브릭을 생각하는 시간을 가지세요 - 세계적 수준의 원샷 웹앱을 만드는 모든 측면을 깊이 생각하세요 - 5-7개 카테고리를 가진 루브릭을 생성하세요 - 루브릭을 사용해 제공된 프롬프트에 대한 최상의 솔루션을 내부적으로 반복하세요 </self_reflection>

📋 코드베이스 설계 표준 매칭

<code_editing_rules> <guiding_principles> - 명확성과 재사용: 모든 컴포넌트와 페이지는 모듈화되고 재사용 가능해야 함 - 일관성: 색상 토큰, 타이포그래피, 간격, 컴포넌트가 통일된 디자인 시스템 준수 - 단순성: 작고 집중된 컴포넌트 선호, 불필요한 복잡성 방지 </guiding_principles> </code_editing_rules>

⚡ 지능과 지시 따르기 최적화

🎯 조향성 (Steering)

GPT-5는 가장 조향 가능한 모델로, 상세함, 톤, 도구 호출 동작에 관한 프롬프트 지시사항에 매우 민감하게 반응합니다.

📝 상세함 제어

API 매개변수

verbosity: 추론 길이가 아닌 최종 답변의 길이 제어

자연어 상세함 재정의를 통해 특정 맥락에서 전역 기본값에서 벗어날 수 있습니다.

⚠️ 지시 따르기 주의사항

모순되거나 모호한 지시사항 방지
GPT-5는 지시사항을 외과적 정밀도로 따르므로, 잘못 구성된 프롬프트가 다른 모델보다 더 해로울 수 있습니다.

🔍 문제가 되는 프롬프트 예시

❌ 모순된 지시사항: - "명시적 환자 동의 없이는 절대 예약하지 마세요" - "고위험 사례에서는 환자 연락 없이 당일 슬롯 자동 배정" ✅ 수정된 버전: - "고위험 사례에서는 환자에게 행동을 알린 후 당일 슬롯 배정" - "응급상황에서는 조회하지 말고 즉시 911 안내 제공"

⚡ 최소 추론 (Minimal Reasoning)

지연시간에 민감한 사용자를 위한 최고의 업그레이드

여전히 추론 모델 패러다임의 이점을 누리면서도 가장 빠른 옵션

최소 추론에서의 핵심 포인트:

최종 답변 시작 시 간단한 사고 과정 요약 요청
철저하고 설명적인 도구 호출 프리앰블 요청
도구 지시사항을 최대한 명확하게 구분
명시적 계획 프롬프팅이 더욱 중요

🎯 베스트 프랙티스 요약

1. Responses API 사용

다회전 에이전트 작업에서 성능 향상 (73.9% → 78.2%)

2. reasoning_effort 조정

작업 복잡성에 따라 적절한 추론 수준 선택

3. 명확한 지시사항

모순되지 않는 명확하고 구조화된 프롬프트 작성

4. XML 태그 활용

구조화된 프롬프트로 더 나은 지시사항 준수

5. 메타-프롬프팅

GPT-5를 사용해 기존 프롬프트 최적화

6. 맥락별 상세함 제어

다양한 맥락에서 적절한 verbosity 적용

🛠️ 실용적인 팁

마크다운 포맷팅: 의미적으로 올바른 곳에서만 마크다운 사용
긴 대화: 3-5 사용자 메시지마다 마크다운 지시사항 추가
도구 예산: 필요시 고정 도구 호출 예산 설정
진행 상황 업데이트: 사용자 경험을 위한 명확한 도구 프리앰블

🔧 메타-프롬프팅 템플릿

프롬프트 최적화를 요청받으면, 자신의 관점에서 답변하세요 - 원하는 동작을 더 일관되게 이끌어내거나 원하지 않는 동작을 방지하기 위해 이 프롬프트에 추가하거나 삭제할 수 있는 구체적인 문구를 설명하세요. 프롬프트: [PROMPT] 이 프롬프트의 원하는 동작: [원하는 동작] 대신 하는 동작: [원하지 않는 동작] 기존 프롬프트를 최대한 유지하면서, 이러한 단점을 더 일관되게 해결하도록 권장하는 최소한의 편집/추가는 무엇인가요?