# AI 리포트

Source: https://docs.rooquiz.com/ko/editor/ai-report

> AI 퀴즈가 응답자마다 개인 맞춤 리포트를 작성하는 방식을 설명합니다. 생성 지침 작성법, 리포트 분량, 스타일 및 규칙, 파일 업로드 문항에서 받을 수 있는 파일 형식과 한도, 응답자에게는 보이지 않는 내부 결과 태그, AI 크레딧 사용량과 크레딧이 모두 소진되었을 때 어떻게 되는지까지 다룹니다.

**AI 퀴즈**에서는 아무것도 채점하지 않습니다. 응답자가 제출하면 AI가 답변(그리고 업로드한 파일)을 읽고, 내가 준 지침에 따라 **개인 맞춤 리포트**를 작성합니다. 진단, 리뷰, 코칭 플랜처럼 리포트 자체가 제공하려는 가치일 때 이 유형을 선택하세요. [퀴즈 유형 고르기](https://docs.rooquiz.com/ko/getting-started/quiz-types#ai-퀴즈)을 참고하세요.

## 생성 지침 작성

편집기의 **리포트** 섹션을 엽니다. **생성 지침**에 리포트가 무엇을 다루고 어떻게 써야 하는지 AI에게 알려 주세요. 예를 들면 다음과 같습니다.

> 말하기 샘플을 유창성, 구성, 자신감 측면에서 평가하고, A1부터 C2까지 레벨을 매긴 뒤 강점 3가지와 연습할 점 3가지를 나열하고, 마지막에 2주 학습 계획으로 마무리하세요.

* 응답자의 답변과 업로드한 파일은 자동으로 AI에게 전달되므로 직접 붙여 넣을 필요가 없습니다.
* 특정 문항 하나를 가리키려면 편집기에서 **+**를 클릭해 해당 문항을 삽입하세요. 예: "\[희망 직무]에 맞춰 조언해 주세요".
* 지침을 비워 두면 AI가 강점과 제안을 담은 일반적인 요약을 작성합니다.
* 지침은 최대 20,000자까지 입력할 수 있습니다.

### 리포트 분량

**리포트 분량**에는 세 가지 설정이 있으며 기본값은 **표준**입니다.

| 설정     | 리포트에 담기는 내용             |
| ------ | ----------------------- |
| **간결** | 결론과 가장 중요한 1\~2가지 포인트   |
| **표준** | 결론, 핵심 발견 2\~3가지, 다음 단계 |
| **상세** | 발견 3\~5가지와 최대 3개의 차트    |

### 스타일 및 규칙

\*\*스타일 및 규칙 (선택)\*\*에서는 어조와 반드시 지킬 규칙을 최대 5,000자까지 정합니다. 예: "따뜻하고 격려하는 어조. 독자를 '당신'으로 부르기. 경쟁사는 절대 언급하지 않기." 여기에 쓴 분량 규칙은 **리포트 분량**보다 우선합니다.

<Callout type="info">
  편집기의 리포트 미리 보기에는 **샘플 리포트**가 표시됩니다. 실제 리포트는 내 지침과 각 응답자의 답변으로 응답자마다 따로 작성되므로, 두 응답자가 같은 글을 받는 일은 없습니다.
</Callout>

## 파일 업로드

AI 퀴즈에는 **파일 업로드 문항**을 넣어 AI가 이력서, 말하기 샘플, 제품 사진 같은 실제 결과물을 검토하게 할 수 있습니다. 업로드 문항 하나는 한 종류의 파일만 받습니다.

| 종류     | 허용 형식                                            | 파일당 한도       | AI가 읽는 방식          |
| ------ | ------------------------------------------------ | ------------ | ------------------ |
| 이미지    | JPG, PNG, WebP, GIF                              | 10 MB        | 이미지를 직접 봅니다        |
| 오디오    | MP3, M4A, WAV, WebM, OGG                         | 10 MB, 최대 3분 | 받아쓴 텍스트를 읽습니다      |
| 짧은 동영상 | MP4, WebM, MOV                                   | 20 MB, 최대 1분 | 오디오를 받아쓴 텍스트를 읽습니다 |
| 문서     | PDF, Word, Excel, PowerPoint, TXT, CSV, Markdown | 10 MB        | 문서의 텍스트를 읽습니다      |

* AI 퀴즈에는 업로드 문항을 **최대 2개**까지 둘 수 있으며, 문항마다 **최대 3개 파일**을 받습니다(더 적게 받으려면 **최대 파일 수**를 설정하세요).
* 업로드 문항은 파일을 수집만 하며 채점되지 않습니다.
* 업로드한 파일은 팀의 월간 **파일 업로드** 허용량에서 차감됩니다. [AI 크레딧과 파일 업로드](#ai-크레딧과-파일-업로드)를 참고하세요.

## 결과 태그

\*\*결과 태그 (선택)\*\*를 사용하면 AI가 응답자를 대신 분류해 줍니다. 태그는 **최대 10개**까지 추가할 수 있으며, 태그마다 이름과 언제 사용할지에 대한 평이한 규칙을 적습니다. 예: *구매 준비됨* — "예산이 있고 한 달 안에 시작하고 싶어 함". AI는 각 리포트를 작성하기 전에 가장 잘 맞는 태그 하나를 고릅니다.

* **응답자에게는 태그가 보이지 않습니다.** 응답자는 리포트 아래에 있는 해당 태그의 CTA 버튼만 봅니다.
* [응답 기록](https://docs.rooquiz.com/ko/results/records)에서 결과로 필터링하고 각 응답에 붙은 태그를 확인할 수 있습니다.
* 태그는 응답과 함께 [커넥터](https://docs.rooquiz.com/ko/connectors)로 전송되며, 조건으로 사용할 수도 있습니다. 예를 들어 Kit에서 구독자에게 태그를 붙이거나, *구매 준비됨*에만 맞춤 후속 이메일을 보낼 수 있습니다.
* 태그를 삭제해도 이미 그 태그가 붙은 리포트는 바뀌지 않습니다.

여러 AI 템플릿에는 바로 시작할 수 있도록 세 가지 예시 태그(바로 후속 조치 / 육성 / 시기상조)가 들어 있습니다.

## CTA 버튼

**CTA 버튼**에서 모든 AI 리포트 아래에 표시되는 **기본 버튼**을 설정하고, 필요하면 결과 태그마다 고유한 버튼을 지정합니다. 고유한 버튼이 없는 태그는 기본 버튼을 사용합니다. [결과 페이지 CTA 버튼](https://docs.rooquiz.com/ko/results/reports#결과-페이지-cta-버튼)을 참고하세요.

## 리포트 생성 방식

1. 응답자가 제출하면 리포트가 즉시 **생성되기** 시작하며, AI가 작성하는 대로 결과 페이지에 나타납니다.
2. 퀴즈가 **리포트를 보려면 이메일 필요**를 사용한다면 익명 응답자의 리포트는 **응답자가 이 단계를 통과한 뒤에** 생성됩니다. 이메일을 남기지 않는 사람에게는 AI 크레딧이 쓰이지 않습니다. 대시보드에서는 이런 응답에 "아직 리포트가 생성되지 않았습니다"가 표시되며, 지금 바로 생성할 수 있는 버튼이 함께 나옵니다.
3. 생성에 실패하면 자동으로 다시 시도합니다. 응답에서 직접 **리포트 다시 생성**을 할 수도 있습니다. [리포트](https://docs.rooquiz.com/ko/results/reports#리포트-다시-생성)를 참고하세요.

<Callout type="warning">
  리포트는 제출 후에 작성되므로, AI 퀴즈에서는 제출 후 응답자를 링크로 리디렉션하는 기능을 사용할 수 없습니다.
</Callout>

## AI 크레딧과 파일 업로드

AI 퀴즈 리포트 하나에는 **AI 크레딧 1개**가 사용됩니다. 모든 팀은 매월 1일(UTC)에 초기화되는 월간 허용량을 받습니다.

|           | Free   | Pro  |
| --------- | ------ | ---- |
| 월간 AI 크레딧 | 5      | 100  |
| 월간 파일 업로드 | 100 MB | 2 GB |

Pro 무료 체험 중에는 구독이 시작될 때까지 AI 크레딧이 Free 허용량으로 유지됩니다.

허용량을 다 쓰면 **충전**한 양이 사용됩니다. [부가 서비스](https://docs.rooquiz.com/ko/account#부가-서비스)를 참고하세요. 둘 다 소진되면 다음과 같이 처리됩니다.

* 응답자는 계속 답하고 제출할 수 있으며, **응답은 하나도 사라지지 않습니다**.
* 해당 리포트는 생성되지 않고, 팀의 AI 크레딧이 부족해 실패한 것으로 표시됩니다. 충전한 뒤 응답에서 다시 생성하세요.
* AI 크레딧이나 파일 업로드가 얼마 남지 않았을 때와 모두 소진되었을 때, 팀 소유자와 관리자에게 이메일과 앱 내 알림이 전송됩니다.

<Callout type="info">
  AI 크레딧은 AI 퀴즈 리포트에만 사용됩니다. 지식 퀴즈에서 빈칸 채우기 답안을 채점하는 **AI 일치 판정**은 무제한이며 크레딧을 쓰지 않습니다.
</Callout>
