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

# Modelo, modo, nombre y plan

> Usa SessionRpc en Laravel Copilot SDK para cambiar el modelo, el modo, el nombre y el plan de una sesión.

## Modelo, modo, nombre y plan

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

`model()->startupAdmission()` es un RPC experimental que lee el estado del modelo de arranque almacenado en caché sin obtener el catálogo ni resolver credenciales. Tras aplicar la configuración de arranque, un host interactivo puede pasar `claimEnablement: true` para reclamar el aviso de habilitación único de la sesión, pero solo cuando el catálogo está listo. La reclamación se comparte con el host propietario y dura toda la vida de la sesión. Comprueba el estado con `selectedModel`, `catalogReady` y `requiresEnablement` en el resultado. Cuando esta llamada ha consumido la reclamación, `claimedEnablement` es `true` y `modelToEnable` contiene el modelo que hay que habilitar.

```php theme={null}
// model
$session->rpc()->model()->getCurrent();
// Omite el argumento para leer solo el estado de arranque
$admission = $session->rpc()->model()->startupAdmission();
// Reclamar el derecho a mostrar el aviso de habilitación (array o ModelStartupAdmissionRequest)
$admission = $session->rpc()->model()->startupAdmission(['claimEnablement' => true]);
// Cuando $admission->claimedEnablement es true, comprueba $admission->modelToEnable
// Obtener la política de visualización del resumen de razonamiento del modelo actual (experimental)
$policy = $session->rpc()->model()->getReasoningSummaries(new ModelGetReasoningSummariesRequest(
    persistedShowReasoning: true, // Omitir si no se establece
    summariesVisible: true, // Si se muestra actualmente en la UI del host
));
// $policy->ready, $policy->sessionShowsSummaries, $policy->visibility, etc.
// Cambiar solo el reasoning effort sin cambiar el modelo seleccionado (experimental)
$effort = $session->rpc()->model()->setReasoningEffort(
    new ModelSetReasoningEffortRequest(reasoningEffort: ReasoningEffort::HIGH),
);
// $effort->reasoningEffort
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4'));
// Para indicar reasoningEffort (solo modelos compatibles)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningEffort: ReasoningEffort::HIGH));
// Para indicar reasoningSummary
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningSummary: 'concise'));
// Para indicar contextTier (solo modelos compatibles)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4o', contextTier: 'long_context'));
// Para sobrescribir modelCapabilities
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(
    modelId: 'gpt-4',
    modelCapabilities: new ModelCapabilitiesOverride(
        supports: new ModelCapabilitiesOverrideSupports(vision: true),
    ),
));
// Obtener la lista de modelos disponibles en la sesión (experimental)
$models = $session->rpc()->model()->list();
$models->auto?->tiers; // Preferencias de enrutamiento Auto disponibles para la cuenta
$session->rpc()->model()->list(new ModelListRequest(skipCache: true)); // Omitir la caché

// Cambiar la preferencia de enrutamiento Auto (no cambia el modelo seleccionado, experimental)
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: AutoTier::BALANCE));
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: null)); // Volver al enrutamiento Auto predeterminado del proveedor

// Cambiar el tier de Copilot Fusion sin cambiar el modelo seleccionado (experimental)
$session->rpc()->model()->switchFusionTier(new ModelSwitchFusionTierRequest(fusionTier: FusionTier::MAX));

// Establecer o borrar desde el lado del host la lista de modelos permitidos de la sesión (experimental)
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: ['gpt-5']));
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: null)); // Quitar la restricción

// El helper setModel() también acepta reasoningEffort y modelCapabilities
$session->setModel('claude-opus-4.7', ReasoningEffort::HIGH);
$session->setModel('claude-opus-4.7', 'high'); // También funciona con un string
$session->setModel('gpt-4', modelCapabilities: ['supports' => ['vision' => true]]); // También funciona con un array
// Para indicar autoTier (solo tiene efecto cuando modelId es 'auto')
$session->setModel('auto', autoTier: AutoTier::INTELLIGENCE);
// Para indicar fusionTier (solo válido cuando modelId es 'fusion' o 'auto'; no se puede combinar con autoTier)
$session->setModel('fusion', fusionTier: FusionTier::HIGH);

// Usa el helper setAutoTier() para cambiar solo la preferencia de enrutamiento Auto sin cambiar el modelo (experimental)
$session->setAutoTier(AutoTier::EFFICIENCY);

// Usa el helper setFusionTier() para cambiar solo el tier de Copilot Fusion sin cambiar el modelo (experimental)
$session->setFusionTier(FusionTier::STANDARD);

// mode
$session->rpc()->mode()->get();
$modeResult = $session->rpc()->mode()->set(new ModeSetRequest(mode: 'plan'));
// $modeResult->modeApplied, $modeResult->modelChanged, $modeResult->confirmation, etc.

// name
$session->rpc()->name()->get();
$session->rpc()->name()->set(new NameSetRequest(name: 'My Session'));
// Si el usuario no ha puesto nombre, aplicar el resumen como nombre de la sesión (experimental)
$autoName = $session->rpc()->name()->setAuto(new NameSetAutoRequest(summary: 'Summary of the session'));
// $autoName->applied

// plan
$session->rpc()->plan()->read();
$session->rpc()->plan()->update(new PlanUpdateRequest(content: '...'));
$session->rpc()->plan()->delete();
// Leer la lista de todo de SQLite (modo plan)
$result = $session->rpc()->plan()->readSqlTodos();
// $result->rows - array de PlanSqlTodosRow (id, title, description, status)

// Leer la lista de todo de SQLite y sus dependencias (experimental)
$result = $session->rpc()->plan()->readSqlTodosWithDependencies();
// $result->rows - array de PlanSqlTodosRow
// $result->dependencies - array de PlanSqlTodoDependency (todo_id, depends_on)
```


## Related topics

- [Resumen de SessionRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Morph maps de paquetes y compatibilidad de los datos guardados](https://kawax.biz/es/advanced/package-morph-maps.md)
- [Modelos pivote personalizados y chaperone](https://kawax.biz/es/advanced/eloquent-custom-pivot.md)
- [Modelos](https://kawax.biz/es/packages/laravel-copilot-sdk/models.md)


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