Reference 문서 분석 - 사용자 가이드
프로젝트에 참고 자료(PDF)를 올려 AI가 읽을 수 있는 형태로 바꾸고, 그 내용을 챗봇에게 물어보는 방법을 안내합니다. 업로드 옵션(처리 모드·모델 등급), 처리 과정과 문서 상태, 챗봇 질의 방법, 비용까지 순서대로 다룹니다.
Last Updated: 2026-02-21
1. 소개
TFLOW의 Reference 문서 분석 기능은 업로드한 PDF 문서를 AI가 분석하여 Knowledge Graph로 변환합니다. 변환된 문서는 AI 챗봇이 문서 내용을 정확하게 이해하고 질의응답할 수 있는 기반이 됩니다.
문서를 업로드할 때 처리 모드와 모델 등급을 선택할 수 있습니다.
프로젝트별 문서 격리
각 프로젝트에 업로드된 문서는 해당 프로젝트 내에서만 검색됩니다. 프로젝트 A에서 업로드한 문서가 프로젝트 B의 검색 결과에 나타나지 않으므로, 프로젝트별로 독립적인 지식 베이스가 유지됩니다.
2. 문서 업로드
2.1 업로드 화면 접근
- 프로젝트 상세 페이지에서 Reference Documents 탭을 선택합니다
- Upload 버튼을 클릭하여 업로드 모달을 엽니다
- PDF 파일을 드래그 앤 드롭하거나 클릭하여 선택합니다
2.2 처리 옵션 선택
업로드 영역 아래에 두 가지 옵션이 표시됩니다.
Processing Mode (처리 모드)
| 모드 | 설명 | 권장 상황 |
|---|---|---|
| Realtime | 즉시 처리를 시작하여 빠르게 완료됩니다 | 10페이지 이하 소규모 문서, 긴급한 경우 |
| Batch (50% OFF) | 배치 처리로 비용이 50% 절감됩니다 | 20페이지 이상 대규모 문서, 비용 절약이 중요한 경우 |
Batch 모드를 선택하면 문서 분석이 백그라운드에서 진행되며, 완료 시 알림을 받습니다. 대부분 10분 이내에 완료됩니다.
Model Tier (모델 등급)
| 등급 | 설명 | 권장 상황 |
|---|---|---|
| Premium (Opus) | 최고 품질의 AI 모델을 사용합니다 | 복잡한 기술 문서, 높은 정확도가 필요한 경우 |
| Standard (Sonnet) | 품질과 비용의 균형을 갖춘 기본 모델입니다 | 일반적인 문서 (기본값) |
| Basic (Haiku) | 가장 경제적인 모델을 사용합니다 | 간단한 문서, 비용이 가장 중요한 경우 |
2.3 업로드 실행
옵션을 선택한 후 Upload 버튼을 클릭하면 문서 분석이 시작됩니다. 문서 상태가 analysing에서 indexed로 바뀌면 그 문서를 AI 챗봇에서 질의할 수 있습니다. Batch 모드는 백그라운드에서 처리되므로 화면을 닫아도 되며, 완료되면 알림을 받습니다.
3. 처리 과정
Realtime 모드
- 업로드 즉시 분석이 시작됩니다
- 문서 상태가
analysing→indexed로 변경됩니다 - 완료 후 즉시 AI 챗봇에서 문서 내용을 질의할 수 있습니다
Batch 모드
- 업로드 후 배치 작업이 등록됩니다
- 백그라운드에서 단계별로 처리됩니다:
- 문서 이미지 변환 및 OCR
- 마크다운 변환
- 섹션 분할 및 청킹
- 지식 트리플 추출
- Knowledge Graph 적재
- 섹션 요약 생성
- 완료 시 알림을 받습니다
- 문서 목록에서 상태를 확인할 수 있습니다
문서 상태
| 상태 | 의미 |
|---|---|
| Uploading | 파일 업로드 중 |
| Waiting | 처리 대기 중 |
| Analysing | 분석 진행 중 |
| Indexed | 분석 완료, AI 챗봇에서 사용 가능 |
| Failed | 분석 실패 (관리자에게 문의) |
4. AI 챗봇으로 문서 질의
문서가 Indexed 상태가 되면 CYGNUS AI 챗봇에서 해당 문서 내용에 대해 질문할 수 있습니다.
4.1 챗봇 사용
- Reference Documents 탭 하단의 채팅 영역에서 질문을 입력합니다
- AI가 해당 프로젝트의 인덱싱된 문서들을 검색하여 답변합니다
- 답변에는 검색된 근거 문서의 참조 정보가 포함됩니다
4.2 검색 모드
| 모드 | 설명 |
|---|---|
| Auto | AI가 질문 유형에 따라 최적의 검색 방식을 자동 선택 (기본값) |
| Hybrid | 벡터 + 전문 검색 조합 |
| Vector | 의미 기반 유사도 검색 |
| Fulltext | 키워드 기반 전문 검색 |
| Section | 문서 섹션 단위 검색 |
4.3 문서 필터링
특정 문서에 대해서만 질의하고 싶을 때는 문서 필터를 사용하여 검색 범위를 좁힐 수 있습니다. 필터를 설정하지 않으면 현재 프로젝트의 모든 인덱싱된 문서에서 검색합니다.
5. 비용 안내
문서 분석에는 AI 모델 사용 토큰이 소비됩니다. 처리 모드와 모델 등급에 따라 비용이 달라집니다.
비용 비교 (100페이지 문서 기준)
| 조합 | 상대 비용 |
|---|---|
| Realtime + Premium | ★★★★★ (최고) |
| Realtime + Standard | ★★★ |
| Realtime + Basic | ★★ |
| Batch + Standard | ★★ (Realtime 대비 50% 절약) |
| Batch + Basic | ★ (가장 경제적) |
잔여 토큰은 화면 상단 네비게이션 바의 토큰 게이지에서 확인할 수 있습니다.
6. FAQ
처리 시간과 모델 선택
Q: Batch 모드로 업로드했는데 언제 완료되나요?
대부분 10분 이내에 완료됩니다. 문서 크기와 서버 부하에 따라 달라질 수 있으며, 최대 24시간까지 소요될 수 있습니다. 완료 시 알림을 받습니다.
Q: 분석 중에 다른 작업을 할 수 있나요?
네. Batch 모드는 완전히 백그라운드에서 동작하므로 다른 작업을 자유롭게 할 수 있습니다. Realtime 모드도 다른 페이지로 이동해도 분석이 계속됩니다.
Q: 어떤 모델 등급을 선택해야 하나요?
기술 사양서나 계약서처럼 정확도가 중요한 문서는 Standard 이상을 권장합니다. 간단한 참고 자료는 Basic으로도 충분합니다.
Q: 분석이 실패했습니다. 어떻게 하나요?
문서 목록에서 해당 문서를 삭제 후 다시 업로드하거나, 관리자에게 문의하세요. 실패한 경우에도 사용한 토큰은 차감됩니다.
업로드·토큰·프로젝트 격리
Q: 한 번에 여러 문서를 업로드할 수 있나요?
네. 여러 파일을 동시에 드래그 앤 드롭하거나 선택할 수 있습니다. 각 문서는 독립적으로 처리됩니다.
Q: 토큰이 부족하면 어떻게 되나요?
잔액이 0 이하이면 분석이 시작되지 않습니다. 관리자에게 토큰 충전을 요청하세요.
Q: 다른 프로젝트에서 업로드한 문서가 보이나요?
아니요. 각 프로젝트의 문서는 완전히 격리되어 있습니다. 프로젝트 A에서 업로드한 문서는 프로젝트 A의 챗봇에서만 검색되며, 프로젝트 B에서는 접근할 수 없습니다.
Q: 같은 파일을 여러 프로젝트에서 사용하고 싶습니다.
각 프로젝트에서 개별적으로 업로드해야 합니다. 동일한 파일이라도 프로젝트별로 독립적인 Knowledge Graph가 생성됩니다.
7. 관련 문서
- CYGNUS 배치 처리 관리자 가이드 (관리자용 — 사내 문서, 이 사이트에는 공개하지 않습니다)