Saltar al contenido principal

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.

contentExclusion

Antes de crear una sesión, puedes validar el JSON de una política de exclusión de contenido.
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é.

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.

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.
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.
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.
Última modificación el 20 de noviembre de 2026