Skip to main content
Flow 변수는 Flow 가 선언하는 이름 있는 입력. 블록이 {{name}} 으로 보간. 런타임 호출자가 값 설정 (API 페이로드, 채팅 UI, 스케줄 통해). 변수가 입력 선언할 한 곳과 보간할 한 곳 제공.

​
명령

변수 이름이 위치 인자, 예: topic, customer_email.

​
vars list

선언된 모든 변수 인쇄, 로우당 하나: 이름, 타입, 소스, 필수, 기본. 구조화 출력에 --json 추가.

​
vars set

​
플래그

넘긴 플래그만 기존 변수 업데이트 — set 은 shallow 병합이지 replace 가 아님. 필드 리셋은 변수 삭제·재생성.

​
소스 설명

  • form — 채팅 트리거의 폼 UI 에 표면화. 사용자가 채움.
  • body_path — 요청 본문의 JSON 경로에서 추출 (웹훅과 API 트리거). --path 로 지정.
  • fixed — 하드코딩. 매 실행 같은 값. 상수와 기능 플래그에 유용.

​
vars delete

선언 제거. {{customer_email}} 참조하는 블록이 런타임에 실패 — 먼저 감사.

​
흔한 레시피

​
필수 사용자 입력 선언

채팅 트리거 폼에 필수 필드로 표시.

​
웹훅 본문에서 추출

웹훅이 { "customer": { "email": "..." } } 를 POST 하면:
블록이 {{customer_email}} 보간하고 추출된 값 봄.

​
기능 플래그 스위치

준비되면 다른 vars set --fixed-value true 로 뒤집기. 블록 편집 없음, 재배포 없음 (설정 스코프 변경이 즉시 라이브).

​
벌크 스냅샷·복원

vars list --json 이 구조화되므로 vars 를 git 에 지속하고 다른 워크스페이스에 재적용 가능:
사소하지 않은 벌크 마이그레이션은 flows snapshot/apply 가 변수도 옮김.

​
변수가 나타나는 곳

  • 블록 콘텐츠 — 텍스트 필드가 {{name}} 보간 수용하는 어디든.
  • 트리거 입력 — 웹훅 input_path 가 변수로 매핑; API 트리거가 수용.
  • 채팅 폼 UI — --source form 변수가 실행 시작에 필드로 렌더.
  • 스케줄 트리거 — --source fixed 값이 모든 스케줄 실행에 baked in.

​
변수와 버전 스코프

변수가 Flow 에 속함 (draft + published 함께). 변수 이름 변경은 Draft 편집 — 라이브 되려면 배포. --fixed-value 변경은 재배포 없이 즉시 효과.