mini-SWE-agent

O mini-SWE-agent não tem variável de ambiente para URL base — o endpoint fica em model.model_kwargs.api_base em uma configuração YAML, que o mini encaminha diretamente para 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

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Instale e execute uma vez para que os caminhos sejam criados: pip install mini-swe-agent e, em seguida, mini. Na primeira execução, o mini mostra onde ficam seu .env e a configuração do agente, além de oferecer mini-extra config setup.
3. Coloque a chave onde o litellm irá procurá-la: export OPENAI_API_KEY=sk-kn-... ou salve-a com mini-extra config set OPENAI_API_KEY sk-kn-.... O mini observa que “As variáveis de ambiente têm precedência sobre as variáveis definidas no arquivo .env”, razão comum para uma chave recém-alterada parecer não ter mudado.
4. Salve o YAML acima como kunavo.yaml ao lado dos outros arquivos de configuração do agente e adicione o registro de preços da seção abaixo. Sem ele, a execução para com um erro de cálculo de custo, não por causa de uma resposta ruim.
5. Inicie com mini -c kunavo.yaml ou use mini -c kunavo.yaml -m openai/claude-haiku-4-5 para substituir o ID em uma única execução. O mini abre no modo confirm, no qual você aprova cada comando — uma boa opção padrão para a primeira execução em um endpoint novo.
6. Dê ao agente uma tarefa que realmente execute um comando, não uma saudação. A configuração padrão do mini v2 usa chamadas nativas de ferramentas e o prompt distribuído insiste que “Cada resposta precisa usar a ferramenta 'bash' pelo menos uma vez para executar comandos”. Portanto, uma interação real de ida e volta com uma ferramenta é o que confirma que a integração funciona. Se as chamadas de ferramenta retornarem vazias ou malformadas, o mini ainda inclui o caminho antigo de análise de texto: mini -c mini_textbased.yaml ou model_class: litellm_textbased no seu próprio arquivo.

Verificado em Guia de modelos locais do mini-SWE-agent em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em 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-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

Acompanhamento de custos, que é obrigatório neste caso

A configuração distribuída do mini inclui mini.yaml com cost_limit: 3. — um limite por execução, expresso em dólares. Esse limite é aplicado pela calculadora de custos do litellm, que calcula o preço de uma execução consultando o ID do modelo no registro. Como os IDs do Kunavo não constam nesse registro, o primeiro resultado que a maioria vê não é uma resposta ruim, mas um erro: a página de solução de problemas do próprio mini o mostra como Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Há duas soluções, e elas não são equivalentes. A opção global MSWEA_COST_TRACKING="ignore_errors" (ou cost_tracking: "ignore_errors" no arquivo) remove a proteção em vez de corrigi-la. O mini a descreve como “CUIDADO: isso pode levar a gastos sem controle!”. A outra solução é informar as tarifas ao litellm, como indica litellm_model_registry no bloco de configuração. As tarifas abaixo são as tarifas atuais do catálogo deste site, convertidas para o formato por token do 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. Os nomes dos modelos são comparados exatamente, incluindo maiúsculas e minúsculas. O exemplo do mini define a entrada usando o nome sem o prefixo do provedor — portanto, claude-sonnet-5 neste caso, embora a configuração indique openai/claude-sonnet-5.
2. litellm_provider precisa corresponder ao prefixo e a custom_llm_provider. O aviso do mini é explícito: “Se você usar custom_llm_provider ou tiver um provedor como prefixo do nome do modelo (por exemplo, openai/…), isso também precisa corresponder a litellm_provider na configuração!”
3. O caminho também pode ser definido em LITELLM_MODEL_REGISTRY_PATH em vez de na chave de configuração — útil para executores em lote, por exemplo, LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Essas tarifas servem como referência para o orçamento, não como fatura. O valor cobrado é o que consta no seu saldo do Kunavo. Se o catálogo mudar, copie as tarifas novamente ou consulte GET /v1/models.