Skip to main content
Agent 가 외부 제공자 (OpenAI, Anthropic, Google) 모델과 Nora 관리 모델 티어에 대해 실행. Agent 가 호출하는 각 제공자가 워크스페이스 레벨 API 키 필요.

키가 사는 곳

  • 워크스페이스 스코프 — 키가 사용자별이 아닌 워크스페이스별.
  • 저장 시 암호화 — UI 나 API 로 절대 반환 안 됨. 앱이 키를 다시 못 읽음.
  • 워크스페이스별 사용량 귀속 — 키를 워크스페이스별로 유지가 제공자 대시보드의 비용 귀속을 깨끗하게 만듦.

키 추가

Settings → Models → Providers → Add key:
  1. 제공자 선택 (OpenAI, Anthropic, Google, …).
  2. 키 붙여넣기. 입력 마스킹.
  3. 저장.
또는 CLI 로:
CLI 세부는 nora providers 참고.

Nora 가 지원하는 제공자

  • OpenAI — GPT 모델.
  • Anthropic — Claude 모델.
  • Google — Gemini 모델.
  • Nora managed — Nora 호스팅 모델 (외부 키 불필요; Nora 가 결제).
더 많은 제공자 정기 출시. 앱의 providers 목록이 현재 세트 표시.

키 로테이션

새 값으로 키 다시 추가. 이전 키가 원자적으로 교체:
  • 새 실행이 즉시 새 키 사용.
  • 진행 중 실행이 이전 키에서 완료 (네트워크 안정화까지 최대 1분).
몇 분 걸쳐 auth 실패 관찰로 검증:

키 삭제

키 제거. 그 제공자 쓰는 어느 Agent 든 새 키 설정할 때까지 다음 실행 실패.

Provider 준비 체크

Flow 배포 전 모든 모델이 provider 키 있는지 검증:
테이블 인쇄:
CI 가 이 체크로 배포 게이트 가능.

Provider vs. Nora 관리 모델

  • Provider 키 — 여러분이 제공자에게 직접 결제, 그들 미터로.
  • Nora 관리 — Nora 가 모델 호스팅, Nora 인보이스로 결제. 결제 더 간단; 가끔 더 저렴.
--set-model 로 Agent 블록별 선택 (nora agents 참고). 자유롭게 섞기 — 한 Flow 가 provider 모델과 관리 모델을 같은 실행에서 사용 가능.

요율 제한과 쿼터

Provider 요율 제한 적용. Agent 가 부하에서 429 받으면:
  • Provider 티어 상향 (OpenAI 의 Tier 4, Anthropic 의 Enterprise 등).
  • Agent 별 폴백 모델 추가 (nora agents update --set-model 참고) — Agent 가 실패 시 투명하게 전환.
  • 인텐트별 라우팅 — 저렴한 인텐트를 저렴한 모델, 어려운 인텐트를 프리미엄 모델.
Nora 는 provider 위에 자체 요율 제한 추가 안 함.

비용 대시보드

Provider 비용이 provider 자체 대시보드 (OpenAI, Anthropic, Google) 에 표시. Nora 의 결제 표면이 Nora 플랫폼 비용 커버; 결제 개요 참고. 키가 워크스페이스별이므로 provider 대시보드의 워크스페이스별 비용 귀속이 간단.

보안

  • 키가 워크스페이스별 키로 암호화 저장.
  • 로테이션 즉시.
  • 삭제 영구 (키 유지 안 됨).
  • 모든 추가·로테이션·삭제 감사.

관련