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

# Einstellungen und verwaltete Einstellungen

> Mit ServerRpc des Laravel Copilot SDK arbeiten Sie mit contentExclusion, verwalteten Einstellungen, Einstellungsdateien und der Provider-Konfiguration.

## Einstellungen und verwaltete Einstellungen

Geltungsbereich: ServerRpc (serverweite Operationen, die an den Client 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).

```php theme={null}
// user settings (Benutzereinstellungen)
// Die aktuelle CLI hat keinen user.settings.reload-RPC. get() bezieht sich auf settings.json.
Copilot::client()->rpc()->userSettings()->set(['settings' => ['theme' => 'dark']]); // kein Rückgabewert
```

## contentExclusion

Vor dem Erstellen einer Session können Sie das JSON einer Content-Exclusion-Richtlinie validieren.

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

$result = Copilot::client()->rpc()->contentExclusion()->validatePolicies(
    new ContentExclusionValidatePoliciesRequest(policiesJson: $policiesJson),
);
// $result->policies sind die validierten und normalisierten Richtlinien
```

`policiesJson` wird als ungeparster JSON-String an die CLI übergeben. Schlägt das Parsen des JSON oder die Schemavalidierung fehl, tritt ein RPC-Fehler der CLI (`JsonRpcException`) auf.

Dies ist ein RPC im Server-Scope, der die Richtlinie selbst validiert. Um Pfade im Arbeitsverzeichnis einer Session gegen die tatsächlichen Ausschlussrichtlinien zu prüfen, verwenden Sie das Session-bezogene `contentExclusion()->checkPaths()`.

## managedSettings (experimental: verwaltete Einstellungen)

Liest verwaltete Einstellungen, löst Richtlinien auf, ruft das Schema ab, validiert, erstellt eine Vorschau der Zusammensetzung und verwirft den Cache.

```php theme={null}
$managedSettings = $client->rpc()->managedSettings()->read();
$effective = $client->rpc()->managedSettings()->resolve([
    'selectionId' => 'selection-id',
    'workingDirectory' => '/path/to/project',
]);
$schema = $client->rpc()->managedSettings()->schema();
$validation = $client->rpc()->managedSettings()->validate(['content' => ['permissions' => []]]);
$preview = $client->rpc()->managedSettings()->compose(['layers' => [
    ['source' => 'device', 'settings' => ['permissions' => []]],
]]);
$client->rpc()->managedSettings()->clearCache();
```

## settings (experimental: Operationen an Einstellungsdateien)

Entfernen Sie einen bestimmten Schlüssel aus einer Einstellungsdatei und ersetzen Sie geheime Werte für die Anzeige. `removeRawKey()` entfernt Schlüssel unverändert, auch solche, die keine kanonischen Einstellungspfade sind, etwa Schlüssel, die nicht geladen werden konnten. Kann die Datei nicht geparst werden, überschreibt die CLI sie nicht und `status` ist `invalid`. `redactValueForDisplay()` ersetzt geheime Werte anhand der mit `basePath` angegebenen Position im Einstellungsbaum durch Platzhalter, sodass Sie den Wert Benutzern anzeigen oder in Logs schreiben können.

```php theme={null}
$result = $client->rpc()->settings()->removeRawKey([
    'filePath' => '/path/to/settings.json',
    'rawKey' => 'misspelledKey',
]);
// $result->status ist 'ok' oder 'invalid'

$redacted = $client->rpc()->settings()->redactValueForDisplay([
    'value' => ['apiKey' => 'secret-value', 'name' => 'visible'],
    'basePath' => ['providers', 'openai'],
]);
// Geheime Werte in $redacted->value sind durch Platzhalter ersetzt
```

## providersConfig (experimental: Provider-Konfiguration)

`providersConfig()->addModel()` ist ein experimenteller RPC, der der gespeicherten Provider-Konfiguration des Servers ein Modell hinzufügt. Ist der Provider noch nicht gespeichert, legt die CLI ihn an, und `providerAdded` teilt Ihnen das mit. Die Änderung ist dauerhaft, wirkt sich aber nicht auf laufende Sessions aus.

```php theme={null}
use Revolution\Copilot\Facades\Copilot;

$result = Copilot::client()->rpc()->providersConfig()->addModel([
    'provider' => ['name' => 'my-provider', 'baseUrl' => 'https://example.com/v1'],
    'model' => ['id' => 'my-model', 'provider' => 'my-provider'],
    // 'credential' => $apiKey,
]);

// $result->providerAdded
```

Statt eines Arrays können Sie einen `ProvidersConfigAddModelRequest` übergeben. Die CLI speichert das optionale `credential` im Schlüsselbund des Betriebssystems und gibt es nie im Ergebnis zurück.

Dieselbe Gruppe `providersConfig()` liest, aktualisiert und entfernt die gespeicherte Konfiguration. Auch dies sind experimentelle APIs, und sie wirken sich nicht auf laufende Sessions aus.

```php theme={null}
$config = Copilot::client()->rpc()->providersConfig();
$saved = $config->read(); // $saved->providers und $saved->models

$provider = $config->updateProvider([
    'provider' => ['name' => 'my-provider', 'baseUrl' => 'https://example.com/v2'],
    // 'credential' => $apiKey,
]); // $provider->providerName

$model = $config->updateModel([
    'model' => ['id' => 'my-model', 'provider' => 'my-provider', 'maxOutputTokens' => 4096],
]); // $model->providerName und $model->modelId

$removed = $config->removeModel([
    'providerName' => 'my-provider',
    'modelId' => 'my-model',
]); // $removed->providerRemoved
```

`read()` gibt die Konfiguration in gespeicherter Reihenfolge zurück, ohne Secrets wie Anmeldeinformationen, Header oder Befehle. Das `credentialStatus` jedes Providers ist `present`, `absent` oder `unavailable`. `updateProvider()` ersetzt die gemeinsamen Einstellungen und behält Anmeldeinformationen, benutzerdefinierte Header und lokale Modelleinstellungen bei, die Sie weglassen. `updateModel()` ersetzt die Modelldefinition für den angegebenen Providernamen und die Modell-ID. Entfernt `removeModel()` das letzte Modell eines Providers, entfernt es auch den Provider und seine verwalteten Anmeldeinformationen, und `providerRemoved` ist `true`. Jede Aktualisierung und Entfernung akzeptiert außerdem den passenden `ProvidersConfigUpdateProviderRequest`, `ProvidersConfigUpdateModelRequest` oder `ProvidersConfigRemoveModelRequest`.


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [ServerRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [Verwaltete Einstellungen, Debug und Verlauf](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/session-settings.md)
- [HTTP-Client und Tests in Paketen](https://kawax.biz/de/advanced/package-http-client.md)
- [Queues und Jobs](https://kawax.biz/de/queues.md)


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