> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Verwaltete Einstellungen, Debug und Verlauf

> Mit SessionRpc des Laravel Copilot SDK arbeiten Sie mit verwalteten Einstellungen, Debug, contentExclusion und dem Verlauf.

## 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](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md).

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

```php theme={null}
use Revolution\Copilot\Enums\DebugCollectLogsEntryKind;
use Revolution\Copilot\Enums\DebugCollectLogsRedaction;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsDestination;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsEntry;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsRequest;

$result = $session->rpc()->debug()->collectLogs(new DebugCollectLogsRequest(
    destination: DebugCollectLogsDestination::archive('/tmp/copilot-debug.tgz', noOverwrite: true),
    additionalEntries: [
        new DebugCollectLogsEntry(
            kind: DebugCollectLogsEntryKind::File,
            path: '/var/log/my-app.log',
            bundlePath: 'application/my-app.log',
            redaction: DebugCollectLogsRedaction::PlainText,
            required: true,
        ),
    ],
));
```

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.

```php theme={null}
use Revolution\Copilot\Types\Rpc\ContentExclusionCheckPathsRequest;

$result = $session->rpc()->contentExclusion()->checkPaths(
    new ContentExclusionCheckPathsRequest(paths: [
        '/workspace/private.txt',
        '/workspace/public.txt',
    ]),
);

if ($result->isExcluded('/workspace/private.txt')) {
    // Ausgeschlossen oder nicht sicher bestimmbar.
}
```

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

```php theme={null}
// managedSettings (experimental: verwaltete Einstellungen der Session)
// Aktuell gehaltenen Snapshot abrufen (wartet nicht auf die Anwendung und ruft nicht neu ab)
$snapshot = $session->rpc()->managedSettings()->getCurrentSnapshot(); // ManagedSettingsResolvedData|null
// Warten, bis die aktuelle Richtlinie angewendet ist / nur warten, bis die Richtlinie veröffentlicht ist
$session->rpc()->managedSettings()->awaitApplied();
$session->rpc()->managedSettings()->awaitPublished();
// Wertet den Policy Helper neu aus und gibt die resultierenden effektiven Einstellungen zurück
$settings = $session->rpc()->managedSettings()->recheckPolicyHelper(); // ManagedSettingsResolvedData

// compaction → in history umbenannt
$session->rpc()->history()->compact();
// Modell, Anweisungen und Reasoning-Aufwand für die Komprimierung festlegen (experimental). Jeder Aufruf ersetzt alle drei Werte, weggelassene Werte fallen auf den Standard zurück
$session->rpc()->history()->setCompactionConfig(new HistorySetCompactionConfigRequest(
    model: 'gpt-5', // Optional. Bei BYOK-/Provider-Sessions u. a. erfolgt die Zusammenfassung mit dem Modell der Session
    prompt: 'Keep decisions only', // Optional. Ersetzt den eingebauten Prompt
    reasoningEffort: ReasoningEffort::LOW, // Optional
));
// Manuelle Komprimierung abbrechen / Hintergrundkomprimierung abbrechen
$session->rpc()->history()->abortManualCompaction();
$session->rpc()->history()->cancelBackgroundCompaction();
// Zusammenfassung für die Übergabe an eine andere Session abrufen
$summary = $session->rpc()->history()->summarizeForHandoff()->summary;
// Verlauf ab einem bestimmten Event kürzen
$session->rpc()->history()->truncate(new HistoryTruncateRequest(
    eventId: 'evt-123', // Dieses Event und alle nachfolgenden Events werden gelöscht
));
```


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [Einstellungen und verwaltete Einstellungen](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-settings.md)
- [Fehlerbehandlung](https://kawax.biz/de/error-handling.md)
- [HTTP-Client und Tests in Paketen](https://kawax.biz/de/advanced/package-http-client.md)
- [Logging](https://kawax.biz/de/logging.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.