Solución de problemas del agente de IA
Comience con las comprobaciones integradas. Dentro del agente:
/doctor/statusDesde un shell:
champrep versionchamprep auth statuschamprep ai paths/doctor Comprueba la versión instalada, el inicio de sesión, la conexión a CHAMPREP, si su plan incluye el agente, si rg (ripgrep) y git están disponibles, su shell y el color y tamaño de la terminal. /status Muestra su perfil, entorno, modelo, modo de permisos y ubicaciones de los archivos locales.
No pegue APIclaves, tokens ni registros sin censurar en una solicitud de asistencia.
«No conectado: ejecute /login» o «sin iniciar sesión»
Sección titulada ««No conectado: ejecute /login» o «sin iniciar sesión»»El no CLIdispone de un inicio de sesión válido para el entorno activo.
- De forma interactiva, ejecute
/loginochamprep auth login. - En CI, compruebe que
CHAMPREP_TOKENestá configurada para la tarea.
Las ejecuciones sin interfaz gráfica finalizan con el código 3 en este caso.
No se permiten herramientas locales
Sección titulada «No se permiten herramientas locales»El mensaje indica que las herramientas locales necesitan el ai:agent ámbito. La credencial puede utilizar CHAMPREP AIpero no las herramientas locales del agente.
- Vuelva a iniciar sesión con
champrep auth login. - Para una claveAPI, cree una clave que incluya
ai:agentpor su nombre. Una clave con solo ámbitos más amplios no es suficiente. Consulte Inicie sesión.
«El agenteCHAMPREPCLI no está incluido en su plan»
Sección titulada ««El agenteCHAMPREPCLI no está incluido en su plan»»Su plan no incluye el servicioCHAMPREPCLI. Otros champrep
Los comandos siguen funcionando. Actualice utilizando el enlace que aparece en la ficha, o consulte
Planes y límites.
Si el mensaje indica que una función está desactivada o que la política de su organización no la permite, esto lo controla un administrador de su organización.
Límite de frecuencia o sin turnos disponibles
Sección titulada «Límite de frecuencia o sin turnos disponibles»- «Está enviando solicitudes demasiado rápido»: un límite por minuto. El agente vuelve a intentarlo automáticamente cuando el tiempo de espera es breve. En los scripts, espere el tiempo indicado en la sugerencia antes de volver a intentarlo.
- «Ha agotado todo lo que incluye su plan para este periodo»: adquiera un complemento o espere al próximo periodo de facturación. Los bucles, los subagentes y las ejecuciones de CI consumen turnos, por lo que debe comprobar
/taskspara cualquier proceso que siga en ejecución.
El modelo no puede utilizar herramientas
Sección titulada «El modelo no puede utilizar herramientas»Si ha elegido un modelo marcado como no tools, el agente podrá chatear, pero no podrá leer archivos, ejecutar comandos ni utilizar serviciosCHAMPREP. Vuelva a cambiar con /model auto
o elija un modelo marcado tools en /models. Si se rechaza un turno porque el modelo carece de una capacidad, como la entrada de imágenes, seleccione «Auto» u otro modelo de entre las opciones mostradas. Consulte Modelos.
Se ignoran los comandos, las reglas o los servidores MCP de un proyecto
Sección titulada «Se ignoran los comandos, las reglas o los servidores MCP de un proyecto»Contenido en .champrep/ permanecerá inactivo hasta que confíe en el repositorio. Una advertencia del tipo «las reglas de permiso y el modo predeterminado (defaultMode) se ignoran hasta que confíe en este proyecto» significa que se han encontrado los ajustes del proyecto, pero no se han aplicado.
/trust/trust approveLas reglas de denegación se aplican siempre. Consulte Confianza del repositorio.
«no such host» tras actualizar desde una versión anterior
Sección titulada ««no such host» tras actualizar desde una versión anterior»Las versiones anteriores podían escribir una dirección de puerta de enlace que ya no se utiliza en
config.toml. Las versiones actuales la sustituyen automáticamente al cargar la configuración. Si el error persiste:
champrep config envchamprep config pathCompruebe que la URLAPI del entorno activo sea la de la API Gateway de CHAMPREP yCHAMPREPAPI Gateway no una dirección personalizada u obsoleta. Para volver a la configuración predeterminada integrada, elimine la sección de ese entorno del archivo config.toml; este CLIrestablece el entorno integrado la próxima vez que se ejecute y vuelva a iniciar sesión en él.
Un archivo está «bloqueado por una política de confidencialidad»
Sección titulada «Un archivo está «bloqueado por una política de confidencialidad»»El archivo coincide con la lista de secretos integrada o con uno de sus deny_read , de modo que el agente no pueda leerlo. Esto es intencionado. Copie las partes no confidenciales en otro archivo, o utilice un archivo de ejemplo como .env.example. Consulte
Protección de secretos.
La búsqueda es lenta
Sección titulada «La búsqueda es lenta»local_grep utiliza rg (ripgrep) cuando esté instalado; de lo contrario, se recurrirá a una búsqueda integrada más lenta. Instale ripgrep y vuelva a ejecutar /doctor.
El agente interactivo no se inicia en un script
Sección titulada «El agente interactivo no se inicia en un script»El modo interactivo requiere un terminal. En scripts y CI, utilice champrep ai -p. Consulte Uso sin interfaz gráfica y en CI.
¿Dónde se encuentran mi configuración y mis registros?
Sección titulada «¿Dónde se encuentran mi configuración y mis registros?»champrep ai pathsEsto muestra todos los archivos y carpetas locales que utiliza el agente, incluidos los ajustes, los registros de depuración censurados y los puntos de control. Ejecute el comando conCLI --debug para obtener registros más detallados. Para CLIproblemas que no sean específicos del agente, consulte
CLI solución de problemas.