메인 콘텐츠로 건너뛰기

개요

Tiro는 두 가지 종류의 템플릿 기반 문서 생성 기능을 제공해요: NoteDocumentNoteSummary. 이 둘은 목적과 API 지원이 다른 별개의 시스템이에요. 이들이 더 넓은 Note 구조(Paragraphs, Folders, 그리고 엔터티 간의 관계)에 어떻게 들어맞는지는 Note Data Model을 참고하세요. Template-based document types in Tiro

NoteDocument vs NoteSummary

기능NoteDocumentNoteSummary
목적구조화된 회의 문서빠른 포맷 템플릿
템플릿회의록 (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 - 요약 삭제됨