Skip to main content
관리자 › 설정 › 모델
연결에서 등록한 LLM 프로바이더의 모델 목록을 관리합니다.
  • 개별 모델의 활성화/비활성화, 커스터마이징, 표시 순서, 기본 모델 설정을 이 탭에서 제어합니다.
모델 관리 탭

연결된 모든 모델을 한 곳에서 관리합니다 — 활성화, 커스터마이징, 순서 지정

​
모델 목록

Workspace 모델(관리자가 직접 생성/커스텀한 모델)과 Base 모델(연결된 API에서 가져온 시스템 모델)을 합쳐서 표시합니다.
  • 목록 상단의 모델 검색 입력창으로 이름·ID를 필터링할 수 있습니다.
각 모델 행에는 이 모델을 참조하는 에이전트·플로우·평가 개수 배지(예: Agents 6, Flows 1, Evaluations 9)가 함께 표시되어, 해당 모델이 어디에 쓰이는지 한눈에 파악할 수 있습니다(모델 편집 화면 하단 Used by와 동일한 의존성 정보).

​
모델 숨김 (Shift+Click)

모델 목록에서 Shift 키를 누른 상태로 모델 행의 아이콘을 클릭하면 숨김/표시 토글이 나타납니다. 숨김 처리된 모델은 meta.hidden 상태로 관리되며, 사용자의 모델 선택 목록에서 보이지 않습니다.
숨김(Hidden)과 비활성화(Disabled)는 별개 기능입니다. 숨김은 모델 선택 목록에서 감추는 것이고, 비활성화는 모델 자체를 사용 불가로 전환합니다.

​
기본 모델 및 순서 설정

모델 목록 우측 상단의 설정(톱니바퀴) 아이콘을 클릭하면 모델 설정 모달이 열립니다.

​
모델 활성화/비활성화

모델별 Enabled / Disabled 토글(Switch)로 필요한 모델만 사용자에게 노출할 수 있습니다.
비활성화(Disabled)된 모델은 사용자의 모델 선택 드롭다운에 표시되지 않습니다. 에이전트의 base model로 지정된 모델은 비활성화해도 에이전트 실행에는 영향이 없습니다.

​
모델 커스터마이징

모델 행의 편집(연필) 아이콘을 클릭하면 해당 모델을 커스터마이징할 수 있습니다.
지식 기반·데이터베이스·도구·용어집 연결과 자동 평가는 에이전트 전용입니다. 관리자 모델 편집에서는 제공되지 않으며, 워크스페이스 > 에이전트에서 설정합니다. 모델 편집에서 런타임에 적용되는 리소스는 가드레일뿐입니다.
모델을 커스터마이징하면 해당 모델에 대한 Workspace 설정 레코드가 생성됩니다. 이것은 에이전트와 달리 기반 모델을 직접 수정하는 것이 아니라 오버라이드 설정을 추가하는 개념입니다.

​
사용자에게 노출되는 모델 제어

일시적으로 목록에서만 감추려면 숨기기, 사용을 완전히 차단하려면 비활성화를 사용하세요. (둘의 차이는 위 “모델 숨김” 설명 참고)

​
토큰 제한

모델별 일일 토큰 사용량을 제한해 AI 사용 비용을 관리합니다.
  • 모델 목록 우측 상단의 토큰 제한 버튼으로 전역 기본값을 설정합니다.
  • 각 모델 행의 토큰 제한 드롭다운으로 모델별 한도를 설정합니다.

​
전역 토큰 제한 (토큰 제한 버튼)

​
모델별 한도

각 모델 행의 토큰 제한 드롭다운에서 해당 모델의 일일 한도를 개별 지정합니다. 지정하지 않은 모델은 위의 기본 일별 토큰 제한을 따릅니다.
관리자(Admin) 역할은 토큰 제한 체크에서 제외됩니다. 제한은 전역·사용자·그룹·조직 4단계로 설정 가능하며, 여러 곳에 설정되면 가장 관대한(높은) 값이 적용됩니다. 사용자별·모델별 사용 현황은 사용자 관리의 사용량 탭에서 확인합니다.

​
Ollama 모델 관리

모델 목록 상단의 다운로드 아이콘을 클릭하면 Ollama 모델 관리 모달이 열립니다.
Ollama 인스턴스가 여러 개 연결되어 있으면 관리할 인스턴스를 먼저 선택해야 합니다.

​
모델 프리셋 Import / Export

모델 설정을 JSON 형태로 백업하고 복원할 수 있습니다.
  • 이 기능은 관리자 전용입니다.
Import 시 기존 모델 설정이 덮어씌워집니다. 반드시 Export로 백업 후 진행하세요.
base_model_id가 null인 모델(Workspace 커스텀 설정)만 Import 됩니다. 에이전트(base_model_id가 다른 모델을 참조)는 이 탭에서 Import되지 않습니다 — 에이전트는 워크스페이스 > 에이전트에서 별도로 Import하세요.
설정 모달(톱니바퀴) 하단의 Reset All Models 버튼을 클릭하면 모든 Workspace 커스텀 설정이 삭제됩니다. 연결된 기본 모델 목록은 유지되지만, 이름/설명/프롬프트 등 커스터마이징 내용이 모두 초기화됩니다.

​
관련 페이지

연결

LLM 프로바이더 API 연결 구성

에이전트

모델 위에 지식 기반·도구·가드레일을 결합한 AI 어시스턴트

사용량

모델별 토큰 사용량 및 비용 분석