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

<!-- wp:paragraph -->
<p>LLM을 활용하여 자연어에서 구조화된 매개변수를 추론하고 추출하여 후속 도구 호출이나 HTTP 요청에 사용합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>Dify 워크플로는 다양한 <a href="https://docs.dify.ai/en/tools">도구</a> 를 제공하며 , 대부분 구조화된 매개변수를 입력으로 필요로 합니다. 매개변수 추출기는 사용자 자연어를 이러한 도구에서 인식 가능한 매개변수로 변환하여 도구 호출을 용이하게 합니다.워크플로 내의 일부 노드는 특정 데이터 형식을 입력으로 필요로 합니다. 예를 들어, 반복 노드는 배열 형식을 필요로 합니다. 매개변수 추출기를 사용하면 구조화된 매개변수 변환을 편리하게 수행할 수 있습니다 .</p>
<!-- /wp:paragraph -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="2-scenarios"><a href="https://docs.dify.ai/en/guides/workflow/node/parameter-extractor#2-scenarios">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/parameter-extractor#2-scenarios"></a>2. 시나리오</h3>
<!-- /wp:heading -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li><strong>자연어에서 도구에 필요한 주요 매개변수를 추출하는 작업</strong>&nbsp;(예: 간단한 대화형 Arxiv 논문 검색 애플리케이션 구축)</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>이 예시에서는 Arxiv 논문 검색 도구가 <strong>논문 저자</strong> 또는 <strong>논문 ID를</strong> 입력 매개변수로 요구합니다. 매개변수 추출기는 “이 논문의 내용은 무엇입니까: 2405.10739″라는 쿼리에서 논문 ID <strong>2405.10739를</strong> 추출 하여 정밀한 쿼리를 위한 도구 매개변수로 사용합니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:list {"ordered":true,"start":2} -->
<ol start="2" class="wp-block-list"><!-- wp:list-item -->
<li><strong>긴 스토리 반복 생성 애플리케이션에서처럼 텍스트를 구조화된 데이터로 변환하는 것은 </strong>반복 노드 의 사전 단계 역할을 하며 , 텍스트 형식의 챕터 콘텐츠를 배열 형식으로 변환하고, 반복 노드에서 여러 라운드 생성 처리를 용이하게 합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

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

<!-- wp:list {"ordered":true,"start":3} -->
<ol start="3" class="wp-block-list"><!-- wp:list-item -->
<li><strong>구조화된 데이터를 추출하고 HTTP 요청을</strong> 사용하여 접근 가능한 모든 URL을 요청할 수 있으며, 외부 검색 결과, 웹훅, 이미지 생성 및 기타 시나리오를 얻는 데 적합합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="3-how-to-configure"><a href="https://docs.dify.ai/en/guides/workflow/node/parameter-extractor#3-how-to-configure">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/parameter-extractor#3-how-to-configure"></a>3. 구성 방법</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p><strong>구성 단계</strong></p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li>입력 변수를 선택합니다. 일반적으로 매개변수 추출을 위한 변수 입력입니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>LLM의 추론 및 구조화된 생성 기능에 의존하는 매개변수 추출기이므로 모델을 선택하세요.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>수동으로 추가하거나 기존 도구에서 빠르게 가져올</strong>&nbsp;수 있는 추출할 매개변수를 정의합니다&nbsp;.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>복잡한 매개변수를 추출할 때 효과성과 안정성을 개선하는 데 도움이 되는 예를 제공하는 지침을 작성합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- 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>함수 호출/도구 호출</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>프롬프트</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p><strong>메모리</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>메모리가 활성화되면 질문 분류기의 각 입력에 대화의 채팅 기록이 포함되어 LLM이 맥락을 이해하고 대화형 대화 중에 질문 이해력을 향상시키는 데 도움이 됩니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>추출된 정의된 변수</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>노드 내장 변수</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p><code>__is_success Number</code> : 추출 성공 상태, 성공 시 값은 1, 실패 시 값은 0입니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><code>__reason String</code> 추출 오류 이유</p>
<!-- /wp:paragraph -->