> ## 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.

# 모델 기본값

> 워크스페이스 전체 모델 선호 — Agent 생성 시 채택하는 기본값.

모든 새 Agent 블록이 기본 모델로 시작. Agent 별 선택 않도록 워크스페이스 기본값 설정.

## 기본값 설정

**Settings → Models → Defaults**:

* **Default text model** — 새 Agent 블록이 사용.
* **Default vision model** — Agent 입력에 이미지 포함 시 사용.
* **Default voice model** — 음성 입력에 사용.
* **Default embedding model** — Foundry Embed 블록과 메모리 인덱스 스페이스가 사용.

기존 Agent 는 설정된 모델 유지 — 기본값은 생성 시에만 적용.

## Agent 별 오버라이드

다른 모델 필요한 Agent 는 UI 의 **Agent → Model** 로 기본값 오버라이드, 또는:

```bash theme={null}
nora agents update ag_1 --set-model gpt-4o
```

오버라이드 지속 — 나중 워크스페이스 기본값 변경이 명시 선택 있는 Agent 에 영향 안 함.

## 폴백 모델

모든 Agent 가 **폴백 모델** 선언 가능 — primary 가 provider 제한이나 에러 히트할 때 사용.

Agent 별 설정 (워크스페이스 전체 폴백 없음). 흔한 패턴:

* Primary: 고품질 모델 (더 높은 비용).
* Fallback: 보통 충분한 저렴하고 빠른 모델.

트레이스가 턴별 실제 실행된 모델 표시, 그래서 폴백률 측정 가능.

## 비용 기본값

새 Agent 가 상속하는 워크스페이스 기본 비용 캡 설정:

* **실행당 기본 max cost** — 달러 캡.
* **실행당 기본 max tokens** — 토큰 캡.

기존 Agent 는 명시 값 유지.

아직 튜닝 안 된 새 Agent 의 우발 "무제한 실행" 비용 방지.

## 기본값 선택

트레이드오프:

* **상위 티어 기본** (GPT-4o, Claude Opus, Gemini Pro) — 새 Agent 가 out-of-box 로 잘 동작. 튜닝 다운까지 더 높은 비용.
* **하위 티어 기본** (GPT-4o-mini, Claude Haiku, Gemini Flash) — 새 Agent 저렴. 품질 요구할 때 개별 Agent 업그레이드.

권장: **하위 티어 기본, 시뮬레이션 기반 Agent 별 업그레이드.** 저렴한 베이스라인; 프리미엄에 대한 명시 선택. Nora 의 시뮬레이션 뷰 ([시뮬레이션](/ko/reliable/simulation/overview) 참고) 가 선택을 데이터 기반으로.

## 기본값이 가장 중요할 때

* **팀 온보딩** — Agent 빌드하는 새 엔지니어가 미리 결정 안 해도 됨.
* **벌크 작업** — 많은 Agent 생성하는 CI 스크립트가 생성별 모델 선택 불필요.
* **템플릿** — 조직에 배송된 Flow 템플릿이 워크스페이스 기본값 사용.

## 드리프트 관찰

일부 Agent 가 생성되고 튜닝 안 됨 — 영원히 기본에 실행. 건강 체크:

```bash theme={null}
# 기본 모델의 Agent 카운트
default=$(nora settings models defaults --json | jq -r '.default_text_model')
for f in $(nora flows list --json | jq -r '.[].slug'); do
  count=$(nora flows get $f | jq --arg m "$default" '[.blocks[] | select(.kind=="agent" and .model==$m)] | length')
  echo "$f: $count Agent 가 기본 모델에"
done
```

높은 카운트가 리뷰 가치 있는 미튜닝 Agent 일 수 있음.

## 관련

* [Providers](/ko/settings/models/providers) — 모델 뒤의 API 키.
* [`nora agents update --set-model`](/ko/cli/agents) — Agent 별 오버라이드.
* [비용 vs. 품질](/ko/reliable/simulation/pareto) — 짐작이 아닌 데이터로 모델 선택.