> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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** 파운더리 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가 손 안 대도 잘 됩니다. 낮출 때까지 비용이 더 듭니다.
* **하위 티어 기본**(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: 기본 모델을 쓰는 Agent $count 개"
done
```

수가 많으면 살펴볼 만한, 안 손본 Agent 일 수 있습니다.

## 관련

* [Providers](/ko/settings/models/providers) 모델 뒤의 API 키.
* [`nora agents update --set-model`](/ko/cli/agents) Agent 별 덮어쓰기.
* [비용 vs. 품질](/ko/reliable/simulation/pareto) 짐작이 아니라 데이터로 모델 고르기.