nora vars

Flow 변수는 Flow가 선언하는, 이름 있는 입력입니다. 블록이 {{name}}으로 보간합니다. 런타임 호출자가 값을 정합니다(API 페이로드, 스케줄 입력으로). 변수는 입력을 선언할 한 곳과 보간할 한 곳을 줍니다.

명령

명령	설명
`vars list`	활성 Flow의 선언된 변수 나열.
`vars set <name> [flags]`	변수 추가 또는 업데이트(기존에 shallow 병합).
`vars delete <name>`	변수 제거.

변수 이름이 위치 인자입니다. 예를 들어 topic, customer_email입니다.

`vars list`

nora vars list

선언된 모든 변수를 한 줄에 하나씩 출력합니다. 이름, 타입, 소스, 필수, 기본입니다. 구조화 출력은 --json을 붙입니다.

`vars set`

nora vars set customer_email --source form --type string --required

플래그

플래그	값	목적
`--source`	`form`, `body_path`, `fixed`	런타임에 값이 오는 곳.
`--type`	`string`, `number`, `boolean`, `object`, `array`	타입 강제 + 검증.
`--label <text>`		사람용 라벨(채팅 폼).
`--description <text>`		한 줄 힌트.
`--path <a.b.c>`		`body_path` 소스: 트리거 본문의 JSONPath.
`--fixed-value <v>`		`fixed` 소스: 하드코딩 값.
`--default-value <json>`		없을 때 기본. JSON 리터럴.
`--required`		안 정하면 실행 실패.

넘긴 플래그만 기존 변수에 업데이트됩니다. set은 shallow 병합이지 replace가 아닙니다. 필드를 초기화하려면 변수를 지우고 다시 만듭니다.

소스 설명

form 실행 전 입력 폼에 뜹니다. 사용자가 채웁니다
body_path 요청 본문의 JSON 경로에서 뽑습니다(웹훅과 API 트리거). --path로 지정합니다
fixed 하드코딩입니다. 실행마다 같은 값입니다. 상수와 기능 플래그에 좋습니다

`vars delete`

nora vars delete customer_email

선언을 제거합니다. {{customer_email}}을 참조하는 블록은 런타임에 실패합니다. 먼저 감사하세요.

흔한 레시피

필수 사용자 입력 선언

nora vars set topic \
  --source form \
  --type string \
  --label "What topic?" \
  --description "한 단어 주제 (예: 'billing')" \
  --required

입력 폼에 필수 필드로 뜹니다.

웹훅 본문에서 뽑기

웹훅이 { "customer": { "email": "..." } }를 POST 하면:

nora vars set customer_email \
  --source body_path \
  --path customer.email \
  --type string \
  --required

블록이 {{customer_email}}을 보간하면 뽑은 값을 봅니다.

기능 플래그 스위치

nora vars set enable_experimental_prompt \
  --source fixed \
  --type boolean \
  --fixed-value false \
  --description "assistant 프롬프트의 variant B를 켜는 토글"

준비되면 vars set --fixed-value true로 뒤집습니다. 블록 편집도, 재배포도 없습니다(설정 스코프 변경이 바로 라이브입니다).

한꺼번에 스냅샷·복원

vars list --json이 구조화돼 있어, vars를 git에 남기고 다른 워크스페이스에 다시 적용할 수 있습니다:

# 내보내기
nora vars list --json > vars.json

# 다른 워크스페이스에 다시 적용 (하나씩 루프)
jq -c '.[]' vars.json | while read v; do
  name=$(echo "$v" | jq -r '.name')
  # 구조화 필드를 --set-* 플래그로 다시 옮김
  # (한꺼번에는 보통 API로 스크립트 짜는 편이 쉬움)
done

간단치 않은 대량 이전은 flows snapshot/apply가 변수도 함께 옮깁니다.

변수가 나타나는 곳

블록 콘텐츠 텍스트 필드가 {{name}} 보간을 받는 어디든
트리거 입력 웹훅 input_path가 변수로 매핑됩니다. API 트리거가 받습니다
채팅 폼 UI --source form 변수가 실행 시작에 필드로 그려집니다
스케줄 트리거 --source fixed 값이 모든 스케줄 실행에 박힙니다

변수와 버전 스코프

변수는 Flow에 속합니다(draft + published 함께). 변수 이름 변경은 Draft 편집입니다. 라이브로 하려면 배포합니다. --fixed-value 변경은 재배포 없이 바로 적용됩니다.

CLI

SDK

Local App

명령

`vars list`

`vars set`

플래그

소스 설명

`vars delete`

흔한 레시피

필수 사용자 입력 선언

웹훅 본문에서 뽑기

기능 플래그 스위치

한꺼번에 스냅샷·복원

변수가 나타나는 곳

변수와 버전 스코프

​명령

​vars list

​vars set

​플래그

​소스 설명

​vars delete

​흔한 레시피

​필수 사용자 입력 선언

​웹훅 본문에서 뽑기

​기능 플래그 스위치

​한꺼번에 스냅샷·복원

​변수가 나타나는 곳

​변수와 버전 스코프

명령

`vars list`

`vars set`

플래그

소스 설명

`vars delete`

흔한 레시피

필수 사용자 입력 선언

웹훅 본문에서 뽑기

기능 플래그 스위치

한꺼번에 스냅샷·복원

변수가 나타나는 곳

변수와 버전 스코프