Docling 사용법: AI Flowi Workflow의 문서 처리·청킹·내보내기
Docling 사용법에서는 네 가지 문서 작업을 다룹니다. 로컬 처리, Docling Serve 연결, 문서 청킹, 형식 내보내기입니다. 처리 환경에서 모델을 로컬로 실행하려면 Docling을, 본인의 서버 인스턴스에 연결하려면 Docling Serve를 선택합니다. 청킹이나 내보내기를 설정하기 전에 문서 데이터를 점검합니다.
이 인터페이스들은 카탈로그에 문서화되어 있으며, Ai Flowi가 프로덕션 환경에서 테스트하지 않았습니다. 아래 참고 자료는 2026년 10월 9일에 내보낸 AI Flowi Workflow 1.9.2 카탈로그를 사용합니다.
Docling 참고 자료 작성: Ai Flowi · 게시일:
공식 출처: Docling 문서
네 가지 작업과 서로 다른 출력 규약
전체 구성 요소 카탈로그에서 범주 목록을 확인할 수 있습니다. 이 페이지에서는 Docling 설정과 처리·청킹·내보내기 사이의 경계를 추가로 설명합니다. 지정한 필드의 값을 추출하고 근거를 검토하는 방법은 Document AI 가이드를 참고합니다.
| 구성 요소 / 키 | 작업 | 필수 입력 | 출력 표시 이름 / 포트 / 유형 |
|---|---|---|---|
DoclingDoclingInline | 로컬 모델로 문서를 처리합니다. | 필수 표시 없음. | Files / dataframe / Table |
Docling ServeDoclingRemote | 본인의 Docling Serve 인스턴스에 연결합니다. | api_url | Files / dataframe / Table |
Chunk DoclingDocumentChunkDoclingDocument | 문서 데이터를 청크로 나눕니다. | data_inputs | Table / dataframe / Table |
Export DoclingDocumentExportDoclingDocument | 문서를 특정 형식으로 내보냅니다. | data_inputs | Exported data / data / JSON; Table / dataframe / Table |
Files는 표시 이름이며 다운로드 가능한 파일 유형이 아닙니다. 두 처리 포트 모두 Table을 선언합니다. 이 스냅샷의 어느 처리 항목에도 열 정의, 문서 객체의 위치, 응답 예시는 없습니다. 호환되는 Table 연결은 유형이 일치함을 나타낼 뿐, 문서 조회 성공을 입증하지 않습니다.
Docling: 로컬 OCR 및 파이프라인 제어
설명에는 Docling 모델이 로컬에서 실행된다고 명시되어 있습니다. 그 환경이 사용자의 브라우저나 노트북이라고 지정하지 않으며, 설치된 OCR 엔진이나 하드웨어의 처리 능력도 문서화하지 않습니다. path로 파일을 선택하거나 file_path가 받는 Data, JSON, Message 연결을 점검합니다. 파일 관리 참고 자료에서 선택 도구를 설명하므로 여기서는 업로드 지침을 반복하지 않습니다.
| 입력 | 값 유형 / 필수 여부 | 연결 메타데이터 | 문서 작업 참고 사항 |
|---|---|---|---|
delete_server_file_after_processing | bool / 선택 | 미지정 | 삭제 범위와 기본값은 미지정입니다. |
do_picture_classification | bool / 선택 | 미지정 | 이미지 분류 스위치이며 결과 스키마는 제공되지 않습니다. |
file_path | other / 선택 | Data, JSON, Message | 경로 페이로드 구조는 내보낸 자료에 없습니다. |
ignore_unspecified_files | bool / 선택 | 미지정 | 파일 선택 동작을 점검해야 합니다. |
ignore_unsupported_extensions | bool / 선택 | 미지정 | 이 스위치에는 지원 확장자 목록이 없습니다. |
ocr_engine | str / 선택 | 미지정 | "None", "easyocr", "tesserocr", "rapidocr", "ocrmac". 이 메뉴에 OCR 엔진 이름이 있다고 해서 설치가 확인되는 것은 아닙니다. |
path | file / 선택 | 미지정 | 파일 선택 도구 입력이며 내보낸 연결 유형은 없습니다. |
pic_desc_llm | other / 선택 | LanguageModel | LanguageModel 연결을 받습니다. |
pic_desc_prompt | str / 선택 | 미지정 | 이미지 설명 프롬프트이며 기본값은 미지정입니다. |
pipeline | str / 선택 | 미지정 | "standard", "vlm". 선택만으로 모델의 준비 상태를 확인할 수는 없습니다. |
separator | str / 선택 | 미지정 | 경로 구분자 동작은 문서화되어 있지 않습니다. |
silent_errors | bool / 선택 | 미지정 | 오류 처리와 기본값은 설명되어 있지 않습니다. |
OCR 선택과 파이프라인 선택을 구분합니다. 다섯 OCR 선택지와 두 파이프라인 선택지는 각각 나열되어 있으며, 스냅샷에는 호환성 표가 없습니다. 이미지 분류, 연결된 이미지 설명 모델, 해당 프롬프트도 별도의 제어 항목입니다. 이미지 제어에는 두 가지 미확인 사항이 남아 있습니다. 캡션이 자동으로 생성되는지, 생성된다면 처리 Table의 어디에 들어가는지입니다.
Docling Serve: 엔드포인트, 헤더, 폴링
원격 처리에는 api_url과 본인의 Docling Serve 인스턴스 접근 권한이 필요합니다. 해당 인스턴스의 인증 요건에 맞게 api_headers를 제공합니다. 카탈로그에는 헤더 이름이나 인증 방법이 없습니다. 워크플로우 실행 환경에서 엔드포인트에 접근할 수 있는지 확인해야 합니다.
| 입력 | 값 유형 / 필수 여부 | 연결 메타데이터 | 문서 작업 참고 사항 |
|---|---|---|---|
api_headers | NestedDict / 선택 | Message | 헤더 이름과 자격 증명 형식은 나열되어 있지 않습니다. |
api_url | str / 필수 | 미지정 | 필수 엔드포인트이며 기본 URL은 기록되어 있지 않습니다. |
delete_server_file_after_processing | bool / 선택 | 미지정 | 활성화하기 전에 원본 보존을 확인합니다. |
docling_serve_opts | NestedDict / 선택 | Message | 서버 옵션 키는 나열되어 있지 않습니다. |
file_path | other / 선택 | Data, JSON, Message | 연결하기 전에 경로 표현을 점검합니다. |
ignore_unspecified_files | bool / 선택 | 미지정 | path보다 우선하는지는 명시되어 있지 않습니다. |
ignore_unsupported_extensions | bool / 선택 | 미지정 | 건너뛰기 규칙은 정의되어 있지 않습니다. |
max_concurrency | int / 선택 | Message | 범위, 기본값, 처리량 수치는 제공되지 않습니다. |
max_poll_timeout | float / 선택 | Message | 단위, 기본값, 취소 규칙은 제공되지 않습니다. |
path | file / 선택 | 미지정 | 이 처리 노드의 파일 선택 항목입니다. |
separator | str / 선택 | 미지정 | 다중 경로 구문은 제공되지 않습니다. |
silent_errors | bool / 선택 | 미지정 | 내보낸 오류 출력 규약은 없습니다. |
max_concurrency와 max_poll_timeout은 설정 필드이며 성능 근거가 아닙니다. 몇 개의 문서가 동시에 완료되는지, 시간 초과가 원격 작업을 취소하는지 추론하지 않습니다. 엔드포인트가 받는 옵션 키를 확인할 때까지 서버 옵션을 최소화합니다. 공통 자격 증명 관리 방식은 연결 가이드를 참고합니다.
Chunk DoclingDocument: 문서 키를 추적합니다
청킹에는 data_inputs가 필수이며 Data, JSON, DataFrame 또는 Table을 받습니다. 선택 필드인 doc_key는 조회 설정이지만, 내보낸 자료에는 기본값이나 중첩 문서 값을 탐색하는 규칙이 없습니다. 이 설정을 선택하기 전에 처리 결과를 점검해 문서 값의 위치를 확인합니다.
| 입력 | 값 유형 / 필수 여부 | 연결 메타데이터 | 문서 작업 참고 사항 |
|---|---|---|---|
always_emit_headings | bool / 선택 | 미지정 | 제목 포함 방식의 세부 정보는 없습니다. |
chunker | str / 선택 | Message | "HybridChunker", "HierarchicalChunker". 알고리즘 비교는 제공되지 않습니다. |
data_inputs | other / 필수 | Data, JSON, DataFrame, Table | 문서를 포함하는 필수 입력입니다. |
doc_key | str / 선택 | Message | 문서 조회 규칙은 미지정입니다. |
hf_model_name | str / 선택 | 미지정 | 모델 이름 기본값이나 접근 요건은 제공되지 않습니다. |
max_tokens | int / 선택 | Message | 지원 범위나 토큰 계산 방식은 제공되지 않습니다. |
merge_peers | bool / 선택 | 미지정 | 병합 동작은 설명되어 있지 않습니다. |
openai_model_name | str / 선택 | 미지정 | 모델 식별자나 자격 증명 필드는 제공되지 않습니다. |
provider | str / 선택 | 미지정 | "Hugging Face", "OpenAI". 제공업체가 나열되어 있다고 해서 접근 설정이 완료된 것은 아닙니다. |
추정한 기본값을 복사하지 말고 청커와 제공업체를 명확히 선택합니다. 제공업체를 선택할 때 해당 모델 이름 필드를 확인합니다. 이 설정만으로 임베딩, 검색, 답변 생성 단계가 구성되지는 않습니다. 선언된 유일한 출력은 청킹 결과를 담은 Table입니다.
Export DoclingDocument: 형식 및 이미지 처리
내보내기에는 별도의 필수 data_inputs와 선택 doc_key가 있습니다. 청킹 분기와 별개로 이 노드에 전달되는 문서 값을 추적합니다. 두 노드가 모두 Table을 받는다는 이유로 청크 자체에 내보내기 가능한 문서 객체가 남아 있다고 가정하지 않습니다.
| 입력 | 값 유형 / 필수 여부 | 연결 메타데이터 | 문서 작업 참고 사항 |
|---|---|---|---|
data_inputs | other / 필수 | Data, JSON, DataFrame, Table | 내보낼 문서를 포함하는 필수 입력입니다. |
doc_key | str / 선택 | Message | 실제 문서 위치와 대조하여 확인합니다. |
export_format | str / 선택 | 미지정 | "Markdown", "HTML", "Plaintext", "DocTags". 내보낸 자료에 있는 형식 선택지입니다. |
image_mode | str / 선택 | 미지정 | "placeholder", "embedded". 파일 패키징 규약은 기록되어 있지 않습니다. |
md_image_placeholder | str / 선택 | 미지정 | Markdown 이미지 자리표시자 설정입니다. |
md_page_break_placeholder | str / 선택 | 미지정 | Markdown 페이지 나눔 자리표시자 설정입니다. |
검색 가능한 PDF나 DOCX 내보내기는 나열되어 있지 않습니다. JSON 및 Table 출력 포트는 워크플로우 값을 설명하며, 파일 이름과 MIME 유형이 있는 다운로드 첨부 파일을 보장하지 않습니다. 내보낸 내용을 공유하기 전에 선택한 형식의 이미지 자리표시자나 삽입된 콘텐츠를 점검합니다.
통제된 환경에서 문서를 처리하고 내보내는 예시
예시 설정이며, 기록된 테스트가 아닙니다
사용이 허용된 샘플 문서와 접근 가능한 처리 환경이 필요합니다. Serve를 사용한다면 본인의 인스턴스와 필요한 자격 증명을 준비합니다. 외부 모델을 선택할 때는 본인의 제공업체 계정에서 API 키를 포함한 자격 증명을 준비해야 하며, 사용료도 별도로 청구됩니다. 모델 이름을 권한으로 취급하지 말고 자격 증명 참고 자료를 따릅니다.
- Docling에서
path로 샘플 하나를 선택하고,pipeline을"standard"로 설정합니다. 점검을 위해silent_errors와delete_server_file_after_processing를 명시적으로 false로 설정합니다. - Files 출력을 점검합니다. 문서 값을 찾아 실제 키를 기록합니다. 결과에 사용 가능한 문서가 없다면 여기에서 중단합니다.
doc_key를 임의로 만들어 넣지 않습니다. - 해당 Table을 Export DoclingDocument의
data_inputs에 연결합니다. 관찰한 결과에 따라doc_key를 설정하고,export_format="Markdown",image_mode="placeholder"를 선택합니다. - Exported data와 Table을 각각 점검합니다.
md_image_placeholder나md_page_break_placeholder를 설정했다면, 수신 구성 요소에 사용할 출력을 선택하기 전에 Markdown 형식의 출력에서 해당 표시를 확인합니다. - 별도의 청킹 분기를 구성하려면 문서가 포함된 Table을 점검한 뒤 Chunk DoclingDocument에 연결하고, 확인한
doc_key를 설정한 뒤"HierarchicalChunker"를 선택합니다. 추가 제어 항목을 선택하기 전에 반환된 청크를 점검합니다.
Docling의 제한 사항은 무엇이며, 다른 접근이 적합한 경우는 언제인가요?
이 범주에는 파일 크기 상한, OCR 설치, 원격 재시도 정책, 삭제 보장이 문서화되어 있지 않습니다. 결과를 조사하는 동안 원본 삭제를 비활성화하고, 점검 환경 밖에 원본을 보존합니다. 오류 억제는 복구 분기가 아닙니다. 무인 처리에 의존하기 전에 실패했을 때의 실제 동작을 점검합니다.
원본에 필요한 텍스트가 이미 있다면 더 간단한 텍스트 처리 경로를 사용합니다. 필드 추출에는 Document AI 가이드를, 더 폭넓은 워크플로우 설계에는 활용 사례 라이브러리를 선택합니다. 이 참고 자료는 인터페이스를 설명하며, 문서 충실도나 완전한 검색 파이프라인을 인증하지 않습니다.
사용량 및 관련 참고 자료
요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.
업로드한 문서당 한 번 요금이 발생한다고 가정하지 말고 실행된 노드를 검토합니다. 처리, 청킹, 내보내기는 별도 노드이며 반복 실행하면 실행 횟수가 늘어납니다. 연동 허브를 살펴보거나 다른 문서 처리 인터페이스인 Unstructured API 규약과 비교합니다.