> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 ''
```

승인이 앱 안에서만 뜨는 상태로 돌아감.

### 비용 통제용 전역 상한 설정

```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) 승인의 개념 문서.