Zum Inhalt springen
Documentation

Fehlerbehebung beim KI-Agenten

Beginnen Sie mit den integrierten Prüfungen. Innerhalb des Agenten:

/doctor
/status

Von einer Shell aus:

Terminal-Fenster
champrep version
champrep auth status
champrep 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: /login oder champrep auth login.
  • Überprüfen Sie in CI, ob CHAMPREP_TOKEN ist für den Auftrag festgelegt.

Headless-Läufe werden mit dem Code beendet 3 in diesem Fall.

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:agent nach 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.

  • „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 /tasks für alle noch laufenden Prozesse.

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 approve

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

Terminal-Fenster
champrep config env
champrep config path

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

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?“
Terminal-Fenster
champrep ai paths

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