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 啟動，或使用 mini -c kunavo.yaml -m openai/claude-haiku-4-5 為單次執行覆寫 ID。mini 會以 confirm 模式開啟，每個命令都需由你核准；首次使用新端點時，這是很好的預設值。
6. 請交付一項確實會執行指令的任務，而非只打招呼。mini v2 預設使用原生工具呼叫，且隨附的提示詞要求「每則回覆都必須至少使用一次 'bash' 工具來執行指令」— 因此，實際完成一次工具往返才能確認兩者搭配正常。若工具呼叫回傳空內容或格式錯誤的內容，mini 仍附有舊版文字解析路徑：使用 mini -c mini_textbased.yaml，或在您自己的檔案中設定 model_class: litellm_textbased。

已於 2026年9月21日 根據 mini-SWE-agent 的本機模型指南 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 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-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

此處不可或缺的成本追蹤

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 使用的每 token 格式：

{
  "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 查閱。