개요
Tiro는 두 가지 종류의 템플릿 기반 문서 생성 기능을 제공해요: NoteDocument와 NoteSummary. 이 둘은 목적과 API 지원이 다른 별개의 시스템이에요. 이들이 더 넓은 Note 구조(Paragraphs, Folders, 그리고 엔터티 간의 관계)에 어떻게 들어맞는지는 Note Data Model을 참고하세요.
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 템플릿
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
- 그 외 포맷별 템플릿
GET /v1/external/notes/{noteGuid}/summaries- 요약 목록 조회GET /v1/external/notes/{noteGuid}/summaries/{summaryId}- 콘텐츠가 포함된 요약 조회
note_summary.generated- 요약 생성 완료note_summary.updated- 요약 수정됨note_summary.deleted- 요약 삭제됨