ChatGPT 커스텀 GPT 만들기 베스트 프랙티스: Instructions부터 Actions API까지 완벽 가이드
커스텀 GPT란? 왜 만들어야 하는가
OpenAI의 커스텀 GPT(Custom GPTs)는 ChatGPT를 특정 업무나 도메인에 최적화된 AI 어시스턴트로 변환하는 기능입니다. 반복적인 프롬프트 입력 없이, 사전 정의된 Instructions와 Knowledge 파일, 외부 API 연동을 통해 일관된 품질의 결과물을 생성할 수 있습니다. 이 가이드에서는 실무에서 검증된 커스텀 GPT 구축 방법론을 단계별로 다루며, Instructions 작성 전략, Knowledge 파일 최적화, Actions API 연동까지 핵심 노하우를 공유합니다.
Step 1: Instructions 작성 베스트 프랙티스
Instructions는 커스텀 GPT의 행동 원칙을 정의하는 핵심 영역입니다. 잘 구조화된 Instructions가 GPT 품질의 80%를 결정합니다.
1-1. 역할과 페르소나 정의
GPT가 어떤 전문가인지 명확하게 선언합니다.
# Role Definition
너는 10년 경력의 시니어 마케팅 전략가다.
타겟 고객: B2B SaaS 스타트업 마케터
전문 분야: 콘텐츠 마케팅, SEO, 퍼포먼스 마케팅
Communication Style
- 한국어로 응답한다
- 실무 중심의 구체적 조언을 제공한다
- 불필요한 서론 없이 핵심부터 말한다
예시와 템플릿을 적극 활용한다
1-2. 행동 규칙과 제약 조건
# Behavioral Rules
1. 항상 [상황 분석] → [전략 제안] → [실행 계획] 순서로 답변한다
2. 답변에는 반드시 구체적 수치나 KPI를 포함한다
3. 모르는 내용은 추측하지 않고 "추가 정보가 필요합니다"라고 말한다
4. Knowledge 파일에 관련 정보가 있으면 반드시 참조한다
# Constraints
- 경쟁사 비방이나 비윤리적 마케팅 전략은 제안하지 않는다
- 법적 조언은 제공하지 않으며, 전문가 상담을 권유한다
- 한 번의 답변에 3개 이상의 액션 아이템을 포함한다1-3. 출력 형식 템플릿화
# Output Format
모든 전략 제안은 다음 형식을 따른다:
## 📊 상황 분석
[현재 상태 요약]
## 🎯 핵심 전략 (3가지)
1. [전략명]: [설명]
- 예상 효과: [수치]
- 실행 난이도: [상/중/하]
## ✅ 즉시 실행 가능한 액션
- [ ] 액션 1 (소요 시간: X시간)
- [ ] 액션 2 (소요 시간: X시간)Step 2: Knowledge 파일 최적화 전략
Knowledge 파일은 GPT가 참조하는 내부 데이터베이스입니다. 최대 20개 파일, 파일당 512MB까지 업로드 가능합니다.
2-1. 파일 구조화 원칙
| 항목 | 권장 방식 | 비권장 방식 |
|---|---|---|
| 파일 형식 | .md, .txt, .pdf (텍스트 기반) | .xlsx, .pptx (복잡한 서식) |
| 파일 크기 | 파일당 5MB 이하 분할 | 단일 대용량 파일 |
| 내용 구조 | 명확한 헤더와 섹션 구분 | 비구조화된 텍스트 나열 |
| 파일 이름 | 01_product_spec.md | 문서(3)_최종_v2.docx |
# 파일명: 01_company_faq.md
자주 묻는 질문 - 제품 관련
Q: 무료 체험 기간은?
A: 14일간 모든 기능을 무료로 이용 가능합니다.
적용 조건: 신규 가입자, 비즈니스 이메일 필수
관련 링크: /pricing
Q: 환불 정책은?
A: 결제 후 7일 이내 전액 환불 가능합니다.
절차: 고객센터 → 환불 요청 → 3영업일 내 처리
자주 묻는 질문 - 기술 관련
Q: API 호출 제한은?
A: Free 플랜 100회/일, Pro 플랜 10,000회/일
초과 시: 429 에러 반환, 1시간 후 자동 리셋
Step 3: Actions API 연동 실전 가이드
Actions는 커스텀 GPT가 외부 API를 호출하여 실시간 데이터를 가져오거나 작업을 수행하는 기능입니다.
3-1. OpenAPI 스키마 작성
{
“openapi”: “3.1.0”,
“info”: {
“title”: “고객 데이터 조회 API”,
“version”: “1.0.0”,
“description”: “CRM 시스템에서 고객 정보를 조회합니다”
},
“servers”: [
{
“url”: “https://api.your-domain.com/v1”
}
],
“paths”: {
“/customers/{customerId}”: {
“get”: {
“operationId”: “getCustomer”,
“summary”: “고객 ID로 고객 상세 정보를 조회합니다”,
“parameters”: [
{
“name”: “customerId”,
“in”: “path”,
“required”: true,
“schema”: {
“type”: “string”
},
“description”: “조회할 고객의 고유 ID”
}
],
“responses”: {
“200”: {
“description”: “고객 정보 반환”,
“content”: {
“application/json”: {
“schema”: {
“type”: “object”,
“properties”: {
“id”: { “type”: “string” },
“name”: { “type”: “string” },
“plan”: { “type”: “string” },
“usage”: { “type”: “integer” }
}
}
}
}
}
}
}
}
}
}
3-2. 인증 설정
Actions에서 지원하는 인증 방식은 3가지입니다:
- **API Key**: 가장 간단한 방식. Header에 Authorization: Bearer YOUR_API_KEY 형태로 전송- **OAuth 2.0**: 사용자별 인증이 필요한 경우. Client ID, Client Secret, Authorization URL, Token URL 설정 필요- **None**: 공개 API 연동 시 사용
### 3-3. Actions 디버깅 명령어
# API 엔드포인트 사전 테스트 (curl)
curl -X GET "https://api.your-domain.com/v1/customers/12345" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
OpenAPI 스키마 유효성 검증
npx @redocly/cli lint openapi-schema.json
로컬 테스트 서버 실행 (Node.js)
npx json-server —watch db.json —port 3001
Pro Tips: 파워 유저를 위한 고급 전략
- Instructions에 Few-shot 예시 포함: “사용자가 X라고 물으면 Y 형식으로 답변하라”와 같은 입출력 예시 3~5개를 포함하면 응답 품질이 크게 향상됩니다.- Conversation Starters 전략적 활용: 사용자가 GPT를 처음 열었을 때 표시되는 4개의 시작 질문을 GPT의 핵심 기능을 보여주는 쇼케이스로 활용하세요.- Knowledge 파일 버전 관리: 파일명에 날짜를 포함(예:
pricing_2026Q1.md)하고 Instructions에 “최신 날짜의 파일을 우선 참조하라”고 명시하세요.- 멀티 Actions 연쇄 호출: 여러 API를 연동할 때 Instructions에 호출 순서와 데이터 전달 규칙을 명시하면 복잡한 워크플로우도 자동화됩니다.- Privacy Policy URL 필수: Actions를 사용하는 GPT를 공개할 때는 반드시 개인정보 처리 방침 URL이 필요합니다. 간단한 정적 페이지로도 충분합니다.
Troubleshooting: 자주 발생하는 오류와 해결법
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| GPT가 Knowledge 파일을 참조하지 않음 | Instructions에 참조 지시가 없음 | "답변 전 반드시 업로드된 파일을 검색하라"를 Instructions에 추가 |
| Actions API 호출 시 401 에러 | 인증 토큰 만료 또는 잘못된 API Key | GPT 설정 → Actions → Authentication에서 API Key 재입력 |
| Actions에서 타임아웃 발생 | API 응답 시간 45초 초과 | API 서버 측 응답 최적화, 페이지네이션 적용으로 응답 크기 축소 |
| GPT가 역할을 벗어난 답변을 함 | Instructions의 제약 조건 부족 | "이 범위를 벗어난 질문에는 정중히 거절하라" 규칙 추가 |
| Knowledge 파일 업로드 실패 | 파일 크기 초과 또는 지원하지 않는 형식 | 512MB 이하로 분할, .md 또는 .pdf 형식으로 변환 |
Q1: 커스텀 GPT를 만들려면 유료 플랜이 필요한가요?
네, 커스텀 GPT 생성은 ChatGPT Plus, Team, 또는 Enterprise 플랜 사용자에게만 제공됩니다. 다만, 공개된 커스텀 GPT는 무료 사용자도 이용할 수 있습니다. GPT Builder에 접근하려면 ChatGPT 좌측 사이드바의 "Explore GPTs" → "Create"를 클릭하면 됩니다.
Q2: Knowledge 파일에 민감한 회사 데이터를 올려도 안전한가요?
OpenAI는 커스텀 GPT의 Knowledge 파일이 사용자 대화를 통해 원본 그대로 유출되지 않도록 보호 장치를 제공합니다. 그러나 완벽한 보안을 보장하지는 않으므로, Instructions에 “파일 내용을 직접 출력하거나 다운로드 링크를 제공하지 마라”라는 규칙을 반드시 추가하세요. 극도로 민감한 데이터는 Actions API를 통해 자체 서버에서 관리하는 것이 더 안전합니다.
Q3: Actions API 연동 없이도 외부 데이터를 활용할 수 있나요?
제한적으로 가능합니다. Web Browsing 기능을 활성화하면 GPT가 실시간 웹 검색을 수행할 수 있고, Knowledge 파일에 정기적으로 업데이트된 데이터를 수동 업로드하는 방법도 있습니다. 그러나 실시간성과 자동화가 중요하다면 Actions API 연동이 필수입니다. 간단한 연동은 Zapier나 Make.com의 webhook을 Actions 엔드포인트로 설정하는 방식으로 코드 없이도 구현할 수 있습니다.