Fehlerbehebung beim KI-Agenten
Beginnen Sie mit den integrierten Prüfungen. Innerhalb des Agenten:
/doctor/statusVon einer Shell aus:
champrep versionchamprep auth statuschamprep ai paths/doctor Überprüft die installierte Version, die Anmeldung, die Verbindung zu CHAMPREP, ob Ihr Tarif den Agenten umfasst, ob rg (ripgrep) und git sind verfügbar, Ihre Shell sowie die Farbe und Größe des Terminals. /status Zeigt Ihr Profil, Ihre Umgebung, Ihr Modell, Ihren Berechtigungsmodus sowie die Speicherorte lokaler Dateien an.
Fügen Sie keine APISchlüssel, Tokens oder ungeschwärzte Protokolle in eine Supportanfrage ein.
„Nicht verbunden: Führen Sie /login aus“ oder „Nicht angemeldet“
Abschnitt betitelt „„Nicht verbunden: Führen Sie /login aus“ oder „Nicht angemeldet““Der CLIverfügt über keine gültige Anmeldung für die aktive Umgebung.
- Führen Sie interaktiv folgenden Befehl aus:
/loginoderchamprep auth login. - Überprüfen Sie in CI, ob
CHAMPREP_TOKENist für den Auftrag festgelegt.
Headless-Läufe werden mit dem Code beendet 3 in diesem Fall.
Lokale Tools sind nicht zulässig
Abschnitt betitelt „Lokale Tools sind nicht zulässig“In der Meldung wird darauf hingewiesen, dass lokale Tools die ai:agent Gültigkeitsbereich. Die Anmeldeinformationen können verwenden, CHAMPREP AIjedoch nicht die lokalen Tools des Agenten.
- Melden Sie sich erneut an mit
champrep auth login. - Für einen SchlüsselAPI erstellen Sie einen Schlüssel, der Folgendes enthält:
ai:agentnach Namen. Ein Schlüssel mit nur übergeordneten Gültigkeitsbereichen reicht nicht aus. Siehe Anmelden.
„Der AgentCHAMPREPCLI ist nicht in Ihrem Plan enthalten“
Abschnitt betitelt „„Der AgentCHAMPREPCLI ist nicht in Ihrem Plan enthalten““Ihr Tarif umfasst den DienstCHAMPREPCLI nicht. Sonstiges champrep
Die Befehle funktionieren weiterhin. Führen Sie das Upgrade über den Link auf der Karte durch oder lesen Sie
Tarife und Limits.
Wenn die Meldung besagt, dass eine Funktion deaktiviert ist oder dass die Richtlinien Ihrer Organisation dies nicht zulassen, wird dies von einem Administrator Ihrer Organisation gesteuert.
Ratenbegrenzung oder keine Zugänge mehr
Abschnitt betitelt „Ratenbegrenzung oder keine Zugänge mehr“- „Sie senden Anfragen zu schnell“: ein Limit pro Minute. Der Agent führt bei kurzer Wartezeit automatisch einen erneuten Versuch durch. Warten Sie in Skripten die im Hinweis angegebene Zeit ab, bevor Sie einen erneuten Versuch starten.
- „Sie haben das gesamte Kontingent Ihres Tarifs für diesen Zeitraum aufgebraucht“: Erwerben Sie ein Add-on oder warten Sie bis zum nächsten Abrechnungszeitraum. Schleifen, Subagenten und CI-Läufe verbrauchen alle Turns; überprüfen Sie daher
/tasksfür alle noch laufenden Prozesse.
Das Modell kann keine Tools verwenden
Abschnitt betitelt „Das Modell kann keine Tools verwenden“Falls Sie ein Modell ausgewählt haben, das mit no toolskann der Agent zwar chatten, jedoch keine Dateien lesen, keine Befehle ausführen und keine DiensteCHAMPREP nutzen. Wechseln Sie mit /model auto
oder wählen Sie ein Modell aus, das mit tools in /models. Wenn ein Zug abgelehnt wird, weil dem Modell eine Funktion fehlt, wie beispielsweise die Bildeingabe, wählen Sie „Auto“ oder ein anderes Modell aus den angezeigten Optionen aus. Siehe Modelle.
Befehle, Regeln oder MCP-Server eines Projekts werden ignoriert
Abschnitt betitelt „Befehle, Regeln oder MCP-Server eines Projekts werden ignoriert“Inhalt in .champrep/ bleibt inaktiv, bis Sie das Repository als vertrauenswürdig markieren. Eine Warnung wie „allow-Regeln und defaultMode werden ignoriert, bis Sie diesem Projekt vertrauen“ bedeutet, dass die Projekteinstellungen zwar gefunden, aber nicht angewendet wurden.
/trust/trust approveAblehnungsregeln gelten immer. Siehe Repository-Vertrauen.
„no such host“ nach dem Upgrade von einer früheren Version
Abschnitt betitelt „„no such host“ nach dem Upgrade von einer früheren Version“In früheren Versionen konnte es vorkommen, dass eine nicht mehr verwendete Gateway-Adresse in
config.toml. Aktuelle Versionen ersetzen diese automatisch beim Laden der Konfiguration. Sollte der Fehler weiterhin bestehen:
champrep config envchamprep config pathStellen Sie sicher, dass die URLAPI der aktiven Umgebung die ist undCHAMPREPAPI Gateway keine benutzerdefinierte oder veraltete Adresse. Um zur integrierten Standardeinstellung zurückzukehren, entfernen Sie den Abschnitt dieser Umgebung aus config.toml; der CLIstellt die integrierte Umgebung bei der nächsten Ausführung wieder her, sobald Sie sich erneut darin anmelden.
Eine Datei ist „durch Geheimhaltungsrichtlinien gesperrt“
Abschnitt betitelt „Eine Datei ist „durch Geheimhaltungsrichtlinien gesperrt““Die Datei stimmt mit der integrierten Geheimnisliste oder einer Ihrer deny_read Regeln, sodass der Agent diese nicht lesen kann. Dies ist beabsichtigt. Kopieren Sie die nicht vertraulichen Teile in eine andere Datei oder verwenden Sie eine Beispieldatei wie .env.example. Siehe
Schutz von Geheimnissen.
Die Suche ist langsam
Abschnitt betitelt „Die Suche ist langsam“local_grep verwendet rg (ripgrep) verwenden, sofern dieser installiert ist; andernfalls wird auf eine langsamere integrierte Suche zurückgegriffen. Installieren Sie ripgrep und führen Sie den Befehl erneut aus /doctor.
Der interaktive Agent wird nicht in einem Skript gestartet
Abschnitt betitelt „Der interaktive Agent wird nicht in einem Skript gestartet“Der interaktive Modus erfordert ein Terminal. Verwenden Sie in Skripten und CI champrep ai -p. Siehe Einsatz im Headless-Modus und in der CI.
Wo befinden sich meine Einstellungen und Protokolle?
Abschnitt betitelt „Wo befinden sich meine Einstellungen und Protokolle?“champrep ai pathsDadurch werden alle lokalen Dateien und Ordner ausgegeben, die der Agent verwendet, einschließlich Einstellungen, redigierter Debug-Protokolle und Checkpoints. Führen Sie den Befehl mitCLI --debug für detailliertere Protokolle. Bei CLIProblemen, die nicht spezifisch für den Agenten sind, siehe
CLI Fehlerbehebung.