mini-SWE-agent

mini-SWE-agent에는 기본 URL 환경 변수가 없습니다 — 엔드포인트는 YAML 구성의 model.model_kwargs.api_base 아래에 지정하며, mini가 이를 litellm.completion에 그대로 전달합니다

# mini has no base-URL environment variable and no settings UI. The endpoint
# goes in an agent config file, under model.model_kwargs — which mini's docs
# describe as "directly passed to litellm.completion".
model:
  model_name: "openai/claude-sonnet-5"
  model_kwargs:
    custom_llm_provider: "openai"
    api_base: "https://api.kunavo.com/v1"   # keep the /v1
  litellm_model_registry: "kunavo-registry.json"   # see "Cost tracking" below

# The key does not live in this file. With custom_llm_provider: "openai",
# litellm reads OPENAI_API_KEY, and mini documents two ways to set it:
#
#   export OPENAI_API_KEY=sk-kn-...          # environment, wins over .env
#   mini-extra config set OPENAI_API_KEY sk-kn-...   # mini's own .env
#
# Then run it:  mini -c kunavo.yaml
# Or make it the default:  mini-extra config set MSWEA_MINI_CONFIG_PATH kunavo.yaml

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 경로가 생성되도록 설치한 다음 한 번 실행하세요. pip install mini-swe-agent를 실행한 뒤 mini를 실행합니다. 첫 실행 시 .env와 에이전트 구성 파일의 위치가 출력되고, mini-extra config setup를 선택할 수 있습니다.
3. litellm이 조회할 위치에 키를 설정하세요. export OPENAI_API_KEY=sk-kn-...를 사용하거나 mini-extra config set OPENAI_API_KEY sk-kn-...로 저장할 수 있습니다. mini는 “환경 변수는 .env 파일에 설정된 변수보다 우선합니다”라고 안내합니다. 방금 변경한 키가 바뀌지 않은 것처럼 보이는 일반적인 이유입니다.
4. 위 YAML을 다른 에이전트 구성 파일과 함께 kunavo.yaml에 저장하고 아래 섹션의 가격 레지스트리를 추가하세요. 레지스트리가 없으면 잘못된 답변이 아니라 비용 계산 오류로 실행이 중단됩니다.
5. mini -c kunavo.yaml로 시작하거나, 한 번만 사용할 ID를 지정하려면 mini -c kunavo.yaml -m openai/claude-haiku-4-5를 사용하세요. mini는 명령을 하나씩 승인하는 confirm 모드로 시작합니다. 새 엔드포인트를 처음 실행할 때 적합한 기본값입니다.
6. 인사말이 아니라 실제로 명령을 실행하는 작업을 맡기세요. mini v2의 기본값은 네이티브 도구 호출이며, 기본 프롬프트에는 “모든 응답은 명령을 실행하기 위해 'bash' 도구를 최소 한 번 사용해야 합니다”라고 명시되어 있습니다. 따라서 도구 왕복 실행을 실제로 한 번 해봐야 연동이 작동하는지 확인할 수 있습니다. 도구 호출 결과가 비어 있거나 형식이 잘못된 경우에도 mini에는 이전 텍스트 파싱 경로가 포함되어 있습니다. mini -c mini_textbased.yaml를 사용하거나 자체 파일에서 model_class: litellm_textbased를 설정하세요.

mini-SWE-agent의 로컬 모델 가이드에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 mini-SWE-agent에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

여기서는 비용 추적이 필수입니다

배포된 mini에는 mini.yaml가 포함되어 있으며, 이는 실행당 달러 기준 상한인 cost_limit: 3.을 설정합니다. 이 상한은 litellm 비용 계산기가 적용하며, 모델 ID를 레지스트리에서 조회해 실행 비용을 산정합니다. Kunavo의 ID는 해당 레지스트리에 없으므로, 대부분의 사용자는 잘못된 답변이 아니라 오류를 먼저 보게 됩니다. mini의 문제 해결 페이지에는 이 오류가 Exception: This model isn't mapped yet. model=…, custom_llm_provider=…로 나와 있습니다.

해결 방법은 두 가지지만 서로 같은 것은 아닙니다. 전역 스위치 MSWEA_COST_TRACKING="ignore_errors"(또는 파일의 cost_tracking: "ignore_errors")를 사용하면 문제를 해결하는 대신 보호 기능을 제거합니다. mini는 이를 “주의: 관리되지 않는 지출로 이어질 수 있습니다!”라고 표시합니다. 다른 방법은 litellm에 요금을 알려주는 것으로, 설정 블록의 litellm_model_registry가 이를 참조합니다. 아래 요금은 이 사이트의 실시간 카탈로그 요금을 litellm의 토큰당 형식으로 변환한 값입니다.

{
  "claude-sonnet-5": {
    "input_cost_per_token": 0.0000014,
    "output_cost_per_token": 0.000007,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-opus-5": {
    "input_cost_per_token": 0.0000035,
    "output_cost_per_token": 0.0000175,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-haiku-4-5": {
    "input_cost_per_token": 0.0000007,
    "output_cost_per_token": 0.0000035,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

1. 모델 이름은 대소문자를 구분해 정확히 일치시켜야 합니다. mini의 예시는 공급자 접두사를 제외한 이름을 키로 사용하므로, 설정에 openai/claude-sonnet-5라고 되어 있어도 여기서는 claude-sonnet-5를 사용합니다.
2. litellm_provider는 접두사 및 custom_llm_provider와 일치해야 합니다. mini는 다음과 같이 명시적으로 경고합니다. “custom_llm_provider를 사용하거나 모델 이름 앞에 공급자 접두사를 붙이는 경우(예: openai/…), 구성의 litellm_provider도 이에 맞춰야 합니다!”
3. 구성 키 대신 LITELLM_MODEL_REGISTRY_PATH에서 경로를 지정할 수도 있습니다. 예를 들어 배치 실행기에 유용합니다. LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. 이 요금은 예산을 입력하기 위한 값이지 청구 금액이 아닙니다. 실제 청구액은 Kunavo 잔액에 기록된 금액입니다. 카탈로그가 변경되면 요금을 다시 복사하거나 GET /v1/models에서 확인하세요.