Pular para o conteúdo
Documentation

Solucione problemas do agente de IA

Comece com as verificações integradas. Dentro do agente:

/doctor
/status

A partir de um shell:

Terminal window
champrep version
champrep auth status
champrep ai paths

/doctor verifica a versão instalada, o login, a conexão com o CHAMPREP, se o seu plano inclui o agente, se rg (ripgrep) e git estão disponíveis, seu shell e a cor e o tamanho do terminal. /status mostra seu perfil, ambiente, modelo, modo de permissão e localizações de arquivos locais.

Não cole APIchaves, tokens ou logs não editados em uma solicitação de suporte.

“Não conectado: execute /login” ou “não conectado”

Seção intitulada ““Não conectado: execute /login” ou “não conectado””

O não CLIpossui um login válido para o ambiente ativo.

  • De forma interativa, execute /login ou champrep auth login.
  • Na CI, verifique se CHAMPREP_TOKEN está definido para a tarefa.

Execuções sem interface gráfica são encerradas com o código 3 neste caso.

A mensagem menciona que as ferramentas locais precisam do ai:agent escopo. A credencial pode utilizar CHAMPREP AImas não as ferramentas locais do agente.

  • Faça login novamente com champrep auth login.
  • Para uma chaveAPI, crie uma chave que inclua ai:agent por nome. Uma chave com apenas escopos mais amplos não é suficiente. Consulte Faça login.

“O agenteCHAMPREPCLI não está incluído no seu plano”

Seção intitulada ““O agenteCHAMPREPCLI não está incluído no seu plano””

Seu plano não inclui o serviçoCHAMPREPCLI. Outros champrep Os comandos continuam funcionando. Faça a atualização usando o link no cartão ou consulte Planos e limites.

Se a mensagem indicar que um recurso está desativado ou que a política da sua organização não o permite, isso é controlado por um administrador da sua organização.

Limite de taxa atingido ou sem turnos disponíveis

Seção intitulada “Limite de taxa atingido ou sem turnos disponíveis”
  • “O senhor está enviando solicitações muito rapidamente”: um limite por minuto. O agente tenta novamente automaticamente quando o tempo de espera é curto. Em scripts, aguarde o tempo indicado na dica antes de tentar novamente.
  • “Você já utilizou tudo o que seu plano inclui para este período”: adquira um complemento ou aguarde o próximo período de cobrança. Loops, subagentes e execuções de CI, todos utilizam turnos; portanto, verifique /tasks para verificar se há algo ainda em execução.

Caso tenha escolhido um modelo marcado no tools, o agente poderá conversar, mas não poderá ler arquivos, executar comandos ou utilizar serviçosCHAMPREP. Volte ao modo anterior com /model auto ou selecione um modelo marcado tools em /models. Se uma rodada for recusada porque o modelo não possui uma capacidade, como entrada de imagem, escolha “Auto” ou outro modelo entre as opções exibidas. Consulte Modelos.

Os comandos, regras ou servidores MCP de um projeto são ignorados

Seção intitulada “Os comandos, regras ou servidores MCP de um projeto são ignorados”

Conteúdo em .champrep/ permanece inativo até que o senhor confie no repositório. Um aviso como “as regras ‘allow’ e ‘defaultMode’ são ignoradas até que o senhor confie neste projeto” significa que as configurações do projeto foram encontradas, mas não aplicadas.

/trust
/trust approve

As regras de negação sempre se aplicam. Consulte Confiança do repositório.

“no such host” após a atualização a partir de uma versão anterior

Seção intitulada ““no such host” após a atualização a partir de uma versão anterior”

Versões anteriores podiam gravar um endereço de gateway que não está mais em uso no config.toml. As versões atuais substituem-no automaticamente ao carregar a configuração. Se o erro persistir:

Terminal window
champrep config env
champrep config path

Verifique se a URLAPI do ambiente ativo é a eCHAMPREPAPI Gateway não um endereço personalizado ou desatualizado. Para retornar ao padrão integrado, remova a seção desse ambiente do config.toml; ele restauraCLI o ambiente integrado na próxima vez em que for executado e você fizer login nele novamente.

Um arquivo está “bloqueado por política de segredos”

Seção intitulada “Um arquivo está “bloqueado por política de segredos””

O arquivo corresponde à lista de segredos integrada ou a uma de suas deny_read , de modo que o agente não possa lê-lo. Isso é intencional. Copie as partes não confidenciais para outro arquivo ou utilize um arquivo de exemplo, como .env.example. Consulte Proteção de segredos.

local_grep utiliza rg (ripgrep) quando ele estiver instalado; caso contrário, o sistema recorrerá a uma busca integrada mais lenta. Instale o ripgrep e execute novamente /doctor.

O modo interativo requer um terminal. Em scripts e CI, utilize champrep ai -p. Consulte Uso sem interface gráfica e em CI.

Terminal window
champrep ai paths

Isso exibe todos os arquivos e pastas locais que o agente utiliza, incluindo configurações, registros de depuração editados e pontos de verificação. Execute o comCLI --debug para obter registros mais detalhados. Para CLIproblemas que não sejam específicos do agente, consulte CLI resolução de problemas.