Reference 문서 분석 - 사용자 가이드
프로젝트에 참고 자료(PDF)를 올려 AI가 읽을 수 있는 형태로 바꾸고, 그 내용을 챗봇에게 물어보는 방법을 안내합니다. 업로드 옵션(처리 모드·모델 등급), 처리 과정과 문서 상태, 챗봇 질의 방법, 비용까지 순서대로 다룹니다.
Last Updated: 2026-02-21
1. 소개
TFLOW의 Reference 문서 분석 기능은 업로드한 PDF 문서를 AI가 읽고 검색할 수 있는 형태로 바꿔 둡니다. 이렇게 정리된 문서는 AI 챗봇이 내용을 정확히 이해하고 답변하는 근거가 됩니다.
문서를 업로드할 때 처리 모드와 모델 등급을 선택할 수 있습니다.
프로젝트별 문서 격리
각 프로젝트에 업로드된 문서는 해당 프로젝트 내에서만 검색됩니다. 프로젝트 A에서 업로드한 문서가 프로젝트 B의 검색 결과에 나타나지 않으므로, 프로젝트별로 독립적인 지식 베이스가 유지됩니다.
2. 문서 업로드
업로드가 막혔다면 — "중복된 문서가 감지되었습니다" 는 같은 문서가 이미 올라가 있다는 뜻이니 목록에서 확인하세요. "참조 문서를 찾을 수 없습니다" 나 원본 파일을 찾을 수 없다는 안내가 뜨면 파일이 정상 업로드되지 않은 것이므로 다시 업로드하면 됩니다.
2.1 업로드 화면 접근
- 프로젝트 상세 페이지에서 Reference Documents 탭을 선택합니다
- Upload 버튼을 클릭하여 업로드 모달을 엽니다
- PDF 파일을 드래그 앤 드롭하거나 클릭하여 선택합니다
2.2 처리 옵션 선택
업로드 영역 아래에 두 가지 옵션이 표시됩니다.
처리 방식
| 화면 표기 | 설명 | 권장 상황 |
|---|---|---|
| 실시간 | 즉시 처리를 시작하여 빠르게 완료됩니다 | 10페이지 이하 소규모 문서, 긴급한 경우 |
| 배치 (50% 할인) | 배치 처리로 비용이 50% 절감됩니다 | 20페이지 이상 대규모 문서, 비용 절약이 중요한 경우 |
배치를 선택하면 문서 분석이 백그라운드에서 진행되며, 완료 시 알림을 받습니다. 대부분 10분 이내에 완료됩니다.
모델 등급
| 화면 표기 | 설명 | 권장 상황 |
|---|---|---|
| 프리미엄 (Opus) — 5x | 최고 품질로 분석합니다. 토큰은 가장 많이 씁니다 | 복잡한 기술 문서, 높은 정확도가 필요한 경우 |
| 스탠다드 (Sonnet) — 3x | 품질과 비용의 균형 (기본값) | 일반적인 문서 |
| 베이식 (Haiku) — 1x | 가장 경제적입니다 | 간단한 문서, 비용이 가장 중요한 경우 |
등급 옆의
5x·3x·1x는 토큰이 몇 배로 쓰이는지를 뜻합니다.
2.3 업로드 실행
옵션을 선택한 후 Upload 버튼을 클릭하면 문서 분석이 시작됩니다. 문서 상태가 분석 중 에서 분석 완료 로 바뀌면 그 문서를 AI 챗봇에서 질의할 수 있습니다. 배치는 백그라운드에서 처리되므로 화면을 닫아도 되며, 완료되면 알림을 받습니다.
3. 처리 과정
"이미 분석 중인 문서입니다"가 떴다면 — 같은 문서의 분석이 이미 돌고 있습니다. 완료 알림이 올 때까지 기다리세요(보통 10분 이내). 다시 올릴 필요 없습니다.
실시간
- 업로드 즉시 분석이 시작됩니다
- 문서 상태가 분석 중 → 분석 완료 로 바뀝니다
- 완료 후 즉시 AI 챗봇에서 문서 내용을 질의할 수 있습니다
배치
- 업로드 후 처리 대기열에 등록됩니다
- 백그라운드에서 문서를 읽어 AI가 검색할 수 있는 형태로 바꿉니다(대부분 10분 이내)
- 문서 목록의 배치 배지를 클릭하면 "문서 변환 중 (1/5)" 처럼 지금 어디까지 진행됐는지 볼 수 있습니다
- 완료 시 알림을 받습니다
문서 상태
| 화면 표기 | 의미 |
|---|---|
| 업로드 중 | 파일 업로드 중 |
| 대기 중 | 처리 대기 중 |
| 분석 중 | 분석 진행 중 |
| 분석 완료 | AI 챗봇에서 사용 가능 |
| 분석 실패 | 삭제 후 다시 업로드해 보세요 |
4. AI 챗봇으로 문서 질의
문서가 분석 완료 상태가 되면 CYGNUS AI 챗봇에서 해당 문서 내용에 대해 질문할 수 있습니다.
4.1 챗봇 사용
- Reference Documents 탭 하단의 채팅 영역에서 질문을 입력합니다
- AI가 해당 프로젝트의 분석 완료된 문서들을 검색하여 답변합니다
- 답변에는 검색된 근거 문서의 참조 정보가 포함됩니다
4.2 검색 모드
| 모드 | 설명 |
|---|---|
| Auto | AI가 질문 유형에 따라 최적의 검색 방식을 자동 선택 (기본값) |
| Hybrid | 벡터 + 전문 검색 조합 |
| Vector | 의미 기반 유사도 검색 |
| Fulltext | 키워드 기반 전문 검색 |
| Section | 문서 섹션 단위 검색 |
4.3 문서 필터링
특정 문서에 대해서만 질의하고 싶을 때는 문서 필터를 사용하여 검색 범위를 좁힐 수 있습니다. 필터를 설정하지 않으면 현재 프로젝트의 분석 완료된 모든 문서에서 검색합니다.
5. 비용 안내
문서 분석에는 AI 모델 사용 토큰이 소비됩니다. 처리 모드와 모델 등급에 따라 비용이 달라집니다.
비용 비교 (100페이지 문서 기준)
| 조합 | 상대 비용 |
|---|---|
| 실시간 + 프리미엄 | ★★★★★ (최고) |
| 실시간 + 스탠다드 | ★★★ |
| 실시간 + 베이식 | ★★ |
| 배치 + 스탠다드 | ★★ (실시간 대비 50% 절약) |
| 배치 + 베이식 | ★ (가장 경제적) |
잔여 토큰은 화면 상단 네비게이션 바의 토큰 게이지에서 확인할 수 있습니다.
6. FAQ
처리 시간과 모델 선택
Q: 배치로 업로드했는데 언제 완료되나요?
대부분 10분 이내에 완료됩니다. 문서 크기와 처리량에 따라 달라질 수 있으며, 최대 24시간까지 소요될 수 있습니다. 완료 시 알림을 받습니다.
Q: 분석 중에 다른 작업을 할 수 있나요?
네. 배치는 완전히 백그라운드에서 동작하므로 다른 작업을 자유롭게 할 수 있습니다. 실시간도 다른 페이지로 이동해도 분석이 계속됩니다.
Q: 어떤 모델 등급을 선택해야 하나요?
기술 사양서나 계약서처럼 정확도가 중요한 문서는 스탠다드 이상을 권장합니다. 간단한 참고 자료는 베이식으로도 충분합니다.
Q: 분석이 실패했습니다. 어떻게 하나요?
문서 목록에서 해당 문서를 삭제한 뒤 다시 업로드해 보세요. 그래도 실패하면 고객 의견으로 알려 주세요. 실패한 경우에도 사용한 토큰은 차감됩니다.
업로드·토큰·프로젝트 격리
Q: 한 번에 여러 문서를 업로드할 수 있나요?
네. 여러 파일을 동시에 드래그 앤 드롭하거나 선택할 수 있습니다. 각 문서는 독립적으로 처리됩니다.
Q: 토큰이 부족하면 어떻게 되나요?
잔액이 0 이하이면 분석이 시작되지 않습니다. 상단 번개(⚡) 잔액 위젯에서 토큰을 충전하거나, 결제 권한이 없다면 회사 마스터에게 충전을 요청하세요.
Q: 다른 프로젝트에서 업로드한 문서가 보이나요?
아니요. 각 프로젝트의 문서는 완전히 격리되어 있습니다. 프로젝트 A에서 업로드한 문서는 프로젝트 A의 챗봇에서만 검색되며, 프로젝트 B에서는 접근할 수 없습니다.
Q: 같은 파일을 여러 프로젝트에서 사용하고 싶습니다.
각 프로젝트에서 개별적으로 업로드해야 합니다. 동일한 파일이라도 프로젝트마다 따로 분석됩니다.