Solucione problemas do agente de IA
Comece com as verificações integradas. Dentro do agente:
/doctor/statusA partir de um shell:
champrep versionchamprep auth statuschamprep 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
/loginouchamprep auth login. - Na CI, verifique se
CHAMPREP_TOKENestá definido para a tarefa.
Execuções sem interface gráfica são encerradas com o código 3 neste caso.
Ferramentas locais não são permitidas
Seção intitulada “Ferramentas locais não são permitidas”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:agentpor 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
/taskspara verificar se há algo ainda em execução.
O modelo não pode utilizar ferramentas
Seção intitulada “O modelo não pode utilizar ferramentas”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 approveAs 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:
champrep config envchamprep config pathVerifique 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.
A pesquisa está lenta
Seção intitulada “A pesquisa está lenta”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 agente interativo não é iniciado em um script
Seção intitulada “O agente interativo não é iniciado em um script”O modo interativo requer um terminal. Em scripts e CI, utilize champrep ai -p. Consulte Uso sem interface gráfica e em CI.
Onde estão minhas configurações e registros?
Seção intitulada “Onde estão minhas configurações e registros?”champrep ai pathsIsso 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.