Skip to main content
flows settings는 Flow 수준 노브, 즉 앱의 Flow settings 아래 것들을 읽고 업데이트합니다.

명령

Slug는 선택입니다. 고정된 Flow를 기본으로 씁니다(flows use 참고).

flows settings get

설정 JSON을 냅니다. 볼 수 있는 필드입니다:
  • approvalWebhookUrl 플랫폼이 승인 요청을 POST 하는 외부 웹훅. 안 정하면 비어 있음(승인이 앱 안에서만 뜸)
  • 블록이 물려받는 런타임 기본값(제한, 메모리 보존, 보존 정책)
파이프용 출력은 --json을 붙입니다(기본은 사람이 읽는 요약).

flows settings update

넘긴 플래그만 바뀝니다. 안 넘긴 건 그대로입니다.

쓸 수 있는 플래그

  • --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가 지금 목록을 표시합니다.

흔한 레시피

승인을 외부 웹훅으로 보내기

정하면 앱이 Approvals 큐를 여전히 표시합니다. 다만 새 승인이 웹훅에도 POST 되어 외부 시스템이 라우팅할 수 있습니다. 페이로드 모양은 nora approvals describe <slug>가 정확한 계약을 출력합니다.

웹훅 지우기

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

비용 통제용 전역 상한 설정

둘 다 Flow의 모든 실행에 적용됩니다. 블록별 상한도 여전히 동작합니다. 블록과 전역 중 더 빡빡한 쪽이 이깁니다.

Flow 사이 설정 파이핑

flows settings get --json이 파싱 가능한 JSON을 내므로, jq로 한 Flow에서 다른 Flow로 설정을 옮길 수 있습니다:

설정이 적용되는 곳

설정이 이렇게 적용됩니다:
  • Flow의 모든 실행, 모든 버전에
  • 지금 라이브와 미래 배포 버전에 똑같이(설정은 Flow 페이로드와 함께 버전 관리되지 않습니다. Flow 별 워크스페이스 수준입니다)
즉 설정 변경이 바로 적용됩니다. 설정에 감사 변경 통제가 필요하면 CLI를 막는 워크스페이스 정책을 씁니다. 참고:
  • nora vars Flow 수준 변수(블록에서 보간 가능). 설정은 런타임 노브고, vars는 콘텐츠
  • nora approvals CLI에서 승인 낱건 결정
  • 승인·배포 승인의 개념 문서