Verwaltete Einstellungen, Debug und Verlauf
Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session gebunden sind)
Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter RPC.
debug (experimental)
Mit debug()->collectLogs() können Sie Event-Logs, Prozess-Logs und Shell-Logs einer Session in einem .tgz-Archiv oder einem Verzeichnis sammeln. Vertrauliche Informationen in den Logs werden standardmäßig geschwärzt. Mit additionalEntries können Sie weitere Dateien oder Verzeichnisse hinzufügen, und für redaction können Sie plain-text, events-jsonl oder none angeben. Bei none erfolgt keine Schwärzung; achten Sie daher auf die hinzugefügten Inhalte.
Mit DebugCollectLogsDestination::directory('/tmp/copilot-debug') können Sie in ein Staging-Verzeichnis ausgeben. Mit include geben Sie einzeln an, welche Logs und Referenzpfade gesammelt werden, und anhand von entries und skippedEntries im Ergebnis prüfen Sie die gesammelten Inhalte. Die Pfade für Ziel und zusätzliche Einträge sind Pfade auf der CLI-Serverseite. In der Standardkonfiguration, in der die CLI über stdio gestartet wird, ist dies derselbe Host wie die App; wenn Sie sich jedoch per TCP mit einem CLI-Server auf einem anderen Host verbinden, geben Sie Pfade auf der Serverseite an, nicht auf dem aufrufenden Rechner.
contentExclusion (experimental)
Sie können prüfen, ob lokale absolute Pfade im Arbeitsverzeichnis der Session einer Content-Exclusion-Richtlinie unterliegen. Rufen Sie dies auf, bevor Sie Dateiinhalte lesen oder anhängen.
checkPaths() akzeptiert nur absolute Pfade, und die Pfade müssen im Arbeitsverzeichnis der Session liegen. checks wird in derselben Reihenfolge wie die Eingabe zurückgegeben; doppelte Pfade bleiben erhalten. Wenn ein Pfad, ein Dateisystem oder die Richtlinienauswertung nicht unterstützt wird bzw. nicht verfügbar ist, werden available: false und leere checks zurückgegeben. In diesem Fall gibt isExcluded() immer true zurück; behandeln Sie daher alle Pfade als ausgeschlossen. Auch bei available: true werden Pfade, die nicht im Ergebnis enthalten sind, sicherheitshalber als ausgeschlossen bewertet.
Zuletzt geändert am 19. November 2026