nora providers

Nora 가 Agent 를 여러 provider (OpenAI, Anthropic, Google 등) 모델에 대해 실행. 각 provider 가 워크스페이스별 API 키 필요. providers 가 그것들 관리 CLI.

명령

명령	설명
`providers list`	모든 provider 와 키 있는지 인쇄.
`providers set <provider>`	Provider 용 API 키 저장.
`providers delete <provider>`	저장된 키 제거.
`providers check <flow-slug>`	Flow 가 필요한 provider vs. 키 있는 것 리포트.

`providers list`

nora providers list

지원되는 모든 provider 와 상태 인쇄:

openai: configured — 키 설정됨.
anthropic: not configured — 키 없음.
google: configured.

구조화 출력에 --json 추가.

`providers set`

# 인터랙티브 (마스킹)
nora providers set openai --stdin <<< "sk-..."

# 환경변수에서 (권장)
nora providers set openai --env OPENAI_API_KEY

# 리터럴 (셸 히스토리 경고)
nora providers set openai sk-...

플래그:

<provider> (위치, 필수) — provider ID.
--stdin — stdin 에서 키 읽기. 선호.
--env <var> — 환경변수에서 읽기. CI 에 선호.
위치 키 — 리터럴. 최소 선호 (셸 히스토리에 착지).

저장된 키가 저장 시 암호화되고 API 로 절대 반환 안 됨 — CLI 가 다시 읽을 수 없음. 새 키로 set 재실행해 로테이션. 이전 키가 즉시 교체.

`providers delete`

nora providers delete openai

저장된 키 제거. 이 provider 모델 쓰는 어느 Flow 든 새 키 설정할 때까지 실패. --yes 안 넘기면 확인 필요.

`providers check`

nora providers check support-agent

특정 Flow 에 리포트:

Flow 의 Agent 블록이 참조하는 provider.
그중 키 설정된 것.
갭.

사전 배포 체크로 좋음 — “모델 바꿨는데 키 추가 잊음” 을 출시 전 잡음. 예 출력:

Flow: support-agent
  openai:    ✓ configured  (3 Agent 사용)
  anthropic: ✗ MISSING     (1 Agent 사용 — ag_secondary)
  google:    - 사용 안 함

스크립트 가능 출력에 --json 추가 — CI 가 이걸로 게이트 가능.

레시피

부트스트랩 스크립트에서 환경으로부터 키 설정

nora providers set openai --env OPENAI_API_KEY
nora providers set anthropic --env ANTHROPIC_API_KEY
nora providers set google --env GOOGLE_API_KEY

워크스페이스 셋업 runbook 에 잘 맞음.

CI: Flow 에 어느 provider 든 누락되면 실패

if nora providers check support-agent --json | jq -e '.gaps | length > 0' > /dev/null; then
  echo "Provider 키 누락 — 배포 전 설정."
  exit 1
fi

유예 있는 키 로테이션

# 새 키 설정 (덮어씀)
nora providers set openai --env OPENAI_API_KEY_NEW

로테이션이 원자적 — 새 키가 다음 호출부터 사용. 진행 중 실행이 이전 키에서 완료. 정상 확인으로 몇 분 걸쳐 auth 실패 관찰:

sleep 300
nora traces list --status error --search "OpenAI" --limit 10

워크스페이스 간 키 마이그레이션

# 소스에서 익스포트 (안전 볼트로, CLI 아님 — CLI 가 다시 못 읽음)
# 그 다음 목적지에 설정:
nora --workspace destination providers set openai --stdin < ~/.secrets/openai

키가 워크스페이스 스코프 — 각 워크스페이스가 자체 소유.

Provider 와 비용

Provider 키가 Nora 관리 모델 티어 아니면 provider (OpenAI, Anthropic, …) 가 직접 결제. Nora 플랫폼 자체 결제는 별개 — nora billing 참고. 비용 귀속에 워크스페이스별 키 사용: OpenAI 대시보드가 API 키별 지출 표시하므로 워크스페이스별 키가 팀별이나 환경별 비용 분할 가능.

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

nora providers

명령

`providers list`

`providers set`

`providers delete`

`providers check`

레시피

부트스트랩 스크립트에서 환경으로부터 키 설정

CI: Flow 에 어느 provider 든 누락되면 실패

유예 있는 키 로테이션

워크스페이스 간 키 마이그레이션

Provider 와 비용

관련

​명령

​providers list

​providers set

​providers delete

​providers check

​레시피

​부트스트랩 스크립트에서 환경으로부터 키 설정

​CI: Flow 에 어느 provider 든 누락되면 실패

​유예 있는 키 로테이션

​워크스페이스 간 키 마이그레이션

​Provider 와 비용

​관련

명령

`providers list`

`providers set`

`providers delete`

`providers check`

레시피

부트스트랩 스크립트에서 환경으로부터 키 설정

CI: Flow 에 어느 provider 든 누락되면 실패

유예 있는 키 로테이션

워크스페이스 간 키 마이그레이션

Provider 와 비용

관련