mini-SWE-agent

mini-SWE-agent tidak memiliki variabel lingkungan base-URL — endpoint ditempatkan di model.model_kwargs.api_base dalam konfigurasi YAML, yang langsung diteruskan mini ke 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

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Instal lalu jalankan sekali agar jalurnya tersedia: pip install mini-swe-agent, lalu mini. Proses pertama akan menampilkan lokasi .env dan konfigurasi agen, serta menawarkan mini-extra config setup.
3. Simpan kunci di lokasi yang akan dicari litellm: export OPENAI_API_KEY=sk-kn-..., atau simpan secara persisten dengan mini-extra config set OPENAI_API_KEY sk-kn-.... mini mencatat bahwa “Variabel lingkungan lebih diutamakan daripada variabel yang ditetapkan dalam berkas .env”, yang biasanya menjelaskan mengapa kunci yang baru saja Anda ubah tampak tidak berubah.
4. Simpan YAML di atas sebagai kunavo.yaml bersama konfigurasi agen lainnya, lalu tambahkan registri harga dari bagian di bawah — tanpanya, proses akan berhenti karena kesalahan penghitungan biaya, bukan karena jawabannya buruk.
5. Jalankan dengan mini -c kunavo.yaml, atau gunakan mini -c kunavo.yaml -m openai/claude-haiku-4-5 untuk mengganti ID pada satu kali proses. mini terbuka dalam mode confirm, yang meminta persetujuan Anda untuk setiap perintah — pilihan awal yang baik saat mencoba endpoint baru.
6. Berikan tugas yang benar-benar menjalankan perintah, bukan sekadar sapaan. Setelan default mini v2 adalah pemanggilan alat native dan prompt bawaan menyatakan bahwa “Setiap respons harus menggunakan alat 'bash' setidaknya sekali untuk menjalankan perintah” — karena itu, satu interaksi bolak-balik alat yang sesungguhnya akan memastikan pasangan konfigurasi ini berfungsi. Jika panggilan alat menghasilkan respons kosong atau tidak valid, mini masih menyediakan jalur penguraian teks yang lebih lama: mini -c mini_textbased.yaml, atau model_class: litellm_textbased dalam berkas Anda sendiri.

Diperiksa terhadap Panduan model lokal mini-SWE-agent pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di 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-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Pelacakan biaya yang wajib digunakan di sini

Konfigurasi bawaan mini menyertakan mini.yaml yang memuat cost_limit: 3. — batas maksimum biaya per proses — dan batas tersebut diterapkan oleh kalkulator biaya litellm, yang menentukan harga proses dengan mencari ID model di registrinya. ID Kunavo tidak ada di registri tersebut, jadi hal pertama yang dilihat kebanyakan orang bukanlah jawaban yang buruk, melainkan sebuah kesalahan: halaman pemecahan masalah mini menampilkannya sebagai Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Ada dua cara untuk mengatasinya, dan keduanya tidak setara. Sakelar global MSWEA_COST_TRACKING="ignore_errors" (atau cost_tracking: "ignore_errors" dalam berkas) menghapus pengaman, bukan memperbaiki masalahnya, dan mini memberi label “HATI-HATI: Ini dapat menyebabkan pengeluaran yang tidak terkelola!” Cara lainnya adalah memberi tahu litellm tarifnya, seperti yang ditunjukkan oleh litellm_model_registry di blok penyiapan. Tarif di bawah ini adalah tarif katalog situs ini yang berlaku saat ini, dikonversi ke format per token 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. Nama model dicocokkan secara persis dan peka huruf besar-kecil. Contoh mini menetapkan entri menggunakan nama tanpa awalan penyedianya — jadi di sini, claude-sonnet-5, meskipun konfigurasinya menyatakan openai/claude-sonnet-5.
2. litellm_provider harus sesuai dengan awalan dan custom_llm_provider. Peringatan mini menyatakannya secara eksplisit: “Jika Anda menggunakan custom_llm_provider atau menambahkan awalan penyedia pada nama model (misalnya, openai/…), maka ini juga harus cocok dengan litellm_provider di konfigurasi!”
3. Jalurnya juga dapat berasal dari LITELLM_MODEL_REGISTRY_PATH, bukan dari kunci konfigurasi — berguna untuk pelaksana batch, misalnya LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Tarif ini merupakan masukan anggaran, bukan tagihan. Biaya yang benar-benar Anda kenakan tercatat di saldo Kunavo; salin ulang tarifnya jika katalog berubah, atau lihat tarifnya di GET /v1/models.