이름 · 학번은 넣지 않기
앱에도, 시트에도, AI에게 보내는 글에도 학생 개인정보를 넣지 않습니다.열쇠는 숨기기
API 열쇠를 화면 공유에 보이거나 채팅에 올리지 않습니다.한 번에 하나씩 붙이기
앞 걸음이 되는 것을 확인하고 다음 프롬프트를 붙여 넣습니다.내 정보 넣기
여기에 넣은 값이 아래 프롬프트에 자동으로 들어갑니다. 값은 이 브라우저에만 저장되고 어디로도 보내지 않습니다.
기본값은 용신중학교와 용인시 처인구 부근 좌표(대략)입니다. 다른 학교라면 학교 이름을 고치고 「학교 코드 찾기」를 누르세요. 위도 · 경도는 지도 앱에서 학교를 길게 누르거나 오른쪽 버튼으로 눌러 나오는 숫자 두 개입니다.
현황판 뼈대 만들기
실습 1 · 7분Gemini에서 Canvas를 켜고 아래 프롬프트를 붙여 넣습니다. 빈 카드 네 장이 보이면 성공입니다.
Canvas에 붙여 넣기뼈대 프롬프트
API는 주문 창구
앱은 주소로 묻고, 창구는 글자(JSON)로 답합니다. 주소는 세 부분입니다.
어디에(창구 주소) · 무엇을(조건) · 누구인지(열쇠). 아래 실습마다 「주소 눌러 보기」로 실제 답을 볼 수 있습니다.
날씨 붙이기
실습 2 · 10분Open-Meteo는 가입도 열쇠도 필요 없는 공개 날씨 API입니다. 위도와 경도만 넣으면 됩니다.
먼저 보기주소 눌러 보기
내 정보의 위도 · 경도로 지금 날씨를 불러옵니다. 돌아온 글자가 앱이 받는 답입니다.
Canvas에 붙여 넣기날씨 프롬프트
한 걸음 더미세먼지 프롬프트
나이스 API 붙이기
실습 3 · 12분나이스 교육정보 개방 포털은 급식 · 학사일정 · 시간표 · 학교 기본정보를 공개합니다. 업무용 나이스와 다른 곳이고 학생 정보는 없습니다.
먼저 보기주소 눌러 보기
내 정보의 학교 코드로 오늘 급식과 앞으로의 학사일정을 불러옵니다.
Canvas에 붙여 넣기급식 프롬프트
한 걸음 더학사일정 프롬프트
열쇠 없이 부르면 한 번에 5건까지만 옵니다. 학사일정처럼 여러 건이 필요하면 개방 포털에 가입해 인증키를 받고(무료), 주소 끝에 &KEY=내 인증키를 붙입니다.
AI 붙이기: Groq
실습 4 · 12분Groq는 공개 AI 모델을 빠르게 돌려 주는 창구입니다. 무료로 시작할 수 있지만 비밀 열쇠가 필요합니다.
열쇠 받는 세 걸음
- console.groq.com 에 로그인
- API Keys 메뉴에서 Create API Key
- 열쇠를 복사해 메모장에 붙여 두기 (한 번만 보여 줍니다)
잠깐, 열쇠가 보여요
앱에 넣은 열쇠는 링크를 받은 누구나 볼 수 있습니다. 이 단계의 앱은 나만 보는 용도로 쓰고, 학생에게 줄 앱은 ⑤의 「열쇠 숨기기」까지 마친 뒤에 공유하세요.Canvas에 붙여 넣기AI 한마디 프롬프트
열쇠는 프롬프트에 적지 않습니다. 완성된 앱의 입력 칸에 넣습니다.
모델 이름은 바뀔 수 있습니다. 오류가 나면 Groq 모델 문서에서 지금 쓸 수 있는 이름을 확인하세요.
구글 시트와 연결하기
실습 5 · 13분구글 시트에는 주문 창구가 없습니다. Apps Script로 창구를 하나 엽니다. 코드는 복사해서 붙여 넣기만 하면 됩니다.
창구 열기네 걸음
- 새 구글 시트를 만들고 이름을 정합니다. (예: 아침 현황판)
- 시트 메뉴 확장 프로그램 → Apps Script를 엽니다.
- 들어 있던 코드를 모두 지우고 아래 코드를 붙여 넣은 뒤 저장합니다.
- 배포 → 새 배포 → 유형: 웹 앱을 고르고 아래 두 칸을 맞춘 뒤 배포합니다.
| 실행 계정 | 다음 사용자 인증 정보로 실행: 나 |
|---|---|
| 액세스 권한 | 액세스 권한이 있는 사용자: 모든 사용자 |
처음 한 번 권한 승인 화면이 나옵니다. 배포가 끝나면 /exec로 끝나는 웹 앱 주소를 복사해 위 「내 정보」 칸에 넣으세요. 학교 계정에서 「모든 사용자」가 보이지 않으면 개인 구글 계정으로 하세요.
먼저 보기창구 시험
「내 정보」에 넣은 웹 앱 주소로 시험 한 줄을 보내고 다시 불러옵니다. 보낸 뒤 시트의 「체크인」 탭을 열어 보세요.
Canvas에 붙여 넣기체크인 프롬프트
한 걸음 더열쇠 숨기기
- Apps Script 왼쪽 프로젝트 설정(톱니바퀴) → 스크립트 속성 → 스크립트 속성 추가
- 속성 이름
GROQ_API_KEY, 값에 Groq 열쇠를 넣고 저장 - 아래 프롬프트로 AI 카드를 고칩니다. 이제 앱에는 열쇠가 없습니다.
Apps Script가 처음으로 바깥 창구(Groq)를 부를 때 권한 승인을 한 번 더 요청할 수 있습니다.
막힐 때
화면에 오류가 보여요
오류 글자를 그대로 복사해 Canvas에 붙여 넣고 「이 오류를 고쳐 줘」라고 말합니다.코드를 고쳤는데 그대로예요
Apps Script는 저장만으로 바뀌지 않습니다. 배포 → 배포 관리 → 수정(연필) → 버전: 새 버전 → 배포.시트로 보내기가 막혀요
주소 끝이/exec인지, 액세스 권한이 「모든 사용자」인지, 앱이 Content-Type: text/plain으로 보내는지 확인합니다.급식이 안 나와요
주말 · 방학에는 급식이 없습니다. 위 「오늘 급식 불러오기」로 창구가 무엇을 답하는지 먼저 봅니다.선 긋기
- 이름 · 학번 · 연락처 · 사진을 모으지 않기
- 상담 내용 · 성적을 시트에 쌓지 않기
- AI에게 학생 정보를 보내지 않기
- 열쇠가 든 앱 링크를 공유하지 않기
이렇게 해요
- 별명이나 번호만 받고, 한마디는 짧게(40자) 받습니다.
- 시트 공유는 나만 보기로 둡니다.
- 웹 앱 주소를 아는 사람은 누구나 보낼 수 있습니다. 수업이 끝나면 배포 관리 → 보관으로 창구를 닫을 수 있습니다.
- AI가 쓴 글은 내보내기 전에 선생님이 먼저 읽습니다.