워크플로 안 에이전트의 모델 바꾸기

워크플로의 각 에이전트 스텝은 저마다 모델을 고릅니다 — 「계정 설정 → AI 어시스턴트」 설정과는 완전히 별개입니다. 한 워크플로 안에서 어떤 스텝은 저렴한 모델로 분류하고 다른 스텝은 강력한 모델로 보고서를 쓰는 조합은 흔한 방식입니다.

어디서 바꾸나

1. 워크플로 편집기를 열고 캔버스에서 해당 에이전트 스텝을 선택합니다.
2. 에이전트 구성 대화상자를 엽니다.
3. 먼저 맨 위의 구성 모드를 확인하세요: 프리셋 템플릿인지 사용자 지정인지. 모드에 따라 모델을 바꾸는 위치가 다릅니다.

프리셋 모드: 두 항목만 덮어쓰면 충분

프리셋(universal, coder, researcher 등)을 고르면 아래 항목은 모두 '프리셋 기본값을 덮어쓰는' 성격이 됩니다 — 비워 두면 프리셋 값이 적용됩니다. 모델을 바꾸는 데는 두 가지만 건드리면 됩니다:

• Provider — 서비스 제공자를 고릅니다. 바꾸면 모델 목록을 새 제공자 기준으로 다시 가져옵니다.
• LLM 모델 — 목록에서 고르거나 모델 ID를 직접 입력하세요. 비워 두면 프리셋의 기본 모델이 그대로 쓰입니다.

사용자 지정 모드: 라우팅 먼저, 그다음 모델

사용자 지정 모드에는 「External Agent 라우팅 설정」이라는 층이 하나 더 있어, 세 가지 중에서 이 스텝을 누가 실행할지 정합니다:

세 라우팅은 시스템 프롬프트 처리도 다릅니다. 표준 Agent는 그대로 사용하고, Claude Code는 --append-system-prompt로 덧붙이며, Codex는 별도의 시스템 프롬프트 인자가 없어 그 내용이 작업 프롬프트 앞에 붙어 함께 전송됩니다.

원하는 모델이 목록에 없나요?

먼저 대화상자 위쪽의 모델 유형 스위치를 보세요 — 텍스트 / 비디오 / 이미지:

• 비디오나 이미지를 고르면 목록에는 해당 미디어 유형을 지원하는 모델만 표시되고, 모델 ID를 직접 입력할 수도 없습니다;
• 임의의 모델 ID를 직접 입력할 수 있는 건 텍스트 유형일 때뿐입니다.

따라서 모델 목록이 비는 이유는 대개 두 가지입니다. 모델 유형이 이미지나 비디오로 되어 있거나, Provider를 막 바꿔 목록을 다시 불러오지 않았거나. 드롭다운을 닫았다 열면 다시 불러옵니다.

자격 증명은 어떻게 찾나

• 실행 시 자격 증명 센터에서 같은 Provider의 자격 증명을 개인 → 팀 → 시스템 순서로 찾습니다. 워크플로 파일에는 평문 키를 저장하지 않습니다.
• 대화상자 안의 「자격 증명 센터」 접힘 영역에는 현재 구성이 참조하는 Provider가 나열됩니다. 그대로 빠진 것만 채우면 됩니다.
• 예전 워크플로는 프리셋 재정의 안에 평문 키가 남아 있을 수 있습니다. 페이지가 자격 증명 센터로 옮긴 뒤 정리하라고 안내합니다.

자격 증명 관리에 대한 전체 지침 보기

사용자 지정 모델 별칭

대화상자에서 사용자 지정 모델을 등록할 수 있습니다. Provider와 모델 ID 조합에 별칭을 붙이면 모델 드롭다운에서 고를 수 있게 됩니다. 사내 프록시 게이트웨이, 자체 배포 모델, 공식 목록에 아직 없는 신규 모델에 유용합니다.

YAML에서는 어떻게 보이나

캔버스의 모든 변경은 YAML에 동기화됩니다. YAML을 직접 작성한다면 모델 설정은 agent 정의에 들어갑니다:

agents:
  - name: summarizer
    preset: universal
    llm:
      provider: openrouter
      model: anthropic/claude-sonnet-4.5

  - name: classifier
    preset: lightweight
    llm:
      provider: deepseek
      model: deepseek-chat

provider에는 서비스 식별자(openai, openrouter…)를 씁니다. 자격 증명에 붙인 라벨 이름이 아닙니다. 여기가 가장 흔한 실수입니다.

실전 팁 몇 가지

• 분류·추출처럼 결정적인 스텝에는 작은 모델을 쓰고, 작문과 추론 스텝에만 강한 모델을 쓰세요 — 한 워크플로에서 여러 모델을 섞는 건 아주 정상입니다.
• 모델을 바꾼 뒤에는 dry-run이나 단일 스텝 실행으로 출력 형식이 그대로인지 확인한 다음 정기 작업에 올리세요.
• 팀이 함께 쓰는 워크플로는 팀 자격 증명을 참조하세요. 그렇지 않으면 동료가 실행할 때 키를 찾지 못합니다.

이어서 보기

• Agent 구성에 대한 자세한 설명 — 프리셋, 도구 집합, 최대 반복 횟수 등 나머지 항목.
• 어시스턴트의 신원과 모델 전환하기 — 사내 AI 어시스턴트의 모델은 별도 설정입니다.
• BYOK에는 키가 함께 제공됩니다. — 각 업체 키를 어디서 받는지, 비용은 누구 청구서에 잡히는지.