에이전트 오케스트레이션
3. 모델과 effort를 단계에 배정하기5 / 9

한 런 안에서도 값을 다르게 매긴다

난이도별 모델 배정, effort 우선순위, alias와 재현성

개념 학습 45 XP 9분

워크플로는 여러 agent를 띄우므로 같은 작업을 대화로 처리할 때보다 토큰을 크게 더 쓰고 플랜의 usage와 rate limit에 그대로 계산됩니다. 그래서 모든 단계를 같은 모델과 같은 effort로 돌리는 것이 가장 비싼 기본값입니다. 서브에이전트 frontmatter의 model과 effort는 단계마다 값을 다르게 매기는 지점이고, effort 우선순위는 환경변수 → 설정한 레벨 → 모델 기본값 순입니다. 한편 alias는 provider마다 다른 버전으로 해석되므로, 재현이 중요한 경로는 full model name으로 고정해야 합니다.

단계배정 기준설정 지점
코드 탐색·검색읽기만 하고 판단이 얕음Explore 또는 model: haiku
반복 구현·테스트패턴이 정해진 다건 작업sonnet 계열 + 기본 effort
설계·장애 원인 분석되돌리기 어려운 판단opus/fable + /effort xhigh
CI·재현이 필요한 경로alias 해석이 바뀌면 안 됨full model name 고정
전 코드베이스 대형 작업단계 수를 미리 못 정함/effort ultracode (세션 한정)
Haiku는 메인 모델로는 쓸 수 없지만 서브에이전트 모델로는 계속 쓸 수 있습니다.
  1. 현재 기본값 확인활성 모델은 /model·/status로, effort는 /model 피커 표시로 읽습니다.
  2. 단계별 값 고정서브에이전트 frontmatter의 model과 effort로 단계마다 값을 못 박습니다.
  3. 재현 경로 pinCI와 벤치마크는 alias 대신 full model name으로 고정합니다.
  4. 가용성 실패 대비fallbackModel 또는 --fallback-model로 폴백 체인을 지정합니다.