Summary And Document

​

개요

Tiro에는 NoteDocument와 NoteSummary가 있어요. 용도와 생성 방법이 달라요. 전체 Note 구조는 노트 데이터 모델을 참고하세요.

​

NoteDocument vs NoteSummary

​

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 - 요약 삭제됨