GAS 연동
구글 스프레드시트의 Apps Script 웹 앱과 이 콘솔을 연결합니다.
Apps Script 편집기 우측 상단 [배포] → [새 배포] → 유형 "웹 앱" → 액세스 권한 "모든 사용자"로 배포한 뒤 발급된 주소를 붙여넣으세요.
build아직 스프레드시트를 준비 안 했다면? (1분 설정 가이드)expand_more
Gemini API 키 및 고급 설정
AI 튜터가 사용할 Gemini API 키와 선택 항목을 설정합니다.
저장된 키는 보안을 위해 앞 4자·뒤 4자만 보여 줘요(AIza••••1234). 바꾸려면 칸을 눌러 새 키를 붙여 넣고 저장하세요. 추가 키도 같아요.
vpn_key추가 API 키 한도가 소진되면 위의 키부터 차례로 자동 전환돼요
무료 키는 하루 요청 수가 매우 적어요(예: 20회). 한 반이 몇 분만 써도 소진되고 응답도 느려질 수 있으니, 수업에는 결제(Billing)를 연결한 키를 쓰고 무료 키는 보조로만 두세요. 위의 기본 키가 먼저 쓰이고, 크레딧·한도가 다 떨어지거나 키에 문제가 생기면 추가 키가 위에서부터 차례로 쓰여요. 한도가 소진된 키는 잠시 쉬었다가(몇 시간) 저절로 다시 시도하고, 충전했다면 쉬는 중 해제를 눌러 바로 다시 쓸 수 있어요. 모든 키가 소진되면 학생에게는 "지금은 AI를 사용할 수 없어요"가 보여요. 추가 키도 스프레드시트의 API키 탭에 평문으로 저장되니 시트를 공유하지 마세요.
비워 두면(자동) 가볍고 무료 한도에 유리한 Flash-Lite 모델을 먼저 써요. 답변 품질이 아쉬우면 더 큰 모델을 직접 골라 주세요. 구글이 모델을 종료·교체해서 AI 응답이 안 나올 때, 목록에서 지금 쓸 수 있는 모델을 골라 테스트한 뒤 저장하기를 눌러 주세요. 고른 모델이 사라져도 자동 선택 모델로 한 번 더 시도해요.
대화 기록을 한 벌 더 저장할 별도 스프레드시트
vpn_keyGemini API 키는 어떻게 발급받나요?expand_more
AIzaSy... 형태의 키가 발급돼요.개인정보·보안 안내
수업을 시작하기 전에 한 번 확인해 주세요.
- 스프레드시트는 공유하지 마세요. 학생 대화 원문과 API 키가 들어 있어요. "링크가 있는 모든 사용자"로 공유하면 누구나 볼 수 있어요.
- 학생 링크·QR은 우리 반에게만 전하세요. 학생이 들어올 때는 수업 입장 코드도 필요해요. 링크가 반 밖으로 퍼졌다면 학생 배부 메뉴에서 새 코드를 만들면 이전 코드는 바로 쓸 수 없게 돼요.
- 학생에게 이름·전화번호·주소를 쓰지 않게 안내하세요. 쓴 내용은 그대로 시트에 기록돼요.
- Gemini 무료 키는 입력한 내용이 구글의 서비스 개선에 쓰일 수 있다는 약관이 있어요(약관은 바뀔 수 있으니 최신 내용을 확인해 주세요). 학교 방침에 따라 학생·학부모 안내나 유료 키 사용을 검토하세요.
- 학기가 끝나면 대화 기록을 정리하세요. 필요한 분석은 보고서로 내려받고, 시트의
채팅기록을 따로 백업한 뒤 비우면 돼요.
route처음이라면 ①부터 ③까지 순서대로 진행하세요. 이미 만들어 둔 것은 필요한 탭만 열어 고치면 돼요. 주제마다 다르게 쓸 설정은 다음 메뉴인 주제 설정에서 해요.
캐릭터 · 인사말
학생 화면 상단에 나타나는 AI 튜터의 모습과 첫 인사말이에요. 캐릭터는 대화 방식(템플릿)마다 한 명씩 짝이 있어요. 대화 방식을 바꾸면 직접 고르지 않은 캐릭터·이름·인사말은 새 짝에 맞게 함께 바뀌어요.
{주제}는 학생이 선택한 탐구 주제로 자동 치환됩니다. 대화 방식(템플릿)을 바꾸면 직접 고치지 않은 인사말은 그 방식에 맞는 기본 인사말로 함께 바뀌어요.
페르소나 설정
AI가 어떤 역할로, 어떻게 말하고, 무엇을 하지 않을지 정해요. 비워 둔 칸은 '기본' 페르소나를 따라요.
같은 모둠이 하루 3회 사용하면 그날 대화가 차단됩니다.
route①부터 ③까지 순서대로 진행하세요. 주제 목록을 정한 뒤 주제마다 쓸 페르소나·루브릭을 연결하고, 탐구 도우미에 연결한 주제만 탐구 자료를 입력하면 돼요.
직접 입력하거나 예시를 골라 추가할 수 있어요. 학생은 여기 적힌 주제 중에서 고릅니다. 찬반 토론형 템플릿에는 "~해야 한다"처럼 찬반이 갈리는 문장 주제가 잘 맞아요.
주제 연결
| 주제 | 페르소나 | 루브릭 | 제한 시간(분) | 기억 쌍 | |
|---|---|---|---|---|---|
| 불러오는 중… | |||||
주제 목록은 탐구 주제 목록 탭에서 정하고 저장하면 여기에 나타나요. 주제 이름을 바꾸면 이 연결과 탐구 자료의 연결이 끊어지니, 바꾼 뒤에는 다시 확인해 주세요. 기억할 대화 쌍은 AI가 직전 몇 번의 주고받기를 기억할지예요(클수록 정확하지만 느려질 수 있어요).
주제 목록
주제 목록은 탐구 주제 목록 탭에서 정해요. 주제 이름을 바꾸면 자료와 연결이 끊어지니, 바꾼 뒤에는 자료 입력 상태를 다시 확인하세요.
학생 접속 링크 및 QR 배부
링크나 QR을 열기만 하면 별도 설정 없이 이 스프레드시트에 자동으로 연결됩니다.
직접 정하기
링크나 QR만으로는 대화방에 들어올 수 없고, 이 코드를 입력해야 해요. 반 밖으로 링크가 퍼졌거나 새 수업을 시작할 때 새 코드를 만들면 이전 코드는 바로 쓸 수 없게 돼요. 수업 중에 바꾸면 이미 들어온 학생도 다음 전송 때 다시 입장해야 해요.
lightbulb 교실 화면/TV에 QR코드를 띄워두면 학생들이 카메라로 스캔해 바로 입장할 수 있어요.
대화 불러오기 및 논증 분석
학급 → 탐구 주제 → 모둠 순서로 단추를 눌러 고르면, 해당 대화 기록을 AI가 논증 요소별로 분석해요.