💬 AI 썰전 사용 설명서 — v1.0.0 (내부 patch v2.4.9, 2026-05-28)

AI 썰전은 하나의 정책 제안·쟁점 주제에 대해 3사 AI 모델(GPT, Claude Sonnet, Gemini Flash 등)이 가상의 페르소나를 탑재하고 라운드제 토론을 벌인 후, 토론에 참여하지 않은 별도 평가위원 모델이 11섹션 종합 보고서를 작성하는 의사결정 보조 도구입니다.

🔑 개인 API 키 등록 필수

외부 무료 서버를 타지 않고 사용자의 개인 OpenAI / Anthropic / Gemini API 키를 사용해 브라우저 로컬에서 호출합니다. 상단의 🔑 API 키 버튼으로 본인의 키를 1회 등록하십시오. 키는 브라우저 localStorage 에만 저장되며 서버 전송 X.

🎯 토론 유형 6종 (논의 형태)

주제 무게·결정 깔끔도에 맞춰 토론 형태 자체를 선택할 수 있습니다.

유형	구성	특징
🌐 표준	3 AI × 6R	정반합 풀버전 — 다관점 균형 검토
🏛 정통 찬반	2 AI × 3R	단일 결정 깔끔. 찬·반 명확한 사안
⚔ 격돌 모드	3 AI × 6R	합의 금지. 가장 강한 논리만 채택
😈 데빌스 어드보킷	3 AI × 6R, 1명 반대	집단사고 견제. 1명이 항상 반대
🤔 소크라테스	3 AI × 5R, 1명 질문 only	가정·전제 검증. 1명은 본인 의견 X, 질문만
✨ 창의 모드	3 AI × 6R	아이디어 발산 + 수렴 결합

⚙️ 3가지 진행 모드 (좌장 개입 빈도)

전자동 (한 번에 완료): 좌장의 추가 조율 없이 6라운드 + 11섹션 보고서 + mermaid 다이어그램까지 1~3분 안에 자동 도출.
반자동 (3R 후 개입): 반환점(3R 종료)에서 일시 정지. 좌장이 토론 흐름을 훑은 후 "김주무관의 예산 우려에 대해 박교수가 성공사례를 제시해 주십시오" 같은 지시를 내려 흐름을 조정합니다.
턴바이턴 (매R 후 개입): 매 라운드 종료마다 멈춤. 세세한 조율로 토론을 정교하게 이끌어가는 심화 모드.

👥 페르소나 자동 추천 + 사용자 커스터마이즈

주제 입력 → 페르소나 추천 → AI 가 입장(찬성·반대·제3각도) 별로 적합한 한국 이름·역할·가치관·학문 배경을 자동 생성.
각 카드의 모든 input (이름 / 역할·직업 / 가치관 / 학문 배경 / 사용자 정의 / 입장 라벨 / 토론 입장) 을 직접 수정 가능.
사용자 정의: 자유 텍스트 (성별·나이·MBTI·종교 등 페르소나에 더하고 싶은 모든 것). 비우면 prompt 에서 제외.

📎 공용 배경 지식 첨부 (모든 토론자 공유 — v2.4.6)

주제 입력란 아래 📎 배경 지식 추가 펼침에 정책 문서·통계·연구 보고서를 첨부하면, 모든 라운드의 prompt 에 자동 첨부되어 모든 토론자가 동일하게 참고합니다.

지원 형식: .txt · .md · .csv · .pdf · .hwpx
PDF: 페이지별 텍스트 자동 추출 (pdf.js, 스캔 이미지 PDF 는 텍스트 레이어가 없어 추출 불가)
HWPX: 한컴 오피스 양식의 본문 텍스트 자동 추출 (JSZip + section XML 파싱)
여러 파일 동시 첨부 가능. 추출 텍스트가 textarea 에 누적되며, 직접 입력과 혼합 사용 가능
50,000자 한도 (초과분 자동 잘림). 토큰 비용을 고려해 핵심 발췌를 권장합니다

📎 페르소나 개인 참고 자료 (해당 페르소나 전용 — v2.4.7)

각 페르소나 카드 안 📎 개인 참고 자료 펼침에 해당 페르소나에게만 보여주고 싶은 자료를 첨부할 수 있습니다. 본인의 주장 근거·반박 자료로 활용되며, 다른 페르소나·평가위원에게는 공개되지 않습니다.

지원 형식·추출 방식은 공용 배경 지식과 동일 (.txt · .md · .pdf · .hwpx)
페르소나 1인당 30,000자 한도 (초과분 자동 잘림)
각 페르소나는 본인 자료만 열람 — 다른 페르소나에게 영향 X
예: 찬성 측에 우호적인 연구 자료 / 반대 측에 대한 비판 자료를 각자에게 따로 제공해 양측 논리를 균형 있게 강화

💡 워크플로 팁

PDF 딸깍 → PDF→마크다운 .zip 또는 주간정책동향 딸깍 → 보도자료 HWPX 첨부 흐름으로 손쉽게 토론 자료를 확보할 수 있습니다. 자료를 가득 채우면 토큰 비용이 2~3배 증가하므로 핵심만 발췌하는 것을 권장합니다.

📄 11섹션 종합 보고서 구성

토론 결과물은 토론에 참여하지 않은 별도 평가위원 모델이 11섹션으로 정형화된 보고서로 작성합니다. 토론자 본인이 자기 발언을 평가하지 않도록 분리해 평가 편향을 방지하는 구조입니다.

핵심 쟁점
찬성 측의 가장 강한 주장
반대 측의 가장 강한 주장
찬성이 방어 못한 주장 (아킬레스건)
반대가 방어 못한 주장
드러난 숨은 전제
결정적 검증 질문
최종 판단
남은 불확실성
판단을 뒤집을 수 있는 결정적 증거 (Pivot Condition)
독자가 실제로 참고할 점 (실무 권고)

🖼 갤러리 + 댓글 + 어드민 모드

갤러리 게시: 토론 완료 후 📌 갤러리 게시 — 다른 사용자도 결과를 볼 수 있도록 공개
인라인 갤러리: 메인 페이지 토론 시작 흐름 아래에 5개 카드 그리드로 다른 사용자 토론 노출 — 클릭 시 같은 탭에서 모달 열림
📥 MD 내보내기 / 🖨 PDF 내보내기 (mermaid 다이어그램 자동 렌더 + Ctrl+P): 모달 footer 에서 다운로드
💬 댓글: 작성 시 암호를 입력하면 본인만 삭제 가능, 비우면 익명 댓글 (작성자가 직접 삭제할 수 없음). 갤러리 카드에 댓글 수가 함께 표시됩니다 (v2.4.7)
🛡 어드민 모드: 갤러리 헤더 토글 → 환경변수 ADMIN_TOKEN 입력 → 빨간 배너 표시 + 모든 게시물·댓글 강제 삭제 권한

⚙️ 모델 ID 직접 수정

topbar 의 ⚙️ 모델 ID / ⚖️ 평가위원 버튼으로 각 슬롯의 정확한 API 모델 ID 를 직접 수정할 수 있습니다 (Anthropic / OpenAI / Gemini 가 모델 ID 를 자주 갱신).

💾 저장 범위

변경한 모델 ID 는 사용자 본인 브라우저의 localStorage 에 영구 저장됩니다. 같은 브라우저에선 다음 방문 시에도 유지되며, 다른 PC·시크릿 창·다른 사용자에게는 적용 X. 서버에 저장 X — 각자 자기 브라우저에서 독립적으로 관리됩니다.

➔ 한글 문서 스타일 딸깍(md2hwpx) 연동

결과 화면에서 📤 한글(md2hwpx)로 보내기 클릭 시 11섹션 보고서 마크다운이 새 탭의 md2hwpx ‘스타일 매칭 및 변환’ 화면으로 바로 전달됩니다(이 탭의 토론 결과는 그대로 유지). 기본 양식이 선택된 상태로 열리므로 딸깍 한 번으로 HWPX 공식 문서를 완성할 수 있습니다.

💰 비용 안내

본인 API 키 사용이므로 호출량 = 결제액. 평균 토론 1회 비용 추정:

표준 6R × 3 AI: 약 ₩100~200 (Claude Haiku / Gemini Flash 기준)
배경 지식 50,000자 가득: 토큰량 약 3~4배 증가 → ₩400~800
topbar 의 💰 단가 설정 에서 모델별 단가·환율(USD→KRW)을 사용자 입력 → 실시간 비용 표시

💾 갤러리 자동 백업

서버 장애 대비 자동 백업

갤러리에 게시된 모든 토론(본문 + 댓글)은 매일 자동으로 운영자 전용 PRIVATE 저장소에 백업됩니다(다른 게시판·자료실·접속통계와 통합 백업). AISpace 서버 재배포·장애 시에도 모든 게시물이 보존되며, git history 로 시간순 변경 이력도 추적 가능합니다.

백업 주기: 매일 1회 (GitHub Actions schedule)
백업 내용: 게시물 본문·페르소나·11섹션 보고서·mermaid·transcript·댓글 모두 포함
제외: 작성자 암호 hash (sanitize 후 백업)