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와 키 있는 것 리포트.

`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  (Agent 3개 사용)
  anthropic: ✗ MISSING     (Agent 1개 사용: 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는 다시 못 읽음)
# 그다음 목적지에 설정:
nora --workspace destination providers set openai --stdin < ~/.secrets/openai

키는 워크스페이스 스코프입니다. 워크스페이스마다 자기 것을 가집니다.

Provider와 비용

모델 비용은 provider(OpenAI, Anthropic, …)가 직접 결제합니다. Nora 플랫폼 자체 결제는 별개입니다. nora billing을 참고하세요. 비용을 나눠 보려면 워크스페이스별 키를 씁니다. OpenAI 대시보드가 API 키별 지출을 보여 주므로, 워크스페이스별 키로 팀별·환경별 비용을 나눌 수 있습니다.

CLI

SDK

Local App

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와 비용

관련