> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Providers

> LLM 제공자 API 키 관리 — OpenAI, Anthropic, Google 등.

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

## 키가 사는 곳

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

## 키 추가

**Settings → Models → Providers → Add key**:

1. 제공자 선택 (OpenAI, Anthropic, Google, ...).
2. 키 붙여넣기. 입력 마스킹.
3. 저장.

또는 CLI 로:

```bash theme={null}
nora providers set openai --stdin <<< "$OPENAI_API_KEY"
```

CLI 세부는 [`nora providers`](/ko/cli/providers) 참고.

## Nora 가 지원하는 제공자

* **OpenAI** — GPT 모델.
* **Anthropic** — Claude 모델.
* **Google** — Gemini 모델.
* **Nora managed** — Nora 호스팅 모델 (외부 키 불필요; Nora 가 결제).

더 많은 제공자 정기 출시. 앱의 providers 목록이 현재 세트 표시.

## 키 로테이션

새 값으로 키 다시 추가. 이전 키가 원자적으로 교체:

* 새 실행이 즉시 새 키 사용.
* 진행 중 실행이 이전 키에서 완료 (네트워크 안정화까지 최대 1분).

몇 분 걸쳐 auth 실패 관찰로 검증:

```bash theme={null}
nora traces list --status error --search "authentication" --limit 10
```

## 키 삭제

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

## Provider 준비 체크

Flow 배포 전 모든 모델이 provider 키 있는지 검증:

```bash theme={null}
nora providers check support-agent
```

테이블 인쇄:

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

CI 가 이 체크로 배포 게이트 가능.

## Provider vs. Nora 관리 모델

* **Provider 키** — 여러분이 제공자에게 직접 결제, 그들 미터로.
* **Nora 관리** — Nora 가 모델 호스팅, Nora 인보이스로 결제. 결제 더 간단; 가끔 더 저렴.

**`--set-model`** 로 Agent 블록별 선택 ([`nora agents`](/ko/cli/agents) 참고). 자유롭게 섞기 — 한 Flow 가 provider 모델과 관리 모델을 같은 실행에서 사용 가능.

## 요율 제한과 쿼터

Provider 요율 제한 적용. Agent 가 부하에서 429 받으면:

* Provider 티어 상향 (OpenAI 의 Tier 4, Anthropic 의 Enterprise 등).
* Agent 별 폴백 모델 추가 ([`nora agents update --set-model`](/ko/cli/agents) 참고) — Agent 가 실패 시 투명하게 전환.
* 인텐트별 라우팅 — 저렴한 인텐트를 저렴한 모델, 어려운 인텐트를 프리미엄 모델.

Nora 는 provider 위에 자체 요율 제한 추가 안 함.

## 비용 대시보드

Provider 비용이 provider 자체 대시보드 (OpenAI, Anthropic, Google) 에 표시. Nora 의 결제 표면이 Nora 플랫폼 비용 커버; [결제 개요](/ko/settings/billing/overview) 참고.

키가 워크스페이스별이므로 provider 대시보드의 워크스페이스별 비용 귀속이 간단.

## 보안

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

## 관련

* [`nora providers`](/ko/cli/providers) — CLI 레퍼런스.
* [모델 기본값](/ko/settings/models/defaults) — 워크스페이스 전체 모델 선호.
* [결제 개요](/ko/settings/billing/overview) — Nora 플랫폼 결제.
* [승인](/ko/reliable/optimization/approve) — 승인 게이트가 설정되면 모델 스왑 블록 가능.