mini-SWE-agent

mini-SWE-agent'de temel URL ortam değişkeni yoktur — uç nokta YAML yapılandırmasında model.model_kwargs.api_base altına girer; mini bunu doğrudan litellm.completion'a iletir.

# 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

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Yolların oluşması için bir kez kurup çalıştırın: pip install mini-swe-agent, ardından mini. İlk çalıştırma, .env dosyasının ve aracı yapılandırmasının nerede olduğunu gösterir ve mini-extra config setup komutunu sunar.
3. Anahtarı litellm'in arayacağı yere koyun: export OPENAI_API_KEY=sk-kn-... komutunu kullanın veya mini-extra config set OPENAI_API_KEY sk-kn-... ile kalıcı olarak kaydedin. mini, “Ortam değişkenleri, .env dosyasında ayarlanan değişkenlere göre önceliklidir” diye belirtir. Yeni değiştirdiğiniz anahtarın değişmemiş gibi görünmesinin yaygın nedeni budur.
4. Yukarıdaki YAML'ı diğer aracı yapılandırmalarınızın yanına kunavo.yaml olarak kaydedin ve aşağıdaki bölümden fiyat kayıt defterini ekleyin. Bu kayıt olmadan çalışma kötü bir yanıt vermek yerine maliyet hesaplama hatasıyla durur.
5. mini -c kunavo.yaml ile başlatın veya tek bir çalıştırmada kimliği değiştirmek için mini -c kunavo.yaml -m openai/claude-haiku-4-5'i kullanın. mini, her komutu onayladığınız confirm kipinde açılır; yeni bir uç noktaya ilk kez bağlanırken bu iyi bir varsayılandır.
6. Selamlama yerine gerçekten komut çalıştıran bir görev verin. mini'nin v2 varsayılanı modele yerleşik araç çağrısıdır ve dağıtımla gelen istemi “Her yanıtın komutları çalıştırmak için en az bir kez 'bash' aracını kullanması gerekir” diye belirtir. Bu nedenle eşleşmenin çalıştığını anlamak için gerçek bir araç gidiş dönüşü gerekir. Araç çağrıları boş veya hatalı biçimlendirilmiş dönerse mini'de eski metin ayrıştırma yolu da bulunur: mini -c mini_textbased.yaml veya kendi dosyanızda model_class: litellm_textbased.

mini-SWE-agent'in yerel modeller kılavuzu ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar mini-SWE-agent içinde çalışır.

# 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-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Burada isteğe bağlı olmayan maliyet takibi

mini'nin dağıtımla gelen mini.yaml dosyası cost_limit: 3. içerir; bu, dolar cinsinden çalışma başına bir üst sınırdır. Bu sınır, litellm'in maliyet hesaplayıcısı tarafından uygulanır; hesaplayıcı bir çalışmanın fiyatını, model kimliğini kayıt defterinde arayarak belirler. Kunavo'nun kimlikleri bu kayıt defterinde bulunmadığından, çoğu kişinin ilk karşılaştığı şey kötü bir yanıt değil, bir hatadır: mini'nin kendi sorun giderme sayfasında bu hata Exception: This model isn't mapped yet. model=…, custom_llm_provider=… olarak gösterilir.

Bu durumdan çıkmanın iki yolu vardır ve bunlar birbirine eşdeğer değildir. Genel anahtar MSWEA_COST_TRACKING="ignore_errors" (veya dosyadaki cost_tracking: "ignore_errors"), sorunu düzeltmek yerine korumayı kaldırır; mini bunu “DİKKAT: Bu, denetlenmeyen harcamalara yol açabilir!” diye tanımlar. Diğer yol, litellm'e ücretleri bildirmektir; kurulum bloğundaki litellm_model_registry bunun içindir. Aşağıdaki ücretler bu sitenin güncel katalog ücretleridir ve litellm'in token başına biçimine dönüştürülmüştür:

{
  "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. Model adları tam eşleşmeyle ve büyük/küçük harfe duyarlı olarak karşılaştırılır; ayrıca mini'nin örnek yapılandırmasında kayıt girdisinin anahtarı, sağlayıcı öneki olmadan yazılan addır. Dolayısıyla burada claude-sonnet-5 kullanılır; yapılandırmada openai/claude-sonnet-5 yazsa da.
2. litellm_provider, önekle ve custom_llm_provider ile eşleşmelidir. mini'nin uyarısı açıktır: “custom_llm_provider ayarını kullanıyorsanız veya model adında bir sağlayıcı öneki varsa (ör. openai/…), bunun da yapılandırmadaki litellm_provider ile eşleşmesi gerekir!”
3. Yol, yapılandırma anahtarı yerine LITELLM_MODEL_REGISTRY_PATH ortam değişkeninden de alınabilir. Bu, toplu iş çalıştırıcıları için kullanışlıdır; örneğin LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Bu ücretler bütçeleme girdisidir, fatura değildir. Gerçekte tahsil edilen tutar Kunavo bakiyenizde kaydedilendir; katalog değişirse ücretleri yeniden kopyalayın veya GET /v1/models yanıtından alın.