워크플로우 와 챗플로우 애플리케이션은 독립적인 노드들로 구성됩니다. 대부분의 노드에는 입력 및 출력 항목이 있지만, 각 노드의 입력 및 출력 정보는 일관되지 않고 동적이지 않습니다.고정된 기호를 사용하여 동적으로 변경되는 콘텐츠를 참조하는 방법은 무엇일까요? 변수는 동적 데이터 컨테이너로서 고정되지 않은 콘텐츠를 저장하고 전송할 수 있으며, 서로 다른 노드 내에서 상호 참조되어 노드 간에 유연한 정보 이동성을 제공합니다.
변수 유형 #
시스템 변수 #
시스템 변수는 Chatflow/Workflow 앱 내에서 다른 노드가 전역적으로 읽을 수 있는 미리 설정된 시스템 수준 매개변수를 나타냅니다. 모든 시스템 수준 변수는 다음으로 시작합니다.sys.워크플로워크플로 유형 애플리케이션은 아래의 시스템 변수를 제공합니다.
| 변수 이름 | 데이터 유형 | 설명 | 주목 |
|---|---|---|---|
sys.files[LEGACY] | 배열[파일] | 파일 매개변수: 사용자가 업로드한 이미지를 저장합니다. | 애플리케이션 오케스트레이션 페이지의 오른쪽 상단에 있는 ‘기능’ 섹션에서 이미지 업로드 기능을 활성화해야 합니다. |
sys.user_id | 끈 | 사용자 ID: 워크플로 애플리케이션을 사용할 때 시스템이 각 사용자에게 자동으로 할당하는 고유 식별자입니다. 여러 사용자를 구별하는 데 사용됩니다. | |
sys.app_id | 끈 | 앱 ID: 시스템이 각 앱에 자동으로 할당하는 고유 식별자입니다. 이 매개변수는 현재 앱의 기본 정보를 기록하는 데 사용됩니다. | 이 매개변수는 개발 기능이 있는 사용자를 위해 고유한 Workflow 애플리케이션을 구별하고 찾는 데 사용됩니다. |
sys.workflow_id | 끈 | 워크플로 ID: 이 매개변수는 현재 워크플로 애플리케이션의 모든 노드 정보에 대한 정보를 기록합니다. | 이 매개변수는 개발 기능이 있는 사용자가 워크플로 내에 포함된 노드에 대한 정보를 추적하고 기록하는 데 사용할 수 있습니다. |
sys.workflow_run_id | 끈 | 워크플로 실행 ID: 워크플로 애플리케이션의 런타임 상태 및 실행 로그를 기록하는 데 사용됩니다. | 이 매개변수는 개발 기능이 있는 사용자가 애플리케이션의 과거 실행 기록을 추적하는 데 사용할 수 있습니다. |
챗플로우Chatflow 유형 애플리케이션은 다음과 같은 시스템 변수를 제공합니다.
| 변수 이름 | 데이터 유형 | 설명 | 주목 |
|---|---|---|---|
sys.query | 끈 | 사용자가 채팅창에 입력한 내용입니다. | |
sys.files | 배열[파일] | 파일 매개변수: 사용자가 업로드한 이미지를 저장합니다. | 애플리케이션 오케스트레이션 페이지의 오른쪽 상단에 있는 ‘기능’ 섹션에서 이미지 업로드 기능을 활성화해야 합니다. |
sys.dialogue_count | 숫자 | 사용자가 Chatflow 애플리케이션과 상호작용하는 동안 발생하는 대화 턴 수입니다. 이 수는 각 채팅 라운드가 끝날 때마다 자동으로 하나씩 증가하며, if-else 노드와 결합하여 풍부한 분기 논리를 생성할 수 있습니다. 예를 들어, LLM은 X번째 대화 턴에서 대화 내역을 검토하고 자동으로 분석을 제공합니다. | |
sys.conversation_id | 끈 | 채팅 상자 상호작용 세션에 대한 고유 ID를 사용하여 모든 관련 메시지를 동일한 대화로 그룹화하고, LLM이 동일한 주제와 맥락에서 채팅을 계속할 수 있도록 보장합니다. | |
sys.user_id | 끈 | 각 애플리케이션 사용자에게 고유 ID가 할당되어 대화 사용자를 구분합니다. 참고 : 서비스 API는 웹앱에서 생성된 대화를 공유하지 않습니다. 즉, 동일한 ID를 가진 사용자는 API 인터페이스와 웹앱 인터페이스 간에 별도의 대화 기록을 갖게 됩니다. | |
sys.workflow_id | 끈 | 워크플로 ID: 이 매개변수는 현재 워크플로 애플리케이션의 모든 노드 정보에 대한 정보를 기록합니다. | 이 매개변수는 개발 기능이 있는 사용자가 워크플로 내에 포함된 노드에 대한 정보를 추적하고 기록하는 데 사용할 수 있습니다. |
sys.workflow_run_id | 끈 | 워크플로 실행 ID: 워크플로 애플리케이션의 런타임 상태 및 실행 로그를 기록하는 데 사용됩니다. | 이 매개변수는 개발 기능이 있는 사용자가 애플리케이션의 과거 실행 기록을 추적하는 데 사용할 수 있습니다. |
환경 변수 #
환경 변수는 워크플로 실행 시 사용되는 API 키 및 데이터베이스 비밀번호와 같이 워크플로와 관련된 민감한 정보를 보호하는 데 사용됩니다 . 이러한 정보는 코드가 아닌 워크플로에 저장되므로 여러 환경에서 공유될 수 있습니다.
다음 3가지 데이터 유형을 지원합니다.
- 문자
- 숫자
- 비밀번호
환경 변수는 다음과 같은 특징을 가지고 있습니다.
- 환경 변수는 대부분의 노드 내에서 전역적으로 참조될 수 있습니다.
- 환경 변수 이름은 중복될 수 없습니다.
- 노드의 출력 변수는 일반적으로 읽기 전용이며 쓰기가 불가능합니다.
대화 변수 #
대화 변수는 Chatflow 앱 에만 적용됩니다 .
대화 변수를 사용하면 애플리케이션 개발자가 동일한 Chatflow 세션 내에 임시로 저장해야 하는 특정 정보를 지정할 수 있으며, 이를 통해 현재 Chatflow 내에서 여러 차례의 채팅에서 이 정보를 참조할 수 있습니다 . 여기에는 컨텍스트, 채팅 상자에 업로드된 파일(곧 제공 예정), 대화 중 사용자 환경 설정 입력 등이 포함될 수 있습니다. 이는 LLM에 언제든지 확인할 수 있는 “메모”를 제공하는 것과 같으며, LLM 메모리 오류로 인한 정보 편향을 방지합니다.예를 들어, 첫 번째 채팅에서 사용자가 입력한 언어 선호도를 대화 변수에 저장할 수 있습니다. LLM은 사용자에게 답변할 때 대화 변수의 정보를 참조하고, 이후 채팅에서 지정된 언어를 사용하여 사용자에게 답변합니다.
대화 변수는 다음의 6가지 데이터 유형을 지원합니다.
- 문자
- 숫자
- 물체
- 배열[문자열]
- 배열[숫자]
- 배열[객체]
대화 변수는 다음과 같은 특징을 가지고 있습니다.
- 대화 변수는 동일한 Chatflow 앱의 대부분 노드에서 전역적으로 참조될 수 있습니다.
- 대화 변수에 쓰려면 변수 할당자 노드를 사용해야 합니다 .
- 대화 변수는 읽기-쓰기 변수입니다.
대화 변수를 변수 할당자 노드와 함께 사용하는 방법에 대해서는 변수 할당자를 참조하세요 .애플리케이션을 디버깅하는 동안 대화 변수 값의 변경 사항을 추적하려면 Chatflow 애플리케이션 미리 보기 페이지 상단에 있는 대화 변수 아이콘을 클릭하세요.
주의 #
- 변수 이름 중복을 방지하려면 노드 이름을 반복해서는 안 됩니다.
- 노드의 출력 변수는 일반적으로 고정 변수이며 편집할 수 없습니다.
