Documentação

LLM

A seção LLM da interface Web atribui um provedor LLM a cada recurso de IA — classificação de terminal, mensagens de commit do Git, resolução de conflitos, polimento de texto de voz e tradução. Os provedores mesmos são addons do tipo LLM gerenciados na seção Addons.

Provedores são addons

Provedores LLM vivem no grupo LLM da seção Addons:

  • um provedor OpenAI Compatible LLM vem embutido; provedores personalizados podem ser enviados como zip (botão Upload). O manifesto do addon declara os campos de configuração (chave de API, URL base, modelo, …) que a interface Web transforma num formulário;
  • um provedor só aparece nos seletores de recursos enquanto seu addon está habilitado — ligue-o primeiro na seção Addons;
  • o botão lápis num cartão de addon edita sua fonte; um addon embutido que você modificou pode ser revertido com Reset.
A seção Addons — provedores LLM são addons que podem ser habilitados, editados ou enviados

Configuração por recurso

Cada cartão de recurso na seção LLM tem sua própria alternância de habilitação e sua própria escolha de provedor, para que trabalhos diferentes usem modelos diferentes:

  • Terminal Classification — classifica o estado do terminal quando os padrões embutidos não bastam. Max Consecutive Failures desabilita o LLM para a sessão após essa quantidade de falhas consecutivas (mínimo 3);
  • Git Commit Messages — gera mensagens de commit a partir das mudanças staged;
  • Git Conflict Resolve — resolve conflitos de rebase/mesclagem hunk a hunk;
  • Voice Text Polish — pole transcrições de entrada de voz antes do envio;
  • Translation — traduz texto para o idioma alvo escolhido.

Expanda um cartão para escolher seu Provider e preencher os campos do provedor. A configuração é salva mesmo com o recurso desabilitado e só faz efeito uma vez habilitado. Quando vários recursos usam o mesmo addon de provedor, os botões copiar/colar ao lado de Provider Configuration permitem clonar seus valores de campos entre eles (veja abaixo).

Os recursos de Terminal e Git oferecem um idioma de saída com opção Auto (o modelo decide); a tradução usa uma lista explícita de alvos English/简体中文.

A seção LLM — cada recurso escolhe seu próprio provedor e credenciais

Copiar/colar entre recursos

Cada recurso guarda sua própria cópia dos campos do provedor, então usar um provedor em vários recursos normalmente significa reescrever a mesma URL base, chave de API e modelo em cada cartão. O cabeçalho de Provider Configuration tem dois botões pequenos que eliminam a repetição:

  • Copiar — copia os valores de campos atualmente mostrados neste cartão, junto com o addon de provedor ao qual pertencem;
  • Colar — aparece num cartão somente quando o provedor selecionado nele é o mesmo addon da configuração copiada; ao pressioná-lo, preenche os campos do cartão com os valores copiados.

Para compartilhar um endpoint entre, por exemplo, as mensagens de commit do Git e a tradução: escolha o provedor e preencha seus campos no primeiro cartão, pressione Copiar, abra o outro cartão (com o mesmo provedor selecionado) e pressione Colar. Os valores colados são armazenados na configuração própria daquele recurso, como qualquer outra edição de campo, e são salvos com ela. A área de transferência é só da página — ela é limpa ao sair da seção LLM.

Botões copiar e colar no cabeçalho de Provider Configuration — duplicar os campos de um provedor entre recursos que usam o mesmo addon

O provedor compatível com OpenAI

O provedor embutido funciona com qualquer API de chat compatível com OpenAI. Campos-chave:

  • Base URL / API Key / Model — endpoint, credenciais, nome do modelo;
  • Extra Body — um objeto JSON mesclado em cada corpo de requisição, para parâmetros específicos do modelo;
  • Max Input Tokens / Max Output Tokens — orçamento de prompt e teto de conclusão;
  • Timeout — tempo limite por requisição em segundos; aumente para modelos locais lentos.

Modelos recomendados

Esses trabalhos de IA são prompts pequenos e sensíveis à latência — um modelo rápido «na medida» vence um modelo grande de raciocínio:

  • Local: Qwen3.5 9B — o ponto ideal para geração de mensagens de commit do Git, classificação de terminal, tradução e polimento de voz. Sirva-o com um endpoint compatível com OpenAI (Ollama, vLLM, llama.cpp) e aponte Base URL para ele;
  • API: DeepSeek V4 Flash (deepseek-v4-flash) — rápido o bastante para uso interativo e capaz de cobrir todos os recursos acima.

O modo de pensamento adiciona segundos de latência e raramente ajuda nessas tarefas curtas — desligue-o no Extra Body para uma experiência melhor, p. ex. {"enable_thinking": false} para Qwen ou {"thinking": {"type": "disabled"}} para DeepSeek (a chave exata depende da sua pilha de servir; o JSON é mesclado literalmente no corpo da requisição).