제품 가이드
스튜디오
요약
스튜디오는 누구나 자신만의 챗봇을 직접 만들고 관리할 수 있는 공간입니다. 🤖
기본 정보·답변 동작·학습 자료·공유까지 한 화면에서 끝까지 다룰 수 있도록 프로필 · 동작 · 지식 · 공유 네 개의 탭으로 구성되어 있습니다.

챗봇 리스트 페이지
스튜디오 메인은 내가 만든 챗봇을 한눈에 살펴볼 수 있는 카드 그리드입니다.
| 영역 | 설명 |
|---|---|
| 검색 | 페이지 상단에 고정된 검색바. 챗봇 이름이나 설명으로 즉시 좁힐 수 있습니다. |
| 필터 | 공개 범위로 좁히기 — 전체 / 공개 / 비공개 / 승인 대기 |
| 정렬 | 최신순 등 정렬 기준 |
| + 새 챗봇 | 챗봇을 즉시 생성하고 편집 화면(아래 4탭)으로 이동합니다. 별도 모달은 없습니다. |
| 카드 배지 | 좌상단에 공식 · 공개 · 비공개 · 승인 대기 가운데 하나가 색상 배지로 표시됩니다. |
| 무한 스크롤 | 카드 수가 많아져도 페이지 이동 없이 아래로 스크롤하면 추가 카드가 불려옵니다. |
각 카드의 채팅하기 버튼은 사용자 시점의 채팅 화면을 열고, 카드 본문 클릭은 챗봇 편집 화면으로 이동합니다.
챗봇 편집 화면
리스트에서 챗봇 카드를 클릭하거나 새 챗봇을 만들면 편집 화면이 열립니다.
| 영역 | 설명 |
|---|---|
| 좌측 상단 | ← 뒤로 버튼 + 챗봇 이름 + 현재 공개 상태 배지 (예: 비공개) |
| 4탭 네비 | 프로필 / 동작 / 지식 / 공유 — 유효성 오류가 있는 탭에는 오류 아이콘이 표시됩니다. |
| 우측 사이드 패널 | 같은 화면에서 즉시 시험해볼 수 있는 테스트 채팅 패널 |
| 하단 좌측 | 🗑️ 챗봇 삭제 |
| 하단 우측 | 최근 저장 시각 + 저장 버튼 |
저장이 실패할 경우, 오류가 발생한 탭에 오류 아이콘이 표시되어 어느 탭의 어떤 값을 고쳐야 하는지 바로 찾을 수 있습니다.
프로필 탭
챗봇이 사용자에게 어떻게 보일지를 정의하는 탭입니다.

프로필 이미지
- 챗봇의 아바타 이미지를 업로드합니다. 이미지가 없을 경우 기본 아바타가 사용됩니다.
- 리스트 카드·채팅 헤더·스토어·챗봇 선택 메뉴 등 모든 진입점에서 동일하게 사용됩니다.
- PNG/JPG/WebP 형식을 권장하며, 정사각형(1:1) 이미지가 가장 깔끔하게 표시됩니다.
이름
- 사용자에게 보여질 챗봇의 이름입니다.
- 입력칸 우측의 한 / A 토글로 한국어·영어 이름을 각각 따로 입력할 수 있습니다.
- 로그인 사용자의 언어 설정에 따라 자동으로 알맞은 이름이 노출됩니다. 한쪽 언어만 입력해도 동작하지만, 두 언어를 모두 채워두면 다국어 사용자에게 일관된 경험을 제공할 수 있습니다.
주요 특징
- 이 챗봇이 무엇을 잘 하는지 간단히 소개하는 짧은 글입니다.
- 이름과 마찬가지로 한 / A 토글로 ko/en을 분리해 입력합니다.
- 챗봇 선택 메뉴와 스토어 카드에서 사용자에게 노출되므로, "무엇을 시킬 수 있는지"가 한눈에 들어오도록 작성해 주세요.
- 입력칸은 자동으로 확장(
Expandable Textarea)되어 긴 설명도 부담 없이 적을 수 있습니다.
추천 질문
채팅 화면 입력창 위에 노출되는 클릭 버튼입니다. 사용자가 "뭘 물어봐야 하지?"라고 망설이지 않도록 미리 예시 질문을 띄워둘 수 있습니다.
| 항목 | 사양 |
|---|---|
| 최대 개수 | 10개 |
| 한 질문당 최대 길이 | 100자 |
| 등록 방식 | 입력칸에 텍스트를 적고 포커스를 벗어나면 자동 등록됩니다. 별도 추가 버튼이 필요 없습니다. |
| 삭제 | 등록된 항목 우측의 × 아이콘으로 삭제 |
| 순서 변경 | 항목을 드래그해 위아래로 이동 가능 |
팁: 사용자들이 가장 많이 물어보거나, 챗봇이 특히 잘 답할 수 있는 질문을 우선으로 등록해 두면 첫 사용 경험이 훨씬 부드러워집니다.
동작 탭
챗봇이 어떤 모델로, 어떤 어조로 답할지를 결정합니다.

언어 모델
- 응답을 생성하는 데 사용할 LLM을 선택합니다.
- 모델 카드에는 모델 이름, 강점·약점, 10,000 입력 토큰당 크레딧, 세션 용량(컨텍스트 윈도), 출시일 등이 함께 표시되어 비교가 쉽습니다.
- 일반 대화·요약·번역 등 가벼운 작업에는 비용 효율이 좋은 모델, 복잡한 추론·코딩 작업에는 상위 모델을 권장합니다.
HAI-GPT에서 제공되는 언어 모델은 조직의 계약 조건에 따라 상이할 수 있습니다.
프롬프트 (시스템 지시문)
- 챗봇의 성격·답변 스타일·규칙을 자연어로 정의합니다. 사용자에게는 보이지 않습니다.
- 예시: "너는 친절한 고객 상담원이야. 제품 문의에 정확하고 따뜻하게 답변해. 모르는 내용은 솔직히 모른다고 말하고, 항상 존댓말을 사용해."
- 작성 팁
- 역할 → 말투 → 답변 스타일 → 주의사항 순서로 적으면 효과가 좋습니다.
- "절대 ~하지 마", "반드시 ~해" 같은 강한 표현은 모델이 더 엄격히 따릅니다.
- 답변 형식을 정해두려면 "답변은 항상 마크다운 목록으로" 처럼 구체적으로 지정하세요.
- 우측 상단의 템플릿 불러오기 링크로 다른 챗봇의 프롬프트와 추천 질문을 한 번에 가져올 수 있습니다(스토어에 공개된 챗봇 검색). 가져온 뒤 그대로 저장하면 거의 같은 챗봇이 만들어지므로 일부 수정해 사용하세요.
심층 사고
- 선택한 모델이 심층 사고(thinking)를 지원하는 경우에만 카드 형태로 노출됩니다.
- 활성화하면 이 챗봇의 모든 대화에 항상 심층 사고가 적용되어, 복잡한 질문에 대해 더 긴 추론 과정을 거친 답변을 받을 수 있습니다.
- 같은 질문이라도 응답 시간이 길어지고 크레딧 소모가 늘어나므로, 사고력이 중요한 챗봇(전략·법무·연구 등)에 적합합니다.
지식 탭
챗봇이 답변에 활용할 자료를 등록합니다. 이 탭의 변경 사항은 추가/삭제 즉시 저장됩니다(별도 저장 버튼 불필요).

첨부 파일
다양한 파일 형식을 폭넓게 지원해, 일상적인 자료부터 전문 문서까지 학습시킬 수 있습니다.
| 카테고리 | 지원 형식 |
|---|---|
| 문서 파일 | .pdf, .docx, .pptx, .hwp, .hwpx |
| 표 및 데이터 | .csv, .xls, .xlsx, .tsv |
| 프로그래밍 | .py, .js, .ts, .java, .c, .cpp, .php, .rb, .tex, .go, .rs, .swift, .kt, .scala, .r, .m, .pl |
| 스크립트 | .sh, .bash, .zsh, .fish, .ps1, .bat, .cmd |
| 웹 개발 | .html, .css |
| 문서/마크업 | .md, .txt, .rst, .adoc, .org |
| 노트북 | .ipynb |
| 데이터/설정 | .json, .xml, .yaml, .yml, .toml, .ini, .conf, .config, .env, .properties |
| 빌드/프로젝트 | .makefile, .gradle, .cmake |
| 시스템/분석 | .log, .sql |
- 각 문서당 최대 200MB, 챗봇당 누적 문서 수 제한은 조직 설정에 따라 상이합니다.
- 업로드 직후 자동으로 텍스트·표·이미지 추출이 수행되며, OCR을 통해 이미지 안의 글자도 인식합니다.
Google Drive에서 가져오기
파일 업로드 영역 하단의 Google Drive에서 선택 버튼으로 Drive 파일을 곧바로 학습 자료로 등록할 수 있습니다.
- 처음 사용 시 Google 계정 연결이 필요합니다(My Page → 데이터 연동에서 연결).
- 선택한 파일은 자동으로 업로드되며, 수정·삭제는 다른 업로드 파일과 동일하게 관리됩니다.
파일 상세 설정 (다운로드 허용)
업로드된 파일을 클릭하면 우측에 상세 설정 패널이 열리며, 파일 단위로 동작을 조정할 수 있습니다.
| 설정 | 동작 |
|---|---|
| 공개 OFF (기본) | AI가 파일 내용을 읽고 답변에만 활용합니다. 사용자는 파일을 받을 수 없습니다. |
| 공개 ON | AI 활용 + 사용자가 답변에서 파일을 직접 다운로드할 수 있습니다. |
- 공개 ON으로 전환하는 순간 시스템이 자동으로 악성 파일 여부를 검사합니다 ("검사 중..." 표시).
- 검사가 성공하면 녹색 체크 아이콘이 표시되며, 사용자가 안전하게 다운로드할 수 있게 됩니다.
- 검사가 실패하면 자동으로 OFF 상태로 되돌려지고 사유가 안내됩니다.
주의: 공개 ON으로 설정한 파일은 챗봇을 사용하는 모든 사람이 받을 수 있습니다. 민감 정보가 포함되지 않았는지 다시 한 번 확인하세요.
외부 데이터 연동 (커넥터)
지식 탭 하단의 외부 데이터 연동 섹션에서는 외부 서비스의 도구·데이터를 챗봇과 연결합니다.
| 유형 | 설명 |
|---|---|
| MCP 커넥터 | Model Context Protocol을 따르는 외부 서버 연결. Custom MCP(URL + 인증 헤더 직접 입력) / Native OAuth MCP(공식 지원 SaaS의 OAuth 로그인) 두 방식을 지원합니다. |
| 외부 API | My Page → 데이터 연동에서 미리 등록한 REST API를 챗봇에 연결합니다. 베이스 URL·인증 헤더·엔드포인트 단위로 챗봇이 호출 시점을 판단합니다. |
| Google Drive | 학습 자료뿐 아니라 채팅 도중에도 Drive 파일을 검색·읽기·분석할 수 있도록 연결합니다. |
등록 절차
- 우측 상단의 + 추가 버튼으로 커넥터 등록 모달을 엽니다.
- 등록할 커넥터 유형을 선택합니다.
- 필요한 인증 정보(URL·헤더·OAuth 동의 등)를 입력하거나 진행합니다.
- 연결 테스트 버튼으로 정상 동작 여부를 확인합니다.
- 등록이 끝나면 챗봇 단위 활성/비활성 토글로 사용 여부를 제어할 수 있습니다. 비활성 상태에서는 AI가 해당 커넥터를 호출하지 않습니다.
연결 상태 배지
각 커넥터 카드에는 상단에 헬스 체크 결과가 표시됩니다.
| 배지 | 의미 |
|---|---|
| 연결됨 | 최근 헬스 체크가 정상 응답 |
| 오프라인 | 응답 없음 — 서버가 내려가 있거나 도달 불가 |
| 시간 초과 | 응답이 지정된 시간 안에 오지 않음 — 응답이 느리거나 네트워크 이슈 |
- 인증 토큰·시크릿은 저장 시 마스킹되며, 변경은 새 값으로 교체만 가능합니다(평문 조회 불가).
사내 정보를 외부 MCP/API로 전송하기 전에는 항상 데이터 처리·보관 정책을 확인해 주세요. 운영 중인 서버의 도구 목록·인증 정책 변경은 답변 품질에 직접 영향을 줍니다.
공유 탭
챗봇을 누구에게, 어떤 방식으로 노출할지 결정합니다.

공유 탭은 두 섹션으로 구성됩니다.
| 섹션 | 용도 |
|---|---|
| 스토어 공개 | HAI-GPT 내부 멤버 그룹·카테고리 단위로 공개 |
| 외부 공유 활성화 | 외부 사용자에게 보낼 공개 URL + 위젯 임베드 코드 |
화면 상단의 공유 상태 칩(공개·비공개·스토어 등록·인증 등)을 클릭하면 해당 섹션으로 부드럽게 스크롤됩니다. (
?section=store / ?section=link 쿼리 사용)스토어 공개
조직 내부 멤버에게 챗봇을 노출하고 싶다면 스토어 공개 토글을 켭니다.
| 항목 | 설명 |
|---|---|
| 공개 토글 | 켜면 스토어 공개 신청을 보냅니다. 끄면 신청을 취소하거나 비공개로 돌립니다. |
| 멤버 그룹 | 계층 다중 선택. 어느 그룹의 사용자에게 보일지를 지정합니다. |
| 카테고리 | 스토어에서 어떤 카테고리에 들어갈지 선택합니다. |
승인 워크플로우
- 일반 멤버가 공개를 신청하면 관리자 승인 절차가 시작됩니다 — 폼 상단에 "승인 요청이 필요합니다" 안내가 노출됩니다.
- 관리자라면 별도 승인 없이 공개로 전환됩니다.
승인 대기 상태
공개 신청 직후 챗봇은 승인 대기 상태가 됩니다.
- 공개 토글은 ON 상태로 표시되어, 요청한 상태가 시각적으로 유지됩니다(실제 공개 여부와는 별개).
- 폼 필드는 흐리게 표시되어 읽기 전용임을 알려줍니다.
- 그룹·카테고리는 신청한 값을 그대로 보여줍니다(승인 전이라도 요청 범위 확인 가능).
- 카드 배지는 "승인 대기" 로 별도 색상으로 표시됩니다.
- 같은 토글을 다시 끄면 요청 취소 모달이 열립니다. 확인하면 즉시 신청이 철회되고 비공개로 되돌아갑니다.
이미 공개된 챗봇이라도 그룹·카테고리 변경 등 재승인이 필요한 변경을 신청하면 같은 승인 대기 상태로 전환됩니다. 기존 공개 설정은 그대로 유지되며, 패널에는 요청한 신규 값이 보입니다.
승인이 반려될 경우, 관리자가 반려 사유를 가입된 메일을 통해 알려드립니다. 챗봇이 스토어에 보이지 않을 경우 메일함을 확인해 주세요.
공개 상태의 챗봇은 정보를 수정할 수 없습니다. 수정하려면 공개를 끄거나 승인 요청을 취소한 뒤 변경해 주세요.
이미 공개된 챗봇을 비공개로 돌리면 기존 사용자의 이용에 지장이 있을 수 있으니 권한 변경 시 유의하세요.
이미 공개된 챗봇을 비공개로 돌리면 기존 사용자의 이용에 지장이 있을 수 있으니 권한 변경 시 유의하세요.
외부 공유 활성화
HAI-GPT 외부 사용자에게 챗봇을 공유하고 싶다면 외부 공유 활성화 토글을 켭니다. 켜면 두 가지 공유 수단이 한 번에 발급됩니다.
공개 페이지 URL
원하는 슬러그(slug)를 입력하면 다음 형태의 공유 URL이 발급됩니다.
https://factchat-staging.com/public/chatbots/{your-slug}
- 입력 직후 슬러그가 사용 가능한지 자동으로 확인합니다 — 중복이거나 형식이 잘못되면 즉시 오류 메시지가 표시됩니다.
- 저장된 URL은 복사 · 새 탭에서 미리보기 액션으로 즉시 확인할 수 있습니다.
일반 사용자가 외부 공개 페이지를 통해 사용한 크레딧은 챗봇을 만든 사용자의 크레딧 한도에서 차감됩니다.
위젯 임베드
같은 섹션 하단에는 위젯 임베드 코드가 함께 제공됩니다. 자신의 웹사이트에 이 JavaScript 스니펫을 삽입하면 챗봇이 화면 우측 하단의 챗 버튼 형태로 노출됩니다.
위젯을 사용하면
- 사용자가 자신의 웹사이트에서 위젯 형태로 챗봇과 대화할 수 있습니다.
- 화면 우측 하단의 챗 버튼으로 언제든지 챗봇을 열 수 있습니다.
- 버튼 색상과 제목을 커스터마이징할 수 있습니다.
URL 파라미터
공개 페이지 URL이나 위젯 URL 뒤에 쿼리 파라미터를 붙여 동작을 조정할 수 있습니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
closeButton | true | iframe 우측 상단의 닫기(×) 버튼 노출 여부. false로 지정하면 닫기 버튼을 숨겨, 위젯이 항상 표시되어야 하는 사이트에서 사용자가 실수로 닫는 것을 방지할 수 있습니다. |
예시:
https://factchat-staging.com/public/chatbots/{your-slug}?closeButton=false
테스트 채팅 사이드바
편집 화면 우측에는 테스트 채팅 패널이 함께 표시되어, 설정을 바꾸자마자 그 결과를 곧바로 대화로 확인할 수 있습니다.
| 동작 | 설명 |
|---|---|
| 사이드바 토글 | 우측 상단 토글 버튼으로 패널을 열고 닫을 수 있습니다. |
| 너비 조절 | 데스크톱에서 패널 좌측 가장자리를 드래그해 너비를 조절할 수 있습니다. |
| 모바일 동작 | 모바일 폭에서는 자동으로 닫히며, 열면 전체 화면 모드로 전환됩니다. |
| 초기화 | 우측 상단 초기화 버튼으로 테스트 대화 내역을 비울 수 있습니다. |
| 보안문구 | 입력창 아래에는 "보안문구" 영역이 표시되어, 사용자가 보게 될 안내 문구를 그대로 확인할 수 있습니다. |
데스크톱 폭에서는 기본적으로 테스트 채팅이 열린 상태로 유지되어, 변경 → 테스트 → 저장 흐름이 끊기지 않습니다. 추천 질문·프롬프트를 수정한 직후 곧바로 테스트 채팅에서 결과를 확인해 보세요.
마지막 수정 날짜: May 20, 2026