> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# nora flows settings

> Flow 레벨 설정 읽기와 패치 — 승인 웹훅과 기본값.

`flows settings` 가 Flow 레벨 노브 — 앱의 **Flow settings** 아래 것들 — 을 읽고 업데이트.

## 명령

| 명령                                     | 설명                 |
| -------------------------------------- | ------------------ |
| `flows settings get [slug]`            | 현재 설정을 JSON 으로 인쇄. |
| `flows settings update [slug] [flags]` | 설정 패치. 넘긴 필드만 변경.  |

Slug 는 옵션 — 고정된 Flow 기본 ([`flows use`](/ko/cli/flows) 참고).

## `flows settings get`

```bash theme={null}
nora flows settings get support-agent
```

설정 JSON 방출. 볼 수 있는 필드:

* `approvalWebhookUrl` — 플랫폼이 승인 요청 POST 하는 외부 웹훅. 설정 안 되면 비어 있음 (승인이 앱 안에서만 표면화).
* 블록이 상속하는 런타임 기본값 (제한, 메모리 보존, 보존 정책).

파이프 친화 출력에 `--json` 추가 (기본은 사람 읽기 요약).

## `flows settings update`

```bash theme={null}
nora flows settings update support-agent \
  --set-approval-webhook https://example.com/hooks/nora
```

넘긴 플래그만 변경; 설정 안 된 플래그는 그대로.

### 사용 가능 플래그

* `--set-approval-webhook <url>` — 승인 요청이 POST 되는 곳. `''` (빈 문자열) 로 클리어.
* `--set-global-max-turns <N>` — 실행당 총 도구 호출 왕복 캡.
* `--set-global-max-tokens <N>` — 실행당 총 토큰 캡.
* `--set-global-max-cost <USD>` — 실행당 달러 캡.
* `--set-global-timeout-s <N>` — 실행당 벽시계 캡.

플래그 이름이 새 설정 출시하며 확장될 수 있음. `nora flows settings update --help` 가 현재 세트 표시.

## 흔한 레시피

### 승인을 외부 웹훅으로 가리키기

```bash theme={null}
nora flows settings update support-agent \
  --set-approval-webhook https://slack-approvals.internal/hooks/nora
```

설정되면 앱이 여전히 Approvals 큐 표시 — 하지만 모든 새 승인이 웹훅에도 POST 되어 외부 시스템이 라우팅 가능.

페이로드 모양: `nora approvals describe <slug>` 이 정확한 계약 인쇄.

### 웹훅 클리어

```bash theme={null}
nora flows settings update support-agent --set-approval-webhook ''
```

승인이 앱 안 only 로 돌아감.

### 비용 통제용 전역 캡 설정

```bash theme={null}
nora flows settings update support-agent \
  --set-global-max-cost 0.50 \
  --set-global-max-turns 20
```

둘 다 Flow 모든 실행에 적용. 블록별 캡 여전히 동작; 블록과 전역 중 더 엄격한 것 이김.

## Flow 간 설정 파이핑

`flows settings get --json` 이 파싱 가능 JSON 방출하므로 `jq` 로 한 Flow 에서 다른 Flow 로 설정 마이그레이션 가능:

```bash theme={null}
# 한 flow 에서 다른 flow 로 웹훅 복사
url=$(nora flows settings get flow-a --json | jq -r '.approvalWebhookUrl')
nora flows settings update flow-b --set-approval-webhook "$url"
```

## 설정이 적용되는 곳

설정이 적용:

* Flow 의 **모든 실행**, 모든 버전에.
* **현재 라이브** 와 미래 배포 버전 동일하게 (설정이 Flow 페이로드와 버전 관리 안 됨 — Flow 별 워크스페이스 레벨).

즉 설정 변경이 즉시 효과. 설정에 감사 변경 통제 필요하면 CLI 게이트하는 워크스페이스 정책 사용.

참고:

* [`nora vars`](/ko/cli/vars) — Flow 레벨 *변수* (블록에서 보간 가능). 설정은 런타임 노브; vars 는 콘텐츠.
* [`nora approvals`](/ko/cli/approvals) — CLI 에서 승인 로우 결정.
* [승인·배포](/ko/reliable/optimization/approve) — 승인의 개념 문서.