PDF 툴킷
PDF 툴킷은 에이전트에게 PDF 전용 도구를 제공합니다: 텍스트 추출, 페이지를 이미지로 변환, 일반 텍스트나 이미지로부터 PDF 생성. 연결이나 API 키가 필요 없습니다.
에이전드 Toolkits 탭에 추가한 다음, 에이전트가 PDF로 작업해야 할 때 성격 프롬프트에서 @로 도구를 참조하세요.
전제 조건
- 편집할 수 있는 에이전트
- 추출 또는 페이지 변환의 경우: 채팅 업로드의 PDF, 지식 베이스 파일, 공개 HTTPS URL, 또는 base64 PDF 데이터 URL
- 이미지→PDF의 경우: base64 데이터 URL 또는 HTTPS URL의 이미지 (JPEG, PNG, GIF, WebP)
사용 가능한 도구
| 도구 | 설명 |
|---|---|
| Extract Text | PDF의 모든 페이지에서 텍스트를 추출하고 페이지 수와 문자 수와 함께 결합된 텍스트를 반환합니다. |
| Convert to Image | PDF 페이지 하나를 PNG 이미지로 변환합니다. 페이지 번호(1 시작)와 선택적 DPI(기본값 200)를 설정합니다. |
| Text to PDF | 줄바꿈과 페이지 나눔이 있는 일반 텍스트로 PDF를 만듭니다. 선택적 파일명(기본값 output.pdf). |
| Image to PDF | 이미지를 이미지 크기에 맞춘 단일 페이지 PDF에 삽입합니다. 선택적 파일명(기본값 output.pdf). |
PDF 입력이 해석되는 방식
Extract Text와 Convert to Image에서 에이전트는 다음을 전달할 수 있습니다:
- 현재 대화의 채팅 첨부 파일명
- 현재 프로젝트의 지식 베이스 파일명 또는 경로
- PDF에 대한
https://URL - base64 데이터 URL (
data:application/pdf;base64,…)
여러 채팅 또는 KB 파일이 같은 이름을 공유하면 정확한 파일명이나 전체 KB 경로를 요청하세요.
Image to PDF는 base64 또는 HTTPS 이미지 URL만 허용합니다(채팅/KB 파일명 해석 불가).
사용 사례
- 대화 중 업로드된 정책 PDF에서 조항이나 목차 추출
- 표지나 다이어그램 페이지를 검토나 추가 분석을 위해 이미지로 변환
- 에이전트가 생성한 텍스트에서 짧은 PDF 요약 또는 영수증 생성
- 생성된 차트나 스크린샷을 다운로드용 한 페이지 PDF로 포장
팁
- 검색 가능한/텍스트 PDF에는 Extract Text를 선호하세요. 스캔된 이미지 전용 PDF는 텍스트가 거의 또는 전혀 없을 수 있습니다 — 그런 것은 지식 베이스 수집나 별도의 OCR을 사용하세요.
- Convert to Image는 호출당 페이지 하나를 처리합니다. 다중 페이지 출력에는 다음 페이지 번호로 반복하세요.
- 생성된 PDF와 이미지는 대화를 위한 데이터로 반환됩니다 — 자동으로 지식 베이스 문서로 저장되지 않습니다. 저장된 파일 워크플로우가 필요하면 Document Manager나 File Helpers를 사용하세요.
- 일반적인 파일 읽기/저장(DOCX, XLSX, CSV, 재인코딩)에는 대신 File Helpers를 사용하세요.
문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 비거나 빈약한 추출 텍스트 | PDF가 스캔/이미지 전용일 수 있음; 텍스트 기반 PDF나 OCR이 있는 KB 수집 시도 |
| 모호한 파일명 | 여러 채팅 또는 KB 일치 — 정확한 이름 또는 전체 경로 사용 |
| Convert to Image 실패 | 페이지 번호가 PDF 범위 내인지 확인; 페이지가 매우 크면 낮은 DPI 시도 |
| Image to PDF가 파일 거부 | base64 데이터 URL 또는 HTTPS 이미지 URL 사용 (채팅/KB 파일명만으로는 안 됨) |
| Document Manager와 혼동 | Document Manager는 채팅 내 마크다운 문서를 생성/편집; PDF 툴킷은 PDF 파일로 작업 |