모델 및 제공업체

개요

Neotask는 다양한 AI 모델 제공업체를 지원합니다. Anthropic, OpenAI, Google의 클라우드 호스팅 모델을 사용하거나, Ollama 또는 vLLM을 통해 로컬 모델을 실행하거나, OpenAI 호환 API 엔드포인트에 연결할 수 있습니다.

지원되는 제공업체

클라우드 제공업체

제공업체 모델 인증
Anthropic Claude Opus 4.6, Claude Sonnet 4.1, Claude Haiku 4.5 API 키 또는 설정 토큰
OpenAI GPT-5.2, GPT-5.1, GPT-4 Turbo, GPT-4 API 키
Google (Gemini) Gemini 3 Pro, Gemini 2 Flash, Gemini 1 Pro API 키 또는 OAuth
Together AI 다양한 오픈 웨이트 모델 (Llama, Mixtral 등) API 키
Moonshot (Kimi) Moonshot v1 (32K, 128K 컨텍스트) API 키
OpenRouter 여러 제공업체의 100개 이상 모델 API 키
DeepSeek DeepSeek Chat, DeepSeek Coder API 키
OpenCode Zen Claude 변형, 커스텀 튜닝 모델 API 키

로컬 모델 제공업체

제공업체 설명
Ollama 로컬에서 오픈 웨이트 모델 실행 (Llama, Mistral 등)
vLLM 고처리량 로컬 추론 서버
LiteLLM 100개 이상 제공업체를 위한 통합 프록시

커스텀 제공업체

기본 URL과 API 키를 지정하여 OpenAI 호환 또는 Anthropic 호환 API에 연결합니다. 자체 호스팅 추론 서버, 엔터프라이즈 프록시 엔드포인트, 타사 모델 API와 작동합니다.

모델 구성

기본 모델

모든 에이전트의 기본 모델을 설정합니다. 각 에이전트는 자체 기본 모델로 이를 재정의할 수 있습니다.

폴백 체인

우선순위가 있는 폴백 모델 목록을 구성합니다. 기본 모델이 실패(속도 제한, 중단, 인증 오류)하면 Neotask가 자동으로 체인의 다음 모델을 시도합니다.

이미지 모델

이미지 분석 및 생성을 위한 별도 모델 구성. Claude Vision, GPT-4 Vision, DALL-E 3를 지원합니다.

모델 별칭

긴 모델 이름의 단축키를 만듭니다. 예를 들어 fast를 anthropic/claude-haiku-4-5로 별칭을 지정하여 빠른 참조가 가능합니다.

에이전트별 재정의

각 에이전트는 전체 기본값과 독립적으로 자체 모델 구성을 가질 수 있습니다.

모델 허용 목록

에이전트가 사용할 수 있는 모델을 제한합니다. 비용 제어 또는 규정 준수에 유용합니다.

API 키 관리

키 소스 (우선순위 순서)

  1. 라이브 재정의 키 (최고 우선순위)
  2. 쉼표로 구분된 키 목록 (순환)
  3. 기본 키
  4. 번호가 매겨진 키 (key_1, key_2 등)

자동 키 순환

속도 제한에 도달하면 Neotask가 자동으로 다음 사용 가능한 키로 전환합니다. 속도 제한이 아닌 실패는 순환 없이 즉시 오류를 반환합니다.

제공업체별 구성

각 제공업체는 자체 API 키 세트, 인증 프로필, 모델별 설정을 가질 수 있습니다.

제공업체 인증 방법

방법 설명
API 키 표준 베어러 토큰 인증
설정 토큰 인터랙티브 인증 흐름 (Anthropic)
OAuth 갱신 토큰을 사용한 위임 인증 (Google, GitHub Copilot)
토큰 붙여넣기 특화된 제공업체를 위한 수동 토큰 입력

모델 선택 우선순위

에이전트가 LLM 호출을 해야 할 때 모델은 다음 순서로 선택됩니다:

  1. 에이전트별 재정의 (설정된 경우)
  2. 전체 기본 모델
  3. 모델 허용 목록 (구성된 경우 옵션 제한)
  4. 첫 번째 사용 가능한 모델 (폴백)

제공업체별 도구 제한

특정 모델이나 제공업체에 사용 가능한 도구를 제한할 수 있습니다. 예를 들어 신뢰도가 낮은 모델은 파일 작업만 허용하고, Claude는 전체 도구 접근을 허용합니다.