> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# Summary And Document

> NoteDocument와 NoteSummary 이해하기

## 개요

Tiro는 두 가지 종류의 템플릿 기반 문서 생성 기능을 제공해요: **NoteDocument**와 **NoteSummary**. 이 둘은 목적과 API 지원이 다른 별개의 시스템이에요.

이들이 더 넓은 Note 구조(Paragraphs, Folders, 그리고 엔터티 간의 관계)에 어떻게 들어맞는지는 [Note Data Model](/ko/developers/fundamentals/note-data-model)을 참고하세요.

<img src="https://mintcdn.com/theplato/uefi7IlQm0V8Blgz/template_based_document.png?fit=max&auto=format&n=uefi7IlQm0V8Blgz&q=85&s=dd4310c97781834421086f01994861ca" alt="Template-based document types in Tiro" width="2636" height="1694" data-path="template_based_document.png" />

## NoteDocument vs NoteSummary

| 기능             | NoteDocument                      | NoteSummary            |
| -------------- | --------------------------------- | ---------------------- |
| **목적**         | 구조화된 회의 문서                        | 빠른 포맷 템플릿              |
| **템플릿**        | 회의록 (Meeting Minutes), Custom 템플릿 | One-Pager, Pitch 등     |
| **API 지원**     | ✅ 전체 지원                           | ✅ 전체 지원                |
| **Webhook 지원** | ✅ `note_document.*` 이벤트           | ✅ `note_summary.*` 이벤트 |
| **생성 방법**      | API 또는 Tiro 앱                     | Tiro 앱 전용              |

### NoteDocument

**NoteDocument**는 API를 통해 생성, 조회, 관리할 수 있는 구조화된 섹션 기반 문서를 위한 기능이에요.

**주요 특징:**

* 정의된 섹션을 가진 템플릿으로 생성
* 사용자 지시문이 포함된 custom 템플릿 지원
* 전체 API CRUD 작업 가능
* 실시간 알림을 위한 Webhook 이벤트

**예시 템플릿:**

* 회의록 (Meeting Minutes)
* 직접 만드는 custom 템플릿

**API endpoint:**

* `POST /v1/external/notes/{noteGuid}/documents` - 문서 생성
* `GET /v1/external/notes/{noteGuid}/documents` - 문서 목록 조회
* `GET /v1/external/notes/{noteGuid}/documents/{documentId}` - 문서 조회

### NoteSummary

**NoteSummary**는 다양한 표현 스타일을 위한 빠른 포맷 템플릿을 제공해요.

**주요 특징:**

* 특정 사용 사례(pitch, one-pager 등)에 최적화
* 요약 조회를 위한 전체 API 지원
* 실시간 알림을 위한 Webhook 이벤트
* 현재는 Tiro 앱 인터페이스를 통해서만 생성 가능

**예시 템플릿:**

* One-Pager
* Pitch
* 그 외 포맷별 템플릿

**API endpoint:**

* `GET /v1/external/notes/{noteGuid}/summaries` - 요약 목록 조회
* `GET /v1/external/notes/{noteGuid}/summaries/{summaryId}` - 콘텐츠가 포함된 요약 조회

**Webhook 이벤트:**

* `note_summary.generated` - 요약 생성 완료
* `note_summary.updated` - 요약 수정됨
* `note_summary.deleted` - 요약 삭제됨