ChatGPT 커스텀 GPT 만들기 완벽 가이드 - Knowledge 업로드부터 Actions API 연동까지
ChatGPT 커스텀 GPT 만들기 완벽 가이드
OpenAI의 커스텀 GPT(Custom GPT)는 특정 목적에 맞게 ChatGPT를 커스터마이징할 수 있는 강력한 기능입니다. Knowledge 파일 업로드, Actions API 연동, 공유 설정까지 실전 워크플로우를 단계별로 안내합니다.
1단계: GPT Builder 접속 및 기본 설정
- ChatGPT 접속:
chat.openai.com에 로그인합니다. (ChatGPT Plus 또는 Team/Enterprise 플랜 필요)- GPT 생성 시작: 좌측 사이드바에서 Explore GPTs → 우측 상단 + Create 버튼을 클릭합니다.- Create 탭 vs Configure 탭: Create 탭은 대화형으로 GPT를 만들고, Configure 탭은 직접 세부 설정을 입력합니다. 정밀한 제어를 원한다면 Configure 탭을 사용하세요.
Configure 탭 핵심 필드
| 필드 | 설명 | 예시 |
|---|---|---|
| Name | GPT 이름 (검색에 노출) | 마케팅 카피라이터 |
| Description | GPT 설명 (160자 이내 권장) | 브랜드 톤에 맞는 마케팅 문구를 생성합니다 |
| Instructions | 시스템 프롬프트 (GPT 행동 규칙) | 아래 예시 참조 |
| Conversation starters | 사용자에게 보여줄 시작 질문 | 블로그 제목 5개 만들어줘 |
당신은 B2B SaaS 마케팅 전문 카피라이터입니다.
역할
- 브랜드 가이드라인에 맞는 마케팅 문구 생성
- SEO 최적화된 블로그 제목 및 메타 설명 작성
- A/B 테스트용 변형 카피 제안
규칙
- 항상 한국어로 답변합니다
- 전문 용어는 영문 병기합니다 (예: 전환율(Conversion Rate))
- 문구는 3개 이상의 변형을 제공합니다
Knowledge에 업로드된 브랜드 가이드를 우선 참조합니다
2단계: Knowledge 파일 업로드
Knowledge 기능은 GPT에 참조 문서를 제공하여 RAG(Retrieval-Augmented Generation) 방식으로 정확한 답변을 생성하게 합니다.
- Configure 탭에서 **Knowledge** 섹션의 *Upload files*를 클릭합니다.- 지원 파일 형식: .pdf, .txt, .docx, .csv, .json, .md 등- 파일당 최대 512MB, GPT당 최대 20개 파일 업로드 가능합니다.- 업로드 후 Instructions에 파일 참조 지시를 추가합니다.## Knowledge 활용 규칙
- 사용자 질문에 답할 때 반드시 업로드된 문서를 먼저 검색합니다
- 문서에 없는 내용은 "제공된 자료에는 해당 내용이 없습니다"라고 안내합니다
- 답변 시 참조한 문서명을 명시합니다
### Knowledge 파일 최적화 팁
- **파일 구조화:** 마크다운 형식으로 제목과 섹션을 명확히 구분하면 검색 정확도가 높아집니다.- **청크 크기 고려:** 하나의 거대한 파일보다 주제별로 분리된 여러 파일이 더 효과적입니다.- **메타데이터 포함:** 파일 상단에 문서 제목, 작성일, 카테고리를 명시하세요.
## 3단계: Actions API 연동
Actions는 GPT가 외부 API를 호출할 수 있게 해주는 기능입니다. OpenAPI 스키마를 정의하여 실시간 데이터 조회, 외부 서비스 연동이 가능합니다.
- Configure 탭 하단의 **Create new action**을 클릭합니다.- Authentication 방식을 설정합니다: None, API Key, OAuth 중 선택합니다.- OpenAPI 스키마를 입력합니다.
### OpenAPI 스키마 예시 (날씨 API 연동)
{
"openapi": "3.1.0",
"info": {
"title": "Weather API",
"version": "1.0.0",
"description": "현재 날씨 정보를 조회합니다"
},
"servers": [
{
"url": "https://api.weatherapi.com/v1"
}
],
"paths": {
"/current.json": {
"get": {
"operationId": "getCurrentWeather",
"summary": "현재 날씨 조회",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "API 키"
},
{
"name": "q",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "도시명 (예: Seoul)"
}
],
"responses": {
"200": {
"description": "날씨 정보 반환"
}
}
}
}
}
}
### API Key 인증 설정
- Authentication 드롭다운에서 **API Key**를 선택합니다.- API Key 값에 YOUR_API_KEY를 입력합니다.- Auth Type은 **Custom**을 선택하고, Custom Header Name에 X-Api-Key를 입력합니다.- **Privacy policy URL**을 입력합니다. (공개 GPT 필수)
### Actions 디버깅
스키마 입력 후 하단의 **Test** 버튼으로 각 엔드포인트를 직접 호출하여 응답을 확인할 수 있습니다. 정상 동작하면 Preview에서 GPT와 대화하며 API 연동을 검증하세요.
4단계: Capabilities 설정
- Web Browsing: 실시간 웹 검색 허용 여부- DALL·E Image Generation: 이미지 생성 허용 여부- Code Interpreter & Data Analysis: 코드 실행 및 파일 분석 허용 여부목적에 맞게 필요한 기능만 활성화하세요. 불필요한 기능을 끄면 GPT가 핵심 역할에 더 집중합니다.
5단계: 공유 및 배포 설정
- 우측 상단 Save 버튼 옆 드롭다운을 클릭합니다.- 공유 범위를 선택합니다:
GPT Store 공개 시 프로필에 실명 또는 확인된 도메인이 표시되며, OpenAI의 사용 정책을 준수해야 합니다.옵션 설명 사용 사례 Only me 본인만 사용 가능 개인 생산성 도구 Anyone with a link 링크를 가진 누구나 사용 가능 팀 내부 공유, 베타 테스트 Everyone GPT Store에 공개 공개 배포, 수익화
Pro Tips: 파워 유저를 위한 고급 팁
- 버전 관리: Instructions를 별도 문서로 관리하고 변경 이력을 추적하세요. Git 등의 버전 관리 도구 활용을 권장합니다.- 프롬프트 체이닝: Conversation starters에 복잡한 워크플로우의 첫 단계를 넣어 사용자를 자연스럽게 안내하세요.- 다중 Actions: 하나의 GPT에 여러 Action을 등록하여 복합적인 워크플로우(예: CRM 조회 → 이메일 초안 작성 → 캘린더 등록)를 구현할 수 있습니다.- 피드백 루프: Instructions에
사용자에게 결과 만족도를 물어보세요를 추가하면 사용자 피드백을 통해 지속적으로 개선할 수 있습니다.- Knowledge 갱신: 문서가 업데이트되면 기존 파일을 삭제하고 새 파일을 업로드하세요. 파일명을 동일하게 유지하면 Instructions 수정이 불필요합니다.
Troubleshooting: 자주 발생하는 오류와 해결법
| 오류 상황 | 원인 | 해결 방법 |
|---|---|---|
Action 호출 시 Could not connect | 서버 URL 오류 또는 CORS 설정 문제 | servers URL을 확인하고, API 서버에서 OpenAI IP 대역을 허용하세요 |
| Knowledge 파일이 검색되지 않음 | 파일 형식 문제 또는 내용이 너무 적음 | 파일을 마크다운이나 텍스트 형식으로 변환하고 충분한 컨텍스트를 포함하세요 |
| API Key 인증 실패 | Header 이름 불일치 또는 키 만료 | API 문서에서 정확한 Header 이름을 확인하고 유효한 키를 재입력하세요 |
| GPT가 Instructions를 무시함 | Instructions가 너무 길거나 모호함 | 핵심 규칙을 상단에 배치하고, 구체적인 예시와 함께 간결하게 작성하세요 |
파일 업로드 시 File too large | 512MB 초과 | 파일을 분할하거나 불필요한 내용을 제거하여 크기를 줄이세요 |
Q1: 커스텀 GPT를 만들려면 유료 플랜이 필요한가요?
네, 커스텀 GPT 생성은 ChatGPT Plus($20/월), Team($25/월/인), 또는 Enterprise 플랜 구독자만 이용할 수 있습니다. 단, 공유된 GPT를 사용하는 것은 무료 사용자도 가능합니다 (일부 제한 있음).
Q2: Actions API에서 OAuth 인증은 어떻게 설정하나요?
Authentication에서 OAuth를 선택한 후 Client ID, Client Secret, Authorization URL, Token URL을 입력합니다. OAuth 2.0의 Authorization Code 흐름을 지원하며, 사용자가 GPT를 처음 사용할 때 인증 팝업이 표시됩니다. Redirect URL은 OpenAI가 제공하는 콜백 URL을 OAuth 앱에 등록해야 합니다.
Q3: Knowledge에 업로드한 파일은 안전한가요?
업로드된 파일은 해당 GPT 내에서만 사용되며 OpenAI의 데이터 보호 정책이 적용됩니다. 다만, GPT를 공개(Everyone)로 설정하면 사용자의 질문을 통해 파일 내용이 간접적으로 노출될 수 있으므로, 민감한 정보는 업로드하지 않는 것이 안전합니다. Team 및 Enterprise 플랜에서는 추가적인 데이터 보호 옵션을 제공합니다.