Provider (BYOK)
Ámbito: SessionRpc (operaciones por sesión vinculadas a una Session) Para una visión general de RPC y la lista de todas las páginas de RPC, consulta RPC.// provider: obtener la información del endpoint del provider que usa la sesión (experimental)
// Se usa al llamar directamente al backend del LLM en una configuración BYOK (Bring Your Own Key)
use Revolution\Copilot\Types\Rpc\ProviderGetEndpointRequest;
$endpoint = $session->rpc()->provider()->getEndpoint();
// $endpoint->baseUrl - URL base que se pasa a la librería cliente del LLM
// $endpoint->type - tipo de proveedor (openai, anthropic, etc.)
// $endpoint->headers - cabeceras HTTP que se incluyen en la petición
// $endpoint->apiKey - credenciales (nullable)
// $endpoint->sessionToken - credenciales de sesión de corta duración (nullable)
// $endpoint->wireApi - wire API específica del proveedor (nullable)
// Obtener el estado de configuración del proveedor del modelo seleccionado (no valida credenciales ni contacta al proveedor) (experimental)
$status = $session->rpc()->provider()->getStatus();
// $status->hasCustomProvider - Si se usa un proveedor personalizado en lugar de la autenticación de GitHub
// Obtener el endpoint de un modelo concreto
$endpoint = $session->rpc()->provider()->getEndpoint(
new ProviderGetEndpointRequest(model: 'gpt-5')
);
// provider: actualizar la configuración de conexión del provider dentro de la sesión (experimental)
$session->rpc()->provider()->updateProvider([
'provider' => ['name' => 'example', 'baseUrl' => 'https://example.com/v1'],
]);
// provider: actualizar un modelo de la sesión, identificado por provider e id (experimental)
$session->rpc()->provider()->updateModel([
'model' => ['provider' => 'example', 'id' => 'model', 'maxOutputTokens' => 4096],
]);
// Ninguno de los dos cambia la configuración guardada ni otros modelos.
// updateProvider conserva la credencial existente y no acepta credenciales ni cabeceras personalizadas.
// También puedes pasar SessionProviderUpdateProviderRequest / SessionProviderUpdateModelRequest en lugar de un array.
// provider: retirar del registro BYOK los modelos gestionados por el host (experimental)
$result = $session->rpc()->provider()->withdraw(['models' => ['provider/model']]);
// $result->withdrawn, $result->providersRemoved, $result->modelDeselected