AI GUIDE

상담 현장에서 바로 쓰는 AI 활용 가이드

AI로 만든 상담도구가 뜻대로 움직이지 않아도 괜찮습니다. 대부분의 문제는 증상을 정확히 설명하고, 하나씩 확인하면서 다시 수정하는 과정 에서 해결할 수 있습니다. 자주 발생하는 오류와 현장에서 바로 활용할 수 있는 해결 방법을 모았습니다.

QUICK TROUBLESHOOT

어떤 문제가 생겼나요?

FIRST CHECK

오류가 생겼다면 먼저 6가지만 확인하세요.

바로 처음부터 다시 만들기보다, 저장 상태와 파일 형식, 실행 환경부터 하나씩 확인하는 편이 훨씬 빠릅니다.

새로고침 수정한 파일이 실제로 저장되었는지 확인하고, 브라우저를 다시 새로고침합니다.

파일 확인 파일명이 .html로 끝나는지, 최신 버전의 파일을 열고 있는지 확인합니다.

환경 바꾸기 다른 브라우저나 PC·휴대폰에서도 같은 문제가 반복되는지 확인합니다.

문제 하나만 지정 전체를 다시 만들기보다 현재 가장 불편한 한 가지 문제부터 수정합니다.

AI에게 그대로 전달 오류 문구와 현재 증상을 생략하지 않고 그대로 알려주는 것이 가장 빠릅니다.

잘 되는 버전 저장 수정 전 정상 작동하는 HTML 파일을 따로 저장해 두면 문제가 생겼을 때 쉽게 돌아갈 수 있습니다.

COMMON ERRORS

자주 만나는 오류와 해결 방법

먼저 오류 유형을 선택하고,
필요한 문제를 열어 해결 방법을 확인해 보세요.

텍스트·AI 4개의 해결 가이드

문서 인코딩이 UTF-8이 아니면 한글이 깨질 수 있습니다.

1. HTML에 UTF-8 문자 인코딩 설정이 있는지 확인합니다.

2. 파일 자체도 UTF-8 방식으로 저장했는지 확인합니다.

3. AI에게 한글이 깨지지 않도록 UTF-8 기준으로 점검해 달라고 요청합니다.

같은 요청이어도 사용 중인 모델이 달라졌거나, 대화가 너무 길어졌거나, 서비스의 사용량 제한이 적용되면 이전과 결과가 다르게 느껴질 수 있습니다.

1. 이전과 같은 AI 모델을 사용하고 있는지 확인합니다.

2. 사용량 제한과 관련된 안내가 나타나지 않았는지 확인합니다.

3. 대화가 너무 길어졌다면 정상 작동 파일을 기준으로 새 대화에서 다시 시작합니다.

AI 서비스마다 방식은 다르지만, 일부 서비스는 고성능 모델이나 특정 기능에 코인·크레딧·사용량 한도를 둡니다. 한도에 도달하면 다른 모델로 전환되거나, 일부 기능을 잠시 사용할 수 없거나, 일정 시간 기다려야 할 수 있습니다.

1. 현재 화면에 사용량·크레딧·모델 제한 안내가 표시되는지 확인합니다.

2. 원하는 모델을 사용할 수 없는 상태라면 억지로 계속 수정하기보다 현재 가장 잘 작동하는 버전을 먼저 저장합니다.

3. 서비스에 따라 몇 시간 뒤 또는 다음 사용 주기에 사용량이 다시 제공될 수 있습니다. 정확한 시점은 사용하는 서비스의 안내를 확인합니다.

4. 사용 가능 상태가 회복되면 이전에 저장해 둔 정상 작동 파일을 다시 첨부하고 그 버전을 기준으로 작업을 이어갑니다.

5. 다시 시작할 때는 전체를 새로 만들게 하기보다 필요한 수정 한 가지씩 진행합니다.

AI에게 이렇게 요청해 보세요 “이 파일은 이전에 정상적으로 작동하던 최종 버전이야. 현재 디자인과 기능은 모두 유지하고, 지금 요청하는 부분만 수정해줘. 기존 기능을 임의로 삭제하거나 단순화하지 말고 수정된 전체 코드를 다시 제공해줘.”

한 대화에서 수정 요청을 오래 이어가면 앞에서 정한 조건과 새 요청이 섞이는 경우가 있습니다.

1. 가장 잘 작동했던 HTML 파일을 저장합니다.

2. 필요하면 새 대화를 열고 그 파일을 다시 전달합니다.

3. 이번에 수정할 내용만 구체적으로 한 가지씩 알려줍니다.

4. “나머지 기능과 디자인은 변경하지 말 것”을 함께 적습니다.

TALK TO AI

오류를 만났을 때는
AI에게 이렇게 설명해 보세요.

새 도구를 처음부터 만드는 프롬프트가 아니라, 이미 만든 도구를 고칠 때 바로 사용할 수 있는 간단한 요청 문장입니다.

기능 오류

“현재 전체 코드는 아래와 같아. 다른 기능과 디자인은 유지하고, [버튼명]을 눌러도 작동하지 않는 원인만 찾아 수정해줘. 수정 후에는 전체 코드를 다시 제공해줘.”

화면 오류

“PC에서는 정상인데 모바일에서 오른쪽이 잘려. 현재 디자인은 최대한 유지하면서 좌우 스크롤이 생기지 않는 반응형 구조로 수정해줘.”

출력 오류

“현재 화면은 괜찮은데 PDF·인쇄 결과가 다르게 보여. A4 기준 인쇄용 CSS를 추가하고 페이지가 중간에 잘리지 않게 정리해줘.”

원인 분리형 요청

“처음부터 다시 만들지 말고 원인부터 찾아줘. 오류가 발생할 가능성이 높은 부분을 설명한 뒤 가장 작은 수정부터 적용해줘.”

WORKING TIPS

AI와 앱을 만들 때 기억하면 좋은 습관

처음부터 완벽하게 만들기보다 작은 단계로 나누고 자주 테스트하는 것이 훨씬 안정적입니다.

한 단계씩 요청하기 화면 → 기능 → 저장 → 모바일처럼 작은 단계로 나누어 완성해 나갑니다.

잘 되는 버전은 반드시 저장 수정하기 전 정상 작동 HTML을 복사해 두면 오류가 생겼을 때 빠르게 돌아갈 수 있습니다.

증상을 구체적으로 말하기 “안돼요”보다 실제로 무엇을 눌렀고 어떤 결과가 나타났는지를 설명합니다.

PC와 모바일 모두 테스트 상담실 PC뿐 아니라 태블릿과 스마트폰에서도 실제 화면을 확인합니다.

AI 사용량도 확인 사용하는 서비스에서 고성능 모델·크레딧·요청 한도에 제한이 있는지 확인합니다.

회복되면 다시 이어가기 사용량 제한에 도달했다면 정상 버전을 저장한 뒤 사용 가능 상태가 회복되었을 때 다시 이어갑니다.

SAFETY PRINCIPLES

AI를 사용하기 전에 반드시 지켜야 할 것

편리함보다 먼저, 학생의 안전과 개인정보 보호를 생각해야 합니다.

학생을 특정하지 않기 이름·학번·학교명·연락처 등 식별 가능한 정보는 입력하지 않습니다.

가명과 일반화 사용 학생A처럼 가명을 사용하고 필요한 상황만 일반화하여 설명합니다.

AI 결과 다시 확인하기 AI가 만든 분석과 문구는 상담교사가 최종적으로 다시 검토합니다.

인증정보 보호하기 API 키나 계정 인증정보를 학생에게 노출되는 HTML 코드에 직접 넣지 않습니다.