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

# Modell, Modus, Name und Plan

> Mit SessionRpc des Laravel Copilot SDK ändern Sie Modell, Modus, Session-Namen und Plan einer Session.

## Modell, Modus, Name und Plan

Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session 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).

`model()->startupAdmission()` ist ein experimenteller RPC, der den zwischengespeicherten Modellzustand beim Start liest, ohne den Katalog abzurufen oder Anmeldeinformationen aufzulösen. Nach dem Anwenden der Starteinstellungen kann ein interaktiver Host `claimEnablement: true` übergeben, um die einmalige Aktivierungsabfrage für die Session zu beanspruchen, allerdings nur, wenn der Katalog bereit ist. Der Anspruch wird mit dem besitzenden Host geteilt und gilt für die Lebensdauer der Session. Prüfen Sie den Zustand mit `selectedModel`, `catalogReady` und `requiresEnablement` im Ergebnis. Hat dieser Aufruf den Anspruch verbraucht, ist `claimedEnablement` `true`, und `modelToEnable` enthält das zu aktivierende Modell.

```php theme={null}
// model
$session->rpc()->model()->getCurrent();
// Anzeigerichtlinie für reasoning summaries des aktuellen Modells abrufen (experimental)
$admission = $session->rpc()->model()->startupAdmission();
// Das Recht beanspruchen, die Aktivierungsabfrage anzuzeigen (Array oder ModelStartupAdmissionRequest)
$admission = $session->rpc()->model()->startupAdmission(['claimEnablement' => true]);
// Ist $admission->claimedEnablement true, prüfen Sie $admission->modelToEnable
// Anzeigerichtlinie für die Reasoning-Zusammenfassung des aktuellen Modells abrufen (experimental)
$policy = $session->rpc()->model()->getReasoningSummaries(new ModelGetReasoningSummariesRequest(
    persistedShowReasoning: true, // Weglassen, wenn nicht gesetzt
    summariesVisible: true, // Ob sie aktuell in der Host-UI angezeigt werden
));
// $policy->ready, $policy->sessionShowsSummaries, $policy->visibility usw.
// Nur den reasoning effort ändern, ohne das ausgewählte Modell zu wechseln (experimental)
$effort = $session->rpc()->model()->setReasoningEffort(
    new ModelSetReasoningEffortRequest(reasoningEffort: ReasoningEffort::HIGH),
);
// $effort->reasoningEffort
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4'));
// Mit Angabe von reasoningEffort (nur unterstützte Modelle)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningEffort: ReasoningEffort::HIGH));
// Mit Angabe von reasoningSummary
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'claude-opus-4.7', reasoningSummary: 'concise'));
// Mit Angabe von contextTier (nur unterstützte Modelle)
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(modelId: 'gpt-4o', contextTier: 'long_context'));
// modelCapabilities überschreiben
$session->rpc()->model()->switchTo(new ModelSwitchToRequest(
    modelId: 'gpt-4',
    modelCapabilities: new ModelCapabilitiesOverride(
        supports: new ModelCapabilitiesOverrideSupports(vision: true),
    ),
));
// Liste der in der Session verfügbaren Modelle abrufen (experimental)
$models = $session->rpc()->model()->list();
$models->auto?->tiers; // Für das Konto verfügbare Auto-Routing-Präferenzen
$session->rpc()->model()->list(new ModelListRequest(skipCache: true)); // Cache überspringen

// Auto-Routing-Präferenz ändern (ausgewähltes Modell bleibt unverändert, experimental)
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: AutoTier::BALANCE));
$session->rpc()->model()->switchAutoTier(new ModelSwitchAutoTierRequest(autoTier: null)); // Zum provider-default Auto-Routing zurückkehren

// Allowlist der Modelle für die Session auf Host-Seite setzen bzw. aufheben (experimental)
$session->rpc()->model()->switchFusionTier(new ModelSwitchFusionTierRequest(fusionTier: FusionTier::MAX));

// Modell-Allowlist der Session von der Host-Seite setzen oder löschen (experimental)
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: ['gpt-5']));
$session->rpc()->model()->setAllowedModels(new ModelSetAllowedModelsRequest(allowedModels: null)); // Einschränkung aufheben

// Auch mit dem Helper setModel() lassen sich reasoningEffort und modelCapabilities angeben
$session->setModel('claude-opus-4.7', ReasoningEffort::HIGH);
$session->setModel('claude-opus-4.7', 'high'); // Auch als String möglich
$session->setModel('gpt-4', modelCapabilities: ['supports' => ['vision' => true]]); // Auch als Array möglich
// Mit Angabe von autoTier (nur wirksam, wenn modelId 'auto' ist)
$session->setModel('auto', autoTier: AutoTier::INTELLIGENCE);
// fusionTier angeben (nur gültig, wenn modelId 'fusion' oder 'auto' ist; nicht mit autoTier kombinierbar)
$session->setModel('fusion', fusionTier: FusionTier::HIGH);

// Mit dem Helper setAutoTier() nur die Auto-Routing-Präferenz ändern, ohne das Modell zu wechseln (experimental)
$session->setAutoTier(AutoTier::EFFICIENCY);

// Mit dem Helper setFusionTier() nur die Copilot-Fusion-Stufe ändern, ohne das Modell zu wechseln (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 usw.

// name
$session->rpc()->name()->get();
$session->rpc()->name()->set(new NameSetRequest(name: 'My Session'));
// Zusammenfassung als Session-Namen übernehmen, wenn der Benutzer keinen Namen gesetzt hat (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();
// SQLite-Todo-Liste lesen (Planmodus)
$result = $session->rpc()->plan()->readSqlTodos();
// $result->rows - Array von PlanSqlTodosRow (id, title, description, status)

// SQLite-Todo-Liste mit Abhängigkeiten lesen (experimental)
$result = $session->rpc()->plan()->readSqlTodosWithDependencies();
// $result->rows - Array von PlanSqlTodosRow
// $result->dependencies - Array von PlanSqlTodoDependency (todo_id, depends_on)
```


## Related topics

- [SessionRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [Morph Maps in Paketen und Kompatibilität gespeicherter Daten](https://kawax.biz/de/advanced/package-morph-maps.md)
- [Skills, Plugins, Agents, Instructions und Extensions](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-skills-plugins.md)
- [Laravel MCP](https://kawax.biz/de/mcp.md)


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