> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> 교육 콘텐츠(강의 자료·교재·매뉴얼)를 기반으로 학습·교육용 Q&A 에이전트 구축

# Edu qa

# 교육 자료 Q\&A 시나리오

> **목표**: 강의 슬라이드·교재 PDF·매뉴얼 영상 자막을 Seahorse Storage 에 올려 **학습자 질의에 교재 기반으로 답변** 하는 튜터 에이전트 구축. 학습 진행 맥락을 Memory facts 로 기억.

## 구성 요약

```
[PDF 교재·PPTX 강의자료·DOCX 핸드아웃]
            │
            ▼
       Storage (과목별)
            │ 자동 임베딩
       Table (벡터)
            │
            ▼
       Agent (학습 튜터 역할)
       + Memory facts (학습자 진도·선호 기억)
            │
       Agent Chat (학생/수강자)
            ▼
   "2장 핵심 개념 3개 요약해줘" / "이전 퀴즈 틀린 부분 복습"
```

***

## 페르소나별 역할

<Tabs>
  <Tab title="교수자 · 콘텐츠 담당">
    **역할**: 강의 자료 업로드·구조화

    * 과목·주차별 Storage 분리 (`course-ai-basics`, `course-ai-advanced`)
    * PPTX·PDF·DOCX·HWP 지원 — 교재·슬라이드·핸드아웃
    * 동영상 자막(SRT·VTT → TXT)도 업로드

    **사용 문서**:

    * [Storage 생성](/console/storage/storage-create)
    * [지원 확장자 37종](/console/storage/storage-detail#support-extension-지원-확장자) — 교육 자료 대부분 포함
  </Tab>

  <Tab title="학습 운영 담당">
    **역할**: 에이전트 · Rule 구성

    * *(준비중)* Rule Set: **"정답만 주지 말고 생각을 유도"**, **"학년 수준에 맞게 설명"**
    * System Prompt: 튜터 페르소나 (친절·단계별 설명)
    * Memory facts 활용: 학습자 학년·진도·관심사 기억

    **사용 문서**:

    * [System Prompts](/console/agent-ops/system-prompts)
    * [Agent Rules](/console/agent-ops/agent-rules)
    * [Memory facts](/agent-chat/user-menu/memory-facts)
  </Tab>

  <Tab title="학생 · 수강자">
    **역할**: Agent Chat 에서 학습 질의

    **예시**:

    * "3장 내용 퀴즈 5개 만들어줘"
    * "어제 배운 Transformer 내용을 초등학생 수준으로 설명해줘"
    * "내가 자주 틀리는 부분 알려줘 (Memory facts 참조)"
    * "이 슬라이드 14 페이지 수식을 단계별로 풀이해줘"

    **사용 문서**:

    * [Agent Chat 개요](/agent-chat)
    * [Memory facts](/agent-chat/user-menu/memory-facts)
  </Tab>
</Tabs>

## Console 구성 단계

<Steps>
  <Step title="과목별 Storage 생성·업로드">
    강의 자료를 과목·주차별로 체계화 후 업로드.
  </Step>

  <Step title="튜터 System Prompt 작성">
    ```
    당신은 친절한 AI 튜터입니다.
    - 정답을 바로 주지 말고, 힌트부터 주어 학습자가 스스로 답을 찾도록 유도합니다.
    - 교재 외 내용이면 "교재에 없으니 추가 확인 필요" 로 답합니다.
    - 복잡한 개념은 단계별로·예시와 함께 설명합니다.
    - Memory facts 에서 학습자의 학년·선호·진도를 참조해 맞춤 응답합니다.
    ```
  </Step>

  <Step title="Agent 생성">
    * 모델: `claude-opus-4.5` (설명 품질) / 대량 사용자면 `gpt-oss-120b` (비용)
    * 테이블: 과목 Storage Table 연결
    * 도구: Web Search (심화 참고 자료)
    * *(준비중)* 규칙: "정답만 주지 않기", "학년 수준"
  </Step>

  <Step title="Memory facts 활성화 안내">
    학생이 **사용자 메뉴 → Memory facts** 에서 학년·관심 주제·틀린 문제 직접 추가 가능.
  </Step>

  <Step title="배포 · 학생 공지">
    배포 URL 과 사용법 공유. 학생 계정 생성 안내.
  </Step>
</Steps>

## 체크리스트

* [ ] 과목별 Storage 분류 체계
* [ ] 튜터 System Prompt (교육적 톤·힌트 유도)
* [ ] Memory facts 개인정보 수집 동의 안내
* [ ] 부적절한 질문 Rule 차단

## 관련 문서

* [Console 활용 가이드 목록](/console/guides)
* [Memory facts](/agent-chat/user-menu/memory-facts)
* [Agent Rules](/console/agent-ops/agent-rules)