이 가이드는 Discourse에서 AI 봇과 상호작용할 때 네이티브 PDF 및 문서 첨부 지원 기능을 활성화하고 사용하는 방법에 대해 설명합니다. 사용자는 AI 에이전트와의 대화에서 PDF 및 기타 문서를 직접 업로드할 수 있습니다.
필요한 사용자 권한: 관리자
요약
Discourse AI는 이제 네이티브 첨부 파일 처리를 지원하여 사용자가 AI 봇과 대화하는 동안 PDF 및 기타 문서 유형을 직접 업로드할 수 있습니다. AI는 이러한 첨부 파일의 내용을 읽고 이해할 수 있어 문서 분석, 요약, 업로드된 파일 기반 질의응답과 같은 사용 사례를 가능하게 합니다.
이 기능을 사용하려면 다음이 필요합니다:
- LLM에 허용된 첨부 파일 유형이 설정되어 있어야 합니다.
- 비전(Vision) 기능이 활성화된 에이전트가 있어야 합니다(이는 업로드가 메시지에 포함되는지 여부를 제어합니다).
- 파일 확장자가 사이트의 업로드 설정에서 승인되어 있어야 합니다.
지원되는 제공업체
네이티브 첨부 파일 지원은 다음 제공업체의 모델과 함께 작동합니다:
- Anthropic (Claude 모델)
- AWS Bedrock (Bedrock을 통한 Claude 모델)
- Google (Gemini 모델)
- OpenAI (GPT 모델)
- Azure (OpenAI 호환 모델)
- OpenRouter (OpenAI 호환 모델)
각 제공업체는 API 레벨에서 첨부 파일을 다르게 처리하지만, Discourse AI는 이를 자동으로 관리합니다. 다양한 첨부 파일 유형에 대한 지원 수준은 제공업체마다 다르다는 점을 유의하세요.
지원되는 첨부 파일 유형
다음과 같은 문서 유형을 AI 처리를 위해 설정할 수 있습니다:
| 유형 | 확장자 |
|---|---|
pdf |
|
| 일반 텍스트 | txt |
| Microsoft Word | doc, docx |
| Rich Text Format | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
이미지는 “비전 활성화” 설정을 통해 별도로 처리되며 첨부 파일 유형 설정이 필요하지 않습니다.
설정
1단계: 업로드용 파일 확장자 승인
사용자가 첨부 파일을 업로드할 수 있도록 하려면 사이트 설정에서 파일 확장자가 승인되었는지 확인하세요.
- 관리자 → 파일로 이동합니다.
authorized extensions(승인된 확장자) 설정을 찾습니다.- 허용할 확장자를 추가합니다(예:
pdf|txt|docx).
2단계: LLM 모델 구성
- 관리자 → 플러그인 → Discourse AI → LLM으로 이동합니다.
- 구성할 LLM 모델을 선택하거나(또는 새 모델을 생성합니다).
- 허용된 첨부 파일 필드에서 모델이 받아들이도록 할 파일 확장자를 선택하거나 입력합니다(예:
pdf,txt,docx).
“허용된 첨부 파일” 필드를 비워 두면 해당 모델에 대한 문서 첨부 기능이 비활성화됩니다. 이미지는 “비전 활성화” 토글을 통해 별도로 제어됩니다.
3단계: 에이전트 구성
- 관리자 → 플러그인 → Discourse AI → 에이전트로 이동합니다.
- 에이전트를 선택하거나 생성합니다.
- 비전 활성화가 켜져 있는지 확인하세요 — 이는 업로드(이미지 및 문서 모두)가 LLM으로 전송되는 메시지에 포함되는지 여부를 제어합니다.
- 기본 모델을 첨부 파일이 구성된 LLM으로 설정합니다.
작동 원리
사용자가 AI 봇과의 대화에서 문서를 업로드하면:
- 문서는 표준 업로드 처리를 사용하여 Discourse에 업로드됩니다.
- Discourse AI가 문서 내용을 인코딩합니다(base64).
- 인코딩된 내용이 사용자의 메시지와 함께 LLM으로 전송됩니다.
- LLM이 텍스트 메시지와 문서 내용 모두를 처리합니다.
- AI가 결합된 컨텍스트에 기반하여 응답합니다.
기술적 세부 사항
- 문서는 base64로 인코딩되어 요청과 함께 인라인으로 전송됩니다.
- 각 제공업체는 첨부 파일을 네이티브 형식으로 수신합니다:
- Anthropic: base64 소스를 가진
document유형 사용 - Gemini:
inlineData형식 사용 - OpenAI (Chat Completions API): base64 내용을 포함하는
file_data를 가진file유형 사용 - OpenAI (Responses API): base64 내용을 포함하는
file_data를 가진input_file유형 사용
- Anthropic: base64 소스를 가진
- 파일 크기 제한은 사이트의
max attachment size kb(최대 첨부 파일 크기 kb) 설정에 의해 결정됩니다.
사용 사례
네이티브 첨부 파일 지원은 여러 워크플로를 가능하게 합니다:
- 문서 분석: 계약서, 보고서 또는 연구 논문을 업로드하여 AI가 요약하거나 질문에 답하도록 합니다.
- 콘텐츠 검토: AI가 초안 문서를 검토하고 피드백을 제공하도록 합니다.
- 데이터 추출: 업로드된 문서에서 특정 정보를 추출합니다.
- 번역 지원: 한 언어로 된 문서를 업로드하고 내용을 논의하거나 번역을 요청합니다.
- 기술 지원: 사용자는 문제 해결을 위해 로그 파일이나 설정 파일을 업로드할 수 있습니다.
제한 사항
- 파일 크기: 첨부 파일은 사이트의 업로드 크기 설정 및 LLM 벤더에 의해 제한됩니다.
- 제공업체 지원: 첨부 파일 지원은 문서를 처리하는 제공업체 변형이 필요합니다(Anthropic, AWS Bedrock, Google, OpenAI, Azure, OpenRouter).
- 에이전트 비전 요구 사항: 업로드가 메시지에 포함되려면 에이전트의 "비전 활성화"가 켜져 있어야 합니다.
- 확장자 일치: 파일 확장자는 사이트에서 업로드가 승인되어 있을 뿐만 아니라 LLM의 첨부 파일 유형 구성에서도 허용되어야 합니다.
- 결과 차이: LLM 벤더와 LLM이 파일을 처리하므로 비용/정확도 및 결과는 다를 수 있습니다. Anthropic은 OpenAI나 Google보다 분석에 더 많은 토큰을 사용하는 경향이 있습니다.
- 캐싱 활성화: Open AI의 경우 캐싱에 대한 더 일관된 지원을 제공하는 responses API를 사용하도록 하세요(생각(thinking)이 활성화된 경우). Anthropic 모델의 경우 LLM 구성에서 캐싱을 명시적으로 활성화해야 할 수 있습니다. 이는 다중 턴 대화에서 특히 중요할 수 있습니다.
문제 해결
첨부 파일이 처리되지 않는 경우
- 파일 확장자가 사이트의
authorized extensions(승인된 확장자) 설정에 있는지 확인합니다. - 파일 유형이 LLM의 “허용된 첨부 파일” 설정에 나열되어 있는지 확인합니다.
- 에이전트가 "비전 활성화"를 켜고 올바르게 구성된 LLM을 사용하도록 확인합니다.
업로드가 실패하는 경우
max attachment size kb(최대 첨부 파일 크기 kb) 설정을 확인합니다.- 파일 확장자가 승인되었는지 확인합니다.
- 매우 큰 PDF는 지원되지 않을 수 있으며, 각 LLM 벤더마다 최대 업로드 크기가 다릅니다.
AI가 문서를 이해하지 못하는 경우
- 문서 이해를 지원하는 모델을 사용 중인지 확인합니다.
- 더 강력한 모델을 시도해 보세요(예: Claude Sonnet 4.5, GPT-5.1, Gemini Pro 3).
자주 묻는 질문
사용자가 한 메시지에 여러 문서를 업로드할 수 있나요?
예, 사용자는 단일 메시지에 여러 첨부 파일을 포함할 수 있으며 AI는 모두에 접근할 수 있습니다.
이것이 채팅뿐만 아니라 PM(개인 메시지)에서도 작동하나요?
예, 에이전트가 해당 상호작용 방식으로 구성되었只要在 경우, AI 봇과의 개인 메시지와 채팅 다이렉트 메시지 모두에서 첨부 파일 지원이 작동합니다.
에이전트의 RAG 업로드와 다른가요?
예. RAG 업로드는 관리자가 에이전트의 지식 베이스에 추가하는 문서로, 인덱싱 및 검색됩니다. 네이티브 첨부 파일 지원은 사용자가 대화 중에 문서를 업로드하여 인덱싱 없이 즉시 분석할 수 있게 합니다.
업로드된 문서는 어떻게 되나요?
문서는 사이트의 표준 업로드 처리 및 보존 정책에 따라 처리됩니다. 일반적인 Discourse 업로드로 저장됩니다.