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

# Configuración y configuración gestionada

> Usa ServerRpc en Laravel Copilot SDK para trabajar con contentExclusion, la configuración gestionada, los archivos de configuración y la configuración de proveedores.

## Configuración y configuración gestionada

Ámbito: ServerRpc (operaciones de todo el servidor vinculadas al Client)

Para una visión general de RPC y la lista de todas las páginas de RPC, consulta [RPC](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

```php theme={null}
// configuración de usuario
// El CLI actual no tiene el RPC user.settings.reload. get() actúa sobre settings.json.
Copilot::client()->rpc()->userSettings()->set(['settings' => ['theme' => 'dark']]); // Sin valor de retorno
```

## contentExclusion

Antes de crear una sesión, puedes validar el JSON de una política de exclusión de contenido.

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

$result = Copilot::client()->rpc()->contentExclusion()->validatePolicies(
    new ContentExclusionValidatePoliciesRequest(policiesJson: $policiesJson),
);
// $result->policies son las políticas validadas y normalizadas
```

`policiesJson` se pasa a la CLI como una cadena JSON sin analizar. Si falla el análisis del JSON o la validación del esquema, se produce un error RPC de la CLI (`JsonRpcException`).

Es una RPC con ámbito de servidor que valida la propia política. Para comprobar rutas dentro del directorio de trabajo de la sesión contra la política de exclusión real, usa `contentExclusion()->checkPaths()` con ámbito de sesión.

## managedSettings (experimental: configuración gestionada)

Lee la configuración gestionada, resuelve políticas, obtiene el esquema, valida, previsualiza la composición y descarta la caché.

```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: operaciones con archivos de configuración)

Elimina una clave concreta de un archivo de configuración y oculta valores secretos para mostrarlos. `removeRawKey()` elimina claves tal cual, incluidas las que no son rutas de configuración canónicas, como claves que no se pudieron cargar. Si el archivo no se puede analizar, la CLI no lo sobrescribe y `status` es `invalid`. `redactValueForDisplay()` reemplaza los valores secretos por marcadores según la posición en el árbol de configuración indicada por `basePath`, para que puedas mostrar el valor a los usuarios o escribirlo en logs.

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

$redacted = $client->rpc()->settings()->redactValueForDisplay([
    'value' => ['apiKey' => 'secret-value', 'name' => 'visible'],
    'basePath' => ['providers', 'openai'],
]);
// Los valores secretos de $redacted->value se reemplazan por marcadores
```

## providersConfig (experimental: configuración de proveedores)

`providersConfig()->addModel()` es un RPC experimental que añade un modelo a la configuración de proveedores guardada en el servidor. Si el proveedor aún no está guardado, el CLI lo crea y `providerAdded` te lo indica. El cambio es persistente, pero no modifica las sesiones en ejecución.

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

Puedes pasar un `ProvidersConfigAddModelRequest` en lugar de un array. El CLI guarda la `credential` opcional en el llavero del sistema operativo y nunca la devuelve en el resultado.

El mismo grupo `providersConfig()` lee, actualiza y elimina la configuración guardada. También son API experimentales y no modifican las sesiones en ejecución.

```php theme={null}
$config = Copilot::client()->rpc()->providersConfig();
$saved = $config->read(); // $saved->providers y $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 y $model->modelId

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

`read()` devuelve la configuración en el orden en que se guardó, sin secretos como credenciales, cabeceras o comandos. El `credentialStatus` de cada proveedor es `present`, `absent` o `unavailable`. `updateProvider()` reemplaza la configuración compartida y conserva la credencial, las cabeceras personalizadas y la configuración de modelos locales que omitas. `updateModel()` reemplaza la definición del modelo para el nombre de proveedor y el ID de modelo indicados. Cuando `removeModel()` elimina el último modelo de un proveedor, también elimina el proveedor y su credencial gestionada, y `providerRemoved` es `true`. Cada actualización y eliminación acepta también el `ProvidersConfigUpdateProviderRequest`, `ProvidersConfigUpdateModelRequest` o `ProvidersConfigRemoveModelRequest` correspondiente.


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Resumen de ServerRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [Configuración](https://kawax.biz/es/configuration.md)
- [Configuración gestionada, debug e historial](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/session-settings.md)
- [Instalación y configuración - VOICEVOX for Laravel](https://kawax.biz/es/packages/laravel-voicevox/installation.md)


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