Pular para o conteúdo
Documentation

Escolha modelos para o agente de IA

O agente opera por meio de ferramentas; portanto, o modelo utilizado por ele deve oferecer suporte ao uso dessas ferramentas. Por padrão, a plataforma seleciona um modelo adequado para o(a) senhor(a).

Com Automático, encaminhaCHAMPREP cada turno e cada tarefa do subagente para um modelo que atenda à solicitação e ofereça suporte ao que o turno necessita, escolhido dentre os modelos disponíveis para você. Essa é a opção recomendada, e a linha de status exibe Auto.

Retorne ao modo “Auto” a qualquer momento com /model auto ou selecionando Automático (recomendado) em /models.

/models

O seletor lista:

  • Automático (recomendado).
  • Modelos de plataforma, agrupados por provedor. Cada um exibe ícones de recursos: tools ou no tools, vision, e long context. Os modelos marcados com 🔒 não estão incluídos no seu plano e não podem ser selecionados.
  • Seus modelos: modelos que você registrou com sua própria chave de provedor.
  • Registrar um novo modelo.

Digite para filtrar e, em seguida, pressione Enter. Você também pode alternar diretamente com /model NAME ou inicie uma sessão com champrep ai --model NAME, onde NAME é um ID de modelo da plataforma, o nome de um modelo que o(a) senhor(a) registrou ou auto.

Sua escolha é lembrada para o projeto atual em .champrep/settings.local.json. Apenas identificadores de modelos são armazenados ali, nunca chaves. Os subagentes utilizam a mesma seleção.

Em um script, liste os modelos disponíveis para você com:

Terminal window
champrep ai models ls

Quando um modelo não consegue realizar uma ação

Seção intitulada “Quando um modelo não consegue realizar uma ação”
  • Não há suporte por meio de ferramentas. Se o senhor escolher um modelo marcado no tools, o agente avisa você primeiro: sem ferramentas, ele não pode ler ou editar arquivos, executar comandos ou usar CHAMPREP serviços. Você pode alternar para “Auto”, manter o modelo para bate-papo simples ou escolher outro.
  • Recurso ausente. Se uma rodada precisar de algo que o modelo escolhido não possua, como entrada de imagem ou uma janela de contexto maior, a rodada é recusada e nada é alterado. O agente oferece a opção de alternar para o modo “Auto” e reenviar o prompt, ou de escolher outro modelo. Ele nunca altera a escolha por você.

É possível registrar um modelo que utilize sua própria API chave de um provedor compatível. As solicitações com esse modelo são faturadas pelo seu provedor em sua própria conta e não utilizam seus CHAMPREP AI créditos.

Os provedores compatíveis são Anthropic, OpenAI, GoogleGemini, xAI, DeepSeek e Moonshot Kimi. O registro mostra os modelos disponíveis para cada provedor.

/model register
  1. Cole a chaveAPI do seu provedor no campo mascarado.
  2. Confirme o provedor. Ele é detectado a partir da chave, quando possível; caso contrário, você o seleciona.
  3. Escolha o modelo e atribua-lhe um nome, por exemplo My Claude.

A chave é verificada com o provedor antes de ser salva. Selecione o novo modelo em /models, onde ela é identificada como sua chave, ou com champrep ai --model "My Claude".

A chave é lida a partir de um prompt oculto ou da entrada padrão com --key-stdin. Ela nunca é aceita como um sinalizador ou variável de ambiente, portanto, não pode constar no histórico do shell nem nas listas de processos.

Terminal window
champrep ai models register --name "My Claude"
Terminal window
pass show anthropic | champrep ai models register --name "My Claude" --key-stdin

Sinalizadores opcionais: --provider (caso contrário, detectada a partir da chave) e --model (caso contrário, o primeiro modelo compatível com a ferramenta do provedor).

  • Ela é inserida apenas em um campo mascarado ou a partir da entrada padrão, e nunca é exibida novamente, impressa ou gravada no histórico de transcrição, no histórico de prompts ou nos logs.
  • Ela é enviada uma única vez para a sua CHAMPREP AIconta e armazenada lá, e não em sua máquina. Posteriormente, apenas uma impressão digital mascarada é exibida.
  • Ela é usada apenas para suas próprias solicitações com esse modelo.
  • Chaves coladas em um prompt normal são bloqueadas e nunca enviadas ao modelo.

/model remove "My Claude"
Terminal window
champrep ai models rm "My Claude"

A remoção de um modelo exclui sua chave da sua CHAMPREP AIconta. Você também pode gerenciar suas chaves nas suas configuraçõesCHAMPREP AI na web.

  • /effort low|medium|high|max|off define o nível de esforço de raciocínio para modelos que oferecem suporte a isso.
  • /context Mostra qual a parte do contexto do modelo que a conversa utiliza.
  • /compact [focus] resume a conversa para o contexto livre, mantendo o que você nomear.