<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="definition">정의</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p><strong>"시작"</strong>&nbsp;노드 는 Chatflow/Workflow 애플리케이션의 중요한 사전 설정 노드입니다. 사용자 입력 및&nbsp;<a href="https://docs.dify.ai/en/guides/workflow/file-upload">업로드된 파일</a>&nbsp;과 같은 필수적인 초기 정보를 제공하여&nbsp;애플리케이션 및 후속 워크플로 노드의 정상적인 흐름을 지원합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="configuring-the-node"><a href="https://docs.dify.ai/en/guides/workflow/node/start#configuring-the-node">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/start#configuring-the-node"></a>노드 구성</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p><strong>시작 노드의 설정 페이지에는 "입력 필드"</strong> 와 사전 설정 <strong>시스템 변수라는</strong> 두 섹션이 있습니다 .</p>
<!-- /wp:paragraph -->

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

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="input-field"><a href="https://docs.dify.ai/en/guides/workflow/node/start#input-field">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/start#input-field"></a>입력 필드</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>입력 필드는 사용자에게 추가 정보를 입력하라는 메시지를 표시하기 위해 애플리케이션 개발자가 구성합니다.예를 들어, 주간 보고서 애플리케이션에서 사용자는 이름, 근무 기간, 근무 세부 정보와 같은 배경 정보를 특정 형식으로 제공해야 할 수 있습니다. 이러한 예비 정보는 LLM이 더 높은 품질의 답변을 생성하는 데 도움이 됩니다.6가지 유형의 입력 변수가 지원되며, 모두 필요에 따라 설정할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>텍스트:</strong>&nbsp;사용자가 입력하는 짧은 텍스트로, 최대 길이는 256자입니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>문단:</strong>&nbsp;긴 텍스트로, 사용자가 더 긴 내용을 입력할 수 있습니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>선택:</strong>&nbsp;개발자가 설정한 고정 옵션입니다. 사용자는 사전 설정된 옵션에서만 선택할 수 있으며 사용자 정의 콘텐츠를 입력할 수 없습니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>숫자:</strong>&nbsp;숫자 입력만 허용합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>단일 파일:</strong>&nbsp;사용자가 단일 파일을 업로드할 수 있습니다. 문서 유형, 이미지, 오디오, 비디오 및 기타 파일 유형을 지원합니다. 사용자는 로컬로 업로드하거나 파일 URL을 붙여넣을 수 있습니다. 자세한 사용 방법은 파일 업로드를 참조하세요.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>파일 목록:</strong>&nbsp;사용자가 파일을 일괄 업로드할 수 있습니다. 문서 유형, 이미지, 오디오, 비디오 및 기타 파일 유형을 지원합니다. 사용자는 로컬로 업로드하거나 파일 URL을 붙여넣을 수 있습니다. 자세한 사용법은 <a href="https://rndpolicy.org/future/docs/%ed%8c%8c%ec%9d%bc-%ec%97%85%eb%a1%9c%eb%93%9c/" data-type="docs" data-id="2048">파일 업로드</a>를 참조하세요.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>Dify에 내장된 문서 추출 노드는 특정 문서 형식만 처리할 수 있습니다. 이미지, 오디오 또는 비디오 파일을 처리하려면 외부 데이터 도구를 참조하여 해당 파일 처리 노드를 설정하세요.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>설정이 완료되면 사용자는 애플리케이션 사용 전에 LLM에 필요한 정보를 제공하도록 안내됩니다. 더 많은 정보를 제공할수록 LLM의 질의응답 효율성이 향상됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="system-variables"><a href="https://docs.dify.ai/en/guides/workflow/node/start#system-variables">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/start#system-variables"></a>시스템 변수</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>시스템 변수는 Chatflow/Workflow 애플리케이션에서 미리 설정된 시스템 수준 매개변수로, 애플리케이션의 다른 노드에서 전역적으로 접근할 수 있습니다. 시스템 변수는 일반적으로 다중 턴 대화 애플리케이션 구축, 애플리케이션 로그 수집 및 데이터 모니터링, 다양한 애플리케이션 및 사용자 간의 사용 행동 기록과 같은 고급 개발 시나리오에서 사용됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>Workflow</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>워크플로 애플리케이션은 다음과 같은 시스템 변수를 제공합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:table -->
<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>변수 이름</th><th>데이터 유형</th><th>설명</th><th>노트</th></tr></thead><tbody><tr><td><code>sys.files</code><br>[지난 기능]</td><td>배열[파일]</td><td>파일 매개변수는 사용자가 애플리케이션을 처음 사용할 때 업로드한 이미지를 저장합니다.</td><td>애플리케이션 오케스트레이션 페이지 오른쪽 상단의 "기능" 섹션에서 이미지 업로드 기능을 활성화해야 합니다.</td></tr><tr><td><code>sys.user_id</code></td><td>문자열</td><td>사용자 ID는 워크플로 애플리케이션을 사용할 때 각 사용자에게 자동으로 할당되는 고유 식별자로, 서로 다른 대화 사용자를 구별하는 데 사용됩니다.</td><td></td></tr><tr><td><code>sys.app_id</code></td><td>문자열</td><td>애플리케이션 ID는 시스템에서 각 Workflow 애플리케이션에 할당한 고유 식별자로, 다양한 애플리케이션을 구별하고 현재 애플리케이션의 기본 정보를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 다양한 Workflow 애플리케이션을 구별하고 찾을 수 있습니다.</td></tr><tr><td><code>sys.workflow_id</code></td><td>문자열</td><td>Workflow ID는 현재 Workflow 애플리케이션에 포함된 모든 노드 정보를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 워크플로 내에서 노드 정보를 추적하고 기록할 수 있습니다.</td></tr><tr><td><code>sys.workflow_run_id</code></td><td>문자열</td><td>Workflow 애플리케이션 실행 ID는 Workflow 애플리케이션의 실행 상태를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 애플리케이션의 실행 기록을 추적할 수 있습니다.</td></tr></tbody></table></figure>
<!-- /wp:table -->

<!-- wp:paragraph -->
<p><strong>챗플로우</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>Chatflow 애플리케이션은 다음과 같은 시스템 변수를 제공합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:table -->
<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>변수 이름</th><th>데이터 유형</th><th>설명</th><th>노트</th></tr></thead><tbody><tr><td><code>sys.query</code></td><td>문자열</td><td>사용자가 대화 상자에 입력한 초기 내용</td><td></td></tr><tr><td><code>sys.files</code></td><td>배열[파일]</td><td>사용자가 대화 상자에 업로드한 이미지</td><td>애플리케이션 오케스트레이션 페이지 오른쪽 상단의 "기능" 섹션에서 이미지 업로드 기능을 활성화해야 합니다.</td></tr><tr><td><code>sys.dialogue_count</code></td><td>숫자</td><td>Chatflow 애플리케이션과 사용자 상호작용 중 대화 턴 수입니다. 각 턴마다 자동으로 1씩 증가합니다. if-else 노드와 함께 사용하여 풍부한 분기 논리를 생성할 수 있습니다. 예를 들어, 대화의 X번째 턴에서 대화 기록을 검토하고 분석을 제공합니다.</td><td></td></tr><tr><td><code>sys.conversation_id</code></td><td>문자열</td><td>대화 상호작용 세션에 대한 고유 식별자로, 모든 관련 메시지를 동일한 대화로 그룹화하여 LLM이 동일한 주제와 맥락에서 대화를 계속할 수 있도록 보장합니다.</td><td></td></tr><tr><td><code>sys.user_id</code></td><td>문자열</td><td>각 애플리케이션 사용자에게 할당된 고유 식별자로, 다양한 대화 사용자를 구별하는 데 사용됩니다.</td><td></td></tr><tr><td><code>sys.app_id</code></td><td>문자열</td><td>애플리케이션 ID는 시스템에서 각 Workflow 애플리케이션에 할당한 고유 식별자로, 다양한 애플리케이션을 구별하고 현재 애플리케이션의 기본 정보를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 다양한 Workflow 애플리케이션을 구별하고 찾을 수 있습니다.</td></tr><tr><td><code>sys.workflow_id</code></td><td>문자열</td><td>Workflow ID는 현재 Workflow 애플리케이션에 포함된 모든 노드 정보를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 워크플로 내에서 노드 정보를 추적하고 기록할 수 있습니다.</td></tr><tr><td><code>sys.workflow_run_id</code></td><td>문자열</td><td>Workflow 애플리케이션 실행 ID는 Workflow 애플리케이션의 실행 상태를 기록하는 데 사용됩니다.</td><td>개발 기능이 있는 사용자의 경우 이 매개변수를 사용하여 애플리케이션의 실행 기록을 추적할 수 있습니다.</td></tr></tbody></table></figure>
<!-- /wp:table -->

<!-- wp:paragraph -->
<p></p>
<!-- /wp:paragraph -->