Aller au contenu
Documentation

Dépannage de l’agent IA

Commencez par les vérifications intégrées. À l’intérieur de l’agent :

/doctor
/status

Depuis un shell :

Fenêtre de terminal
champrep version
champrep auth status
champrep ai paths

/doctor vérifie la version installée, la connexion, la connexion à CHAMPREP, si votre forfait inclut l’agent, si rg (ripgrep) et git sont disponibles, votre shell, ainsi que la couleur et la taille de votre terminal. /status affiche votre profil, votre environnement, votre modèle, votre mode d’autorisation et l’emplacement de vos fichiers locaux.

Ne collez pas de clésAPI, de jetons ou de journaux non expurgés dans une demande d’assistance.

« Non connecté : exécutez /login » ou « non connecté »

Section intitulée « « Non connecté : exécutez /login » ou « non connecté » »

L’environnement n’aCLI pas d’identification valide pour l’environnement actif.

  • En mode interactif, exécutez /login ou champrep auth login.
  • En CI, vérifiez que CHAMPREP_TOKEN est défini pour la tâche.

Les exécutions en mode « headless » se terminent avec le code 3 dans ce cas.

Le message indique que les outils locaux ont besoin de la ai:agent portée. L’ identifiant peut utiliser CHAMPREP AImais pas les outils locaux de l’agent.

  • Connectez-vous à nouveau avec champrep auth login.
  • Pour une cléAPI , créez une clé qui inclut ai:agent par son nom. Une clé comportant uniquement des portées plus larges ne suffit pas. Voir Connectez-vous.

« L’agentCHAMPREPCLI n’est pas inclus dans votre forfait »

Section intitulée « « L’agentCHAMPREPCLI n’est pas inclus dans votre forfait » »

Votre forfait ne comprend pas le serviceCHAMPREPCLI . Autres champrep Les commandes continuent de fonctionner. Effectuez la mise à jour à l’aide du lien figurant sur la fiche, ou consultez Formules et limites.

Si le message indique qu’une fonctionnalité est désactivée ou que la politique de votre organisation ne l’autorise pas, c’est un administrateur de votre organisation qui en a le contrôle.

  • « Vous envoyez des requêtes trop rapidement »: une limite par minute. L’agent effectue automatiquement une nouvelle tentative lorsque le délai d’attente est court. Dans les scripts, veuillez patienter pendant la durée indiquée dans la remarque avant de réessayer.
  • « Vous avez utilisé l’intégralité des ressources incluses dans votre forfait pour cette période »: achetez un module complémentaire ou attendez la prochaine période de facturation. Les boucles, les sous-agents et les exécutions CI utilisent tous des tours ; vérifiez donc /tasks pour tout ce qui est encore en cours d’exécution.

Si vous avez choisi un modèle marqué no tools, l’agent peut discuter mais ne peut pas lire de fichiers, exécuter de commandes ni utiliser de servicesCHAMPREP. Revenez à l’état initial avec /model auto ou sélectionnez un modèle portant la mention tools dans /models. Si un tour est refusé parce que le modèle ne dispose pas d’une capacité nécessaire, telle que la saisie d’images, choisissez « Auto » ou un autre modèle parmi les options affichées. Voir Modèles.

Les commandes, règles ou serveurs MCP d’un projet sont ignorés

Section intitulée « Les commandes, règles ou serveurs MCP d’un projet sont ignorés »

Contenu dans .champrep/ reste inactif tant que vous n’avez pas validé le référentiel. Un avertissement tel que « les règles allow et defaultMode sont ignorées tant que vous n’avez pas validé ce projet » signifie que les paramètres du projet ont été détectés mais n’ont pas été appliqués.

/trust
/trust approve

Les règles de refus s’appliquent toujours. Voir Confiance du référentiel.

« no such host » après la mise à niveau à partir d’une version antérieure

Section intitulée « « no such host » après la mise à niveau à partir d’une version antérieure »

Les premières versions pouvaient enregistrer une adresse de passerelle qui n’est plus utilisée dans config.toml. Les versions actuelles la remplacent automatiquement lors du chargement de la configuration. Si l’erreur persiste :

Fenêtre de terminal
champrep config env
champrep config path

Vérifiez que l’URLAPI de l’environnement actif correspond bien à etCHAMPREPAPI Gateway non à une adresse personnalisée ou obsolète. Pour revenir à la valeur par défaut intégrée, supprimez la section relative à cet environnement du fichier config.toml; celui-ci CLIrestaure l’environnement intégré lors de sa prochaine exécution, lorsque vous vous y reconnectez.

Un fichier est « bloqué par une politique de confidentialité »

Section intitulée « Un fichier est « bloqué par une politique de confidentialité » »

Le fichier correspond à la liste secrète intégrée ou à l’une de vos deny_read règles, de sorte que l’agent ne puisse pas le lire. Ceci est intentionnel. Copiez les parties non confidentielles dans un autre fichier, ou utilisez un fichier d’exemple tel que .env.example. Voir Protection des secrets.

local_grep utilise rg (ripgrep) lorsqu’il est installé ; dans le cas contraire, le système se rabat sur une fonction de recherche intégrée plus lente. Installez ripgrep et relancez /doctor.

L’agent interactif ne démarre pas dans un script

Section intitulée « L’agent interactif ne démarre pas dans un script »

Le mode interactif nécessite un terminal. Dans les scripts et en intégration continue (CI), utilisez champrep ai -p. Voir Utilisation en mode « headless » et en CI.

Fenêtre de terminal
champrep ai paths

Cela affiche tous les fichiers et dossiers locaux utilisés par l’agent, y compris les paramètres, les journaux de débogage expurgés et les points de contrôle. Exécutez la commande avecCLI --debug pour obtenir des journaux plus détaillés. Pour les problèmesCLI qui ne sont pas spécifiques à l’agent, consultez CLI Dépannage.