<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="definition"><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#definition">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#definition"></a>정의</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>LLM은 문서 내용을 직접 읽거나 해석할 수 없습니다. 따라서 문서 추출 노드를 통해 사용자가 업로드한 문서의 정보를 구문 분석하고 읽어서 텍스트로 변환한 후, LLM에 전달하여 파일 내용을 처리해야 합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="application-scenarios"><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#application-scenarios">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#application-scenarios"></a>응용 프로그램 시나리오</h4>
<!-- /wp:heading -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>ChatPDF나 ChatWord와 같이 파일과 상호 작용할 수 있는 LLM 애플리케이션을 구축합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>사용자가 업로드한 파일의 내용을 분석하고 조사합니다.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="node-functionality"><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#node-functionality">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#node-functionality"></a>노드 기능</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>문서 추출 노드는 정보 처리 센터로 이해될 수 있습니다. 입력 변수의 파일을 인식하고 읽고, 정보를 추출하여 다운스트림 노드가 호출할 수 있도록 문자열 유형의 출력 변수로 변환합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":687,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-21-1024x489.png" alt="" class="wp-image-687"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>문서 추출기 노드 구조는 입력 변수와 출력 변수로 구분됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>입력 변수</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>문서 추출기는 다음과 같은 데이터 구조를 가진 변수만 허용합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><code>File</code>, 단일 파일</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><code>Array[File]</code>, 여러 파일</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>문서 추출기는 TXT, 마크다운, PDF, HTML, DOCX 형식 파일의 내용과 같은 문서 유형 파일에서만 정보를 추출할 수 있습니다. 이미지, 오디오, 비디오 또는 기타 파일 형식은 처리할 수 없습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>출력 변수</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>출력 변수는 고정되어 있으며 텍스트라는 이름이 지정됩니다. 출력 변수의 유형은 입력 변수에 따라 달라집니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>입력 변수가 이면 <code>File</code>출력 변수는 <code>string</code></li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>입력 변수가 이면 <code>Array[File]</code>출력 변수는 <code>array[string]</code></li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:quote -->
<blockquote class="wp-block-quote"><!-- wp:paragraph -->
<p>배열 변수는 일반적으로 목록 연산 노드와 함께 사용해야 합니다. </p>
<!-- /wp:paragraph --></blockquote>
<!-- /wp:quote -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="configuration-example"><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#configuration-example">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/doc-extractor#configuration-example"></a>구성 예</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>일반적인 파일 상호작용 Q&amp;A 시나리오에서 문서 추출기는 LLM 노드의 예비 단계 역할을 하여 애플리케이션에서 파일 정보를 추출하고 이를 다운스트림 LLM 노드로 전달하여 파일과 관련된 사용자 질문에 답할 수 있습니다.이 섹션에서는 일반적인 ChatPDF 예제 워크플로 템플릿을 통해 문서 추출 노드의 사용법을 소개합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":689,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-22-1024x489.png" alt="" class="wp-image-689"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p><strong>구성 프로세스:</strong></p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li>애플리케이션의 파일 업로드를 활성화합니다. “시작” 노드에 <strong>파일 변수 하나를</strong> 추가하고 이름을 pdf 로 지정합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>문서 추출기 노드를 추가하고 <code>pdf</code> 입력 변수에서 변수를 선택합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>LLM 노드를 추가하고 시스템 프롬프트에서 문서 추출기 노드의 출력 변수를 선택하세요. LLM은 이 출력 변수를 통해 파일의 내용을 읽을 수 있습니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:image {"id":690,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-23-1024x489.png" alt="" class="wp-image-690"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>끝 노드에서 LLM 노드의 출력 변수를 선택하여 끝 노드를 구성합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":691,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-24-1024x568.png" alt="" class="wp-image-691"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>구성 후, 애플리케이션에는 파일 업로드 기능이 추가되어 사용자가 PDF 파일을 업로드하고 대화에 참여할 수 있습니다.</p>
<!-- /wp:paragraph -->