Model Picker 도구

Model Picker 도구 (Model Picker Tool)

에이전트가 대화의 턴마다 어떤 모델을 쓸지 동적으로 고르게 하는 방법을 설명해요. 요청 유형에 따라 모델을 라우팅할 수 있어요.

출처: 문서

본문

model picker 도구는 에이전트가 대화의 각 턴에 어떤 모델을 쓸지 동적으로 고르게 해 줘요. 서로 다른 유형의 요청을 서로 다른 모델로 라우팅하고 싶을 때 유용해요 — 예를 들어 간단한 질의에는 빠르고 저렴한 모델을, 복잡한 추론 작업에는 더 강력한 모델을 쓰는 식이죠.

구성

toolsets:
  - type: model_picker
    models:
      - openai/gpt-5-mini
      - anthropic/claude-sonnet-4-5
      - openai/gpt-5

옵션

속성 타입 필수 설명
models array[string] ✓ 에이전트가 고를 수 있는 모델 참조 목록. provider/model 형식 사용

동작 방식

model picker 도구셋이 활성화되면 에이전트는 두 도구를 얻어요: 구성된 모델 중 하나로 전환하는 change_model과 기본 모델로 돌아가게 하는 revert_model이에요. 에이전트는 작업의 복잡성, 비용 고려 사항, 또는 사용자가 지침에 서술한 다른 요인에 따라 어떤 모델을 쓸지 결정해요.

예시

agents:
  root:
    model: openai/gpt-5-mini  # 기본 모델
    instruction: |
      You are a helpful assistant. For simple questions, use gpt-5-mini.
      For complex reasoning or coding tasks, switch to claude-sonnet-4-5 or gpt-5.
    toolsets:
      - type: model_picker
        models:
          - openai/gpt-5-mini
          - anthropic/claude-sonnet-4-5
          - openai/gpt-5

팁 비용 최적화 model picker 도구는 비용 최적화에 특히 유용해요: 에이전트가 기본적으로 저렴한 모델을 쓰고 필요할 때만 비싼 모델로 승격하게 하세요.

도구 인터페이스

도구셋은 두 도구를 노출해요:

change_model

파라미터 타입 필수 설명
model string ✓ 전환할 모델. 구성된 모델 중 하나여야 함

revert_model

파라미터 없음. 에이전트를 원래/기본 모델로 되돌려요.

전환은 즉시 적용돼요. 다음 추론 호출 — 현재 에이전트 루프의 나머지 포함 — 에 새 모델을 사용해요.

더 알아보기 (Learn more)