mini-SWE-agent

mini-SWE-agent không có biến môi trường base URL — endpoint nằm trong model.model_kwargs.api_base của cấu hình YAML, rồi mini chuyển thẳng tới 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

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Cài đặt và chạy một lần để tạo các đường dẫn cần thiết: pip install mini-swe-agent, rồi mini. Lần chạy đầu tiên sẽ cho biết vị trí của .env và cấu hình agent, đồng thời đề xuất mini-extra config setup.
3. Đặt khóa ở nơi litellm sẽ tìm: export OPENAI_API_KEY=sk-kn-..., hoặc lưu lâu dài bằng mini-extra config set OPENAI_API_KEY sk-kn-.... mini lưu ý rằng “Biến môi trường được ưu tiên hơn các biến đặt trong tệp .env”, đây thường là lý do khiến khóa bạn vừa thay đổi dường như chưa được cập nhật.
4. Lưu YAML ở trên thành kunavo.yaml cùng thư mục với các cấu hình agent khác, rồi thêm registry giá trong phần bên dưới — nếu thiếu registry, lần chạy sẽ dừng vì lỗi tính chi phí chứ không phải vì câu trả lời kém.
5. Khởi chạy bằng mini -c kunavo.yaml, hoặc dùng mini -c kunavo.yaml -m openai/claude-haiku-4-5 để ghi đè id cho một lần chạy. mini mở ở chế độ confirm, trong đó bạn phê duyệt từng lệnh — đây là mặc định phù hợp cho lần đầu chạy với một endpoint mới.
6. Giao cho mini một tác vụ thực sự chạy lệnh, không phải lời chào. Mặc định của mini v2 là tính năng gọi công cụ native, và prompt đi kèm yêu cầu rằng “Mỗi phản hồi phải dùng công cụ 'bash' ít nhất một lần để thực thi lệnh” — vì vậy, một vòng gọi công cụ thực sự sẽ cho biết cấu hình kết hợp có hoạt động hay không. Nếu các lệnh gọi công cụ trả về rỗng hoặc sai định dạng, mini vẫn cung cấp đường dẫn phân tích văn bản cũ hơn: mini -c mini_textbased.yaml, hoặc model_class: litellm_textbased trong tệp của bạn.

Đã kiểm tra đối chiếu với Hướng dẫn về mô hình cục bộ của mini-SWE-agent vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong 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-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Theo dõi chi phí là điều bắt buộc ở đây

Bản phát hành mini có mini.yaml đi kèm, trong đó cost_limit: 3. là mức trần chi phí cho mỗi lần chạy. Mức trần này được áp dụng bằng bộ tính chi phí của litellm, vốn định giá một lần chạy bằng cách tra model id trong registry. Các id của Kunavo không có trong registry đó, nên điều đầu tiên đa số người dùng gặp phải không phải là câu trả lời kém mà là lỗi: trang khắc phục sự cố của mini hiển thị lỗi này dưới dạng Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Có hai cách xử lý và chúng không tương đương nhau. Công tắc toàn cục MSWEA_COST_TRACKING="ignore_errors" (hoặc cost_tracking: "ignore_errors" trong tệp) gỡ bỏ cơ chế kiểm soát thay vì sửa lỗi, và mini ghi rõ: “CẨN TRỌNG: Điều này có thể dẫn đến chi tiêu không được kiểm soát!” Cách còn lại là khai báo mức giá cho litellm, như phần litellm_model_registry trong khối thiết lập hướng dẫn. Các mức giá bên dưới là giá hiện hành trong danh mục của trang này, được chuyển đổi sang định dạng tính theo token của 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. Tên mô hình được đối chiếu chính xác, có phân biệt chữ hoa chữ thường. Ví dụ của mini dùng tên không có tiền tố nhà cung cấp làm khóa cho mục — tức là claude-sonnet-5 ở đây, dù cấu hình ghi openai/claude-sonnet-5.
2. litellm_provider phải khớp với tiền tố và với custom_llm_provider. Cảnh báo của mini ghi rõ: “Nếu bạn dùng custom_llm_provider hoặc có tiền tố nhà cung cấp trong tên mô hình (ví dụ: openai/…), thì giá trị này cũng phải khớp với litellm_provider trong cấu hình!”
3. Đường dẫn cũng có thể được lấy từ LITELLM_MODEL_REGISTRY_PATH thay vì khóa cấu hình — hữu ích cho các trình chạy theo lô, ví dụ LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Các mức giá này là dữ liệu đầu vào để lập ngân sách, không phải hóa đơn. Khoản thực tế bị tính phí là khoản được ghi nhận trong số dư Kunavo của bạn. Hãy sao chép lại mức giá nếu danh mục thay đổi hoặc lấy giá từ GET /v1/models.