화면 모드
프롬프트 실습
컨텍스트와 프롬프트의 구분을 같은 과제에 적용한다. 조건을 하나씩 바꾸고 실제 출력에서 무엇이 달라졌는지 센다. 이 문서의 1차 경로는 브라우저에서 바로 대화를 시작하는 Google AI Studio와 Groq 플레이그라운드다. API 키를 발급받거나 로컬에 모델을 설치하지 않아도 첫 실행을 시작한다.
기준일: 2026-10-02. 아래의 로그인 방식·무료 범위·모델 표는 이 날짜에 공식 문서와 로그인 화면에서 확인한 값이다. 다시 실행하기 전에 같은 링크를 열어 자신의 계정 상태를 다시 확인한다.
공통 과제
로그인 실패 시 오류 메시지를 표시하도록 수정한 변경에 대해 커밋 메시지를 한 줄 작성한다. 형식은 fix(영문 범위): 한국어 설명이다. 실습의 목적은 특정 문장을 정답으로 외우는 것이 아니라, 같은 과제의 조건과 출력을 나란히 비교하는 데 있다.
text
변경: 로그인 실패 시 오류 메시지를 표시하도록 수정했다.
커밋 메시지를 한 줄로 작성해.
형식은 fix(영문 범위): 한국어 설명으로 해.공개 실습 파일에는 복사할 프롬프트 8개와 빈 기록 양식이 있다. 코드는 MIT 라이선스로 제공한다. 모바일에서는 파일 내용을 복사해 모델의 대화 화면에 붙여 넣고, 컴퓨터에서는 파일 비교기를 함께 쓸 수 있다.
브라우저에서 바로 시작하기
두 서비스 모두 API 키 없이 대화 화면에서 첫 실행을 시작한다. 모델과 설정값을 바꾸지 않은 상태에서 먼저 기본선을 한 번 잡은 뒤, 조건을 하나씩 얹는다.
Google AI Studio
Google AI Studio는 Google 계정으로 들어간다. 2026-10-02 확인한 로그인 화면은 "Use your Google Account", "Email or phone"을 보여 준다. 새 계정을 이 화면에서 만들 수 있다.
| 항목 | 확인 내용 | 근거와 확인일 |
|---|---|---|
| 로그인 | Google 계정(또는 만든 새 계정). Google Workspace 계정은 기본으로 사용할 수 있고, 조직 관리자가 켜고 끌 수 있다. Workspace for Education은 18세 미만이 제한된다 | Workspace 계정으로 AI Studio 사용, 로그인 화면. 2026-10-02 |
| 플레이그라운드 진입 | 로그인하면 Playground가 열린다. 새 채팅 프롬프트가 준비된 상태로 시작한다 | AI Studio 빠른 시작. 2026-10-02 |
| 시스템 프롬프트 | 우측 상단 Run settings 를 눌러 펼친 패널의 System Instructions 입력란에 적는다. 대화가 시작된 뒤에도 바꿀 수 있다 | AI Studio 빠른 시작. 2026-10-02 |
| temperature | 같은 Run settings 패널의 모델 파라미터에 들어간다. 화면 배치와 기본값 표기는 로그인이 필요해 미확인이다. 실습에서는 값을 직접 고정한 뒤 기록에 적는다 | AI Studio 빠른 시작. 2026-10-02 |
| 실습 모델 | Gemma 4 31B(gemma-4-31b-it), Gemma 4 26B A4B(gemma-4-26b-a4b-it)가 AI Studio와 Gemini API에서 지원되는 ID로 문서에 실려 있다. 플레이그라운드 모델 목록에 실제로 뜨는지는 미확인이다 | Gemma 4의 Gemini API 지원 ID. 2026-10-02 |
| 무료 범위 | Free는 AI Studio에서 "Modest quota", 기본 한도와 접근이다. 한도와 적용 모델은 계정마다 달라 계정 안에서 확인한다 | 요금제 비교, 요율. 2026-10-02 |
| 지역·연령 | 지원 국가 목록에 한국이 들어 있다. 18세 이상이어야 한다. 목록에 없는 지역에서는 진입 화면이 지원 국가 안내로 바뀐다 | 지원 지역. 2026-10-02 |
Groq
Groq 콘솔에 Google·GitHub·SSO·이메일 중 하나로 들어간 뒤 플레이그라운드에서 대화한다.
| 항목 | 확인 내용 | 근거와 확인일 |
|---|---|---|
| 로그인 | Google 계정으로 시작할 수 있다. 브라우저로 로그인 화면을 열면 Continue with Google·Continue with GitHub·Continue with SSO·Continue with email이 보인다. Next.js 클라이언트 렌더라 정적 HTML만 받으면 버튼이 보이지 않으므로 브라우저로 확인한다 | Groq 로그인 화면. 2026-10-02 |
| 플레이그라운드 진입 | 로그인 후 플레이그라운드 화면이 열리고 Region: auto 가 표시된다. 모델은 주소의 ?model=<모델ID>로 지정할 수 있다 | Groq 플레이그라운드, ?model=openai%2Fgpt-oss-120b. 2026-10-02 |
| 시스템 프롬프트·temperature | 플레이그라운드에 System 입력란이 있고 Enter system message (Optional) 자리 표시자가 보인다. 로그인 없이 페이지 HTML에서 확인된다. temperature는 API 문서에 0~2(기본 1)로 실려 있으나 플레이그라운드 화면의 조정 자리는 미확인이다 | Groq 플레이그라운드, API 레퍼런스. 2026-10-02 |
| 실습 모델 | 무료 플랜에서 쓸 수 있는 채팅 모델은 gpt-oss-120b, gpt-oss-20b, openai/gpt-oss-safeguard-20b, Qwen 3.8 27B(qwen/qwen3.8-27b)이다. 음성 인식은 whisper 계열을 쓴다. Gemma는 제공 목록에 없다 | 요청 제한의 Free Plan 표, 지원 모델. 2026-10-02 |
| 무료 범위 | Free 플랜이 있고 "누구나 시작하기에 적합하다"는 설명이 붙는다. 정확한 한도는 계정 안의 limits 화면에서 확인한다. 한도는 사용자별이 아니라 조직 단위로 걸린다 | Free Plan 요금제, 요청 제한. 2026-10-02 |
| 유료 전환 | Developer 플랜으로 올리면 한도가 늘고 Batch·Flex 처리가 열린다. 가격은 공식 가격표에서 확인한다 | 요금제, 공식 가격표. 2026-10-02 |
llama-3.1-8b-instant와 llama-3.3-70b-versatile은 2026-08-16 종료되어 지원 모델 표에 Enterprise(Contact Sales)로만 남아 있고, qwen/qwen3.6-27b는 2026-09-14 종료되어 qwen/qwen3.8-27b로 대체됐다. 이 종료는 무료·Developer 등급에 적용되며, 별도 계약(committed-spend) 기업 고객은 예외다. 그래서 무료 실습 모델에서 뺐다. 지원 종료에서 확인할 수 있다.
두 화면을 함께 볼 때
| Google AI Studio | Groq | |
|---|---|---|
| 첫 실행에 필요한 것 | Google 계정 | Groq 계정(Google·GitHub·SSO·이메일) |
| 실습 모델 | Gemma 4 계열 | gpt-oss·Qwen 계열 |
| 시스템 프롬프트 입력 | Run settings의 System Instructions | 플레이그라운드의 System 입력란 |
| temperature 입력 | Run settings의 모델 파라미터 | 화면 조정 자리 유무 미확인 |
두 서비스는 같은 모델을 제공하지 않는다. 모델을 바꿔 가며 조건을 비교하지 않는다. 한 화면 안에서 모델을 고정한 채 조건만 바꿔 비교한다. 다른 화면에서 얻은 결과는 같은 표의 다른 줄로 따로 적고, 두 서비스의 출력을 같은 조건이라고 묶지 않는다.
이미지 생성의 무료 범위
이미지 생성 모델 nano banana 계열을 AI Studio에서 무료로 쓸 수 있는지 확인했다. 확인 결과, 무료 등급에서는 제공되지 않는다. 2026-10-02 기준으로 세 모델이 이렇다.
| 모델 | 모델 ID | Free Tier |
|---|---|---|
| Nano Banana Pro | gemini-3-pro-image | Not available |
| Nano Banana 2 | gemini-3.1-flash-image | Not available |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | Not available |
요율표는 세 모델의 Free Tier 입력·출력 가격을 모두 "Not available"로 적고 있고, 요금제 비교 표는 Nano Banana 접근을 AI Pro 구독 쪽에 둔다. 모델 자체는 Nano Banana 이미지 생성 문서에 세 가지가 정리돼 있다. 확인일 2026-10-02.
따라서 이 문서에는 이미지 프롬프트 실습을 넣지 않는다. 이미지 생성까지 넣고 나면 "브라우저만으로 무료로 시작한다"는 이 문서의 조건이 깨진다. 나중에 Nano Banana가 Free 등급에 포함되면 그때 별도로 추가한다.
보충: 더 해 보기 — API 키·다른 제공자·로컬 실행
1차 경로가 플레이그라운드이므로 아래는 필요할 때만 보는 선택지다. 표의 값은 2026-10-02 공식 문서에서 확인했다. 실행 직전에 같은 링크를 다시 열어 제공 여부와 자신의 한도를 확인한다. 무료 표시는 무제한 실행이나 모델 버전 고정을 뜻하지 않는다.
| 연결 | 모델 ID·선택 | 조건과 공식 근거 |
|---|---|---|
| AI Studio API 키 | gemma-4-31b-it 또는 gemma-4-26b-a4b-it | 지원 ID·개인 API 키, 요율. Free 계층은 입력·출력 무료이나 적용 모델과 한도가 제한된다. 확인일 2026-10-02 |
| OpenRouter | google/gemma-4-31b-it:free | 모델 소개·현재 가격, 무료 변형 조건. 현재 입력·출력 가격 0인 무료 항목을 선택한다. :free가 존재하는 모델만 가능하며 제공·요청 제한은 바뀔 수 있다. 확인일 2026-10-02 |
| OpenCode Zen | API space-bunny-free, OpenCode 설정 opencode/space-bunny-free | 공식 ID·가격·기간 조건. 기간 한정 무료다. 공개 가중치·내부 모델 버전은 미확인이므로 오픈 모델과 동일한 것으로 취급하지 않는다. 확인일 2026-10-02 |
| 로컬 Ollama·LM Studio | Gemma 4 후보, 실제 설치 ID·양자화는 설치 후 기록 | Gemma 4 모델 개요. 로컬 가중치 실행은 API 비용과 구분한다. 기기 자원이 필요하다. Ollama 태그 목록·LM Studio 카탈로그 등재는 미확인이며, 실행 명령을 추측해 쓰지 않는다. 확인일 2026-10-02 |
API마다 필드 이름과 지원 파라미터가 다르다. 대화 화면에서 설정을 노출하지 않으면 API 실험과 같은 조건이라고 단정하지 않는다. 이 문서에는 추론 코드나 키 공유 프록시를 넣지 않는다.
개인정보 주의
공개 업무 자료 대신 위 공통 과제만 넣는다. 실습 계정의 이메일 주소와 대화 기록에 이름·연락처·학생 제출물을 옮기지 않는다. 키를 발급한 뒤에는 보안의 커밋 제외 원칙을 따른다.
무료 등급에서는 입력과 출력이 제품 개선에 쓰일 수 있다. 요율표의 Free Tier는 "Content used to improve our products", Paid Tier는 "Content not used to improve our products"로 적고 있고, 결제 문서는 결제가 연결된 API 프로젝트가 하나라도 있으면 AI Studio 프롬프트도 유료 서비스 약정으로 본다고 밝힌다. 그래서 실습은 개인 데이터를 뺀 과제만 돌린다. Groq의 무료 등급 데이터 처리 방식은 미확인이다.
조건 고정
각 조건은 새 대화에서 최소 두 번 실행한다. 이전 대화나 에이전트의 룰·도구 출력이 붙으면 그 내용도 컨텍스트이므로 비교에서 제외하거나 함께 기록한다.
- 요청한 모델 ID와 응답에 나타난 버전·ID를 각각 적는다. 응답에 버전이 없으면
미노출로 적는다. - 실행 시각, 복사한 프롬프트 파일과 내용, 서비스와 연결 방식을 남긴다.
- temperature, top-p, 최대 출력 토큰, seed, thinking 설정은 지원하는 범위에서 같은 값으로 유지한다. 실습용 선택값은 temperature 0, top-p 1이며 제공자의 기본값을 뜻하지 않는다.
- 화면에서 값을 고칠 수 없거나 보이지 않으면
미지원·미노출로 적고 추정값을 채우지 않는다. 낮은 temperature도 두 출력이 같다는 보장은 아니다.
모바일에서는 메모 앱에 두 원문과 설정을 기록한다. 파일 기록을 쓰려면 공개 폴더의 records/template.json을 조건별로 복사한다. null은 실행 전 빈칸이며 통과를 뜻하지 않는다.
다섯 실험
1. 제로샷 기본선
prompts/01-zero-shot.txt의 전체 내용을 그대로 복사한다. 역할이나 예시는 추가하지 않는다. 새 대화 두 개의 출력에서 줄 수와 형식, 문자 수를 센다. 다른 조건을 비교할 기준선으로 보관한다.
2. 역할 지정
prompts/02-role.txt는 기본선 앞에 다음 한 문장을 붙인다.
text
커밋 메시지를 검토하는 역할로 다음 요청을 수행해.AI Studio에서는 이 문장을 Run settings의 System Instructions에 적고, 나머지 과제와 설정은 유지한다. 화면에 그 자리를 찾지 못한 서비스에서는 문장을 본문 앞에 붙여 넣고, 붙인 위치를 기록에 남긴다. 두 방식을 섞어 비교하지 않는다. 기본선과 비교해 설명이 추가됐는지, 형식이 바뀌었는지 센다. 역할 문장이 항상 품질을 높인다고 가정하지 않는다.
3. 출력 형식 지정
prompts/03-format.txt는 같은 과제에 다음 조건을 추가한다.
text
출력은 fix(<영문 범위>): <한국어 설명> 한 줄만 남겨.
코드 블록이나 추가 설명은 붙이지 마.파일 전체를 복사해 실행한다. 메시지 외에 설명·코드 울타리가 붙었는지, 실제 줄이 하나인지 확인한다. 형식을 자세히 지정해도 출력 검사 자체를 생략하지 않는다.
4. 퓨샷 개수
prompts/04-few-shot-0.txt부터 04-few-shot-3.txt까지 순서대로 실행한다. 0개 파일은 기본선과 같다. 1개는 장바구니 기능, 2개는 비밀번호 재설정 오류, 3개는 결제 중복 전송 오류 예시까지 붙인다. 이미 들어 있는 예시를 수정하지 않고 각 파일의 전체 내용을 복사한다.
예시 수마다 두 번 실행한다. 예시의 범위명이나 설명이 과제에 그대로 섞였는지, 원하는 형식이 유지됐는지 센다. 예시가 많을수록 좋다는 결론을 미리 정하지 않는다.
5. 부정 지시
prompts/05-negative.txt는 기본선에 금지 조건을 붙인다.
text
설명에 완벽, 무조건, 항상이라는 단어를 쓰지 마.
코드 블록이나 추가 설명은 붙이지 마.금지 단어가 출력에 몇 번 나타나는지 센다. 금지 문장을 넣었다는 사실과 출력이 조건을 지켰는지는 따로 확인한다.
확인표
각 조건마다 아래 네 열을 채운다. 형식은 한 줄의 fix(scope): 설명이며 범위는 영문 소문자·숫자·하이픈, 설명에는 한국어가 있는지 검사한다. 의미상 로그인 오류를 설명하는지와 입력에 없는 내용을 덧붙였는지는 원문과 사람이 대조한다.
| 형식 준수 | 금지 항목 없음 | 길이 | 두 번 돌려 같은가 |
|---|---|---|---|
| 실행 후 두 출력의 줄 수·형식을 기록 | ⑤에서는 금지 단어 발생 수를 세고 기록. 나머지는 적용 여부도 적음 | 두 출력의 문자 수 기록 | 두 원문이 같은지 기록 |
길이는 토큰 수가 아니라 Unicode code point 수다. 앞뒤 공백을 제거한 뒤 두 출력을 비교한다. 한 조건에서 두 번 같았다는 사실을 다른 모델·시각의 재현 보장으로 넓히지 않는다.
컴퓨터에서는 실행한 원문 두 파일을 개인 작업 사본에 저장한 뒤 검사한다.
sh
cd practice/prompt-lab
pnpm compare records/run-1.txt records/run-2.txt출력은 위 네 열을 JSON으로 채운다. 실제 모델 결과가 없는 상태를 검사기의 합성 테스트 문자열로 대신 채우지 않는다. 공유하기 전에는 출력에 키·개인 경로·계정 정보가 섞이지 않았는지 검토한다.
반복할 기준
차이는 먼저 관찰한 조건의 범위로 기록한다. 프롬프트 하나가 모든 작업에 통한다고 일반화하지 않는다. 반복해서 필요한 형식과 검사 기준은 룰·스킬로 옮기고, 다음 작업에서도 같은 검증을 적용한다.