Ir al contenido
Documentation

Solución de problemas del agente de IA

Comience con las comprobaciones integradas. Dentro del agente:

/doctor
/status

Desde un shell:

Ventana de terminal
champrep version
champrep auth status
champrep 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 /login o champrep auth login.
  • En CI, compruebe que CHAMPREP_TOKEN está configurada para la tarea.

Las ejecuciones sin interfaz gráfica finalizan con el código 3 en este caso.

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:agent por 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 /tasks para cualquier proceso que siga en ejecución.

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 approve

Las 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:

Ventana de terminal
champrep config env
champrep config path

Compruebe 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.

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?»
Ventana de terminal
champrep ai paths

Esto 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.