docs: document SDK switch LLM example

sdk/guides/agent-server/cloud-workspace.mdx

@@ -5,7 +5,7 @@
 
 > A ready-to-run example is available [here](#ready-to-run-example)!
 
 The `OpenHandsCloudWorkspace` demonstrates how to use the [OpenHands Cloud](https://app.all-hands.dev) to provision and manage sandboxed environments for agent execution. This provides a seamless experience with automatic sandbox provisioning, monitoring, and secure execution without managing your own infrastructure.
 
 ## Key Concepts
 
@@ -71,7 +71,7 @@
 
 ```python icon="python" focus={1-3}
 result = workspace.execute_command(
     "echo 'Hello from OpenHands Cloud sandbox!' && pwd"
 )
 logger.info(f"Command completed: {result.exit_code}, {result.stdout}")
 ```
@@ -383,6 +383,17 @@
 uv run python examples/02_remote_agent_server/10_cloud_workspace_share_credentials.py
 ```
 
+
+## Settings and Secrets API Examples
+
+The remote agent-server examples also include end-to-end scripts for settings-backed secrets and authenticated LLM configuration:
+
+- [examples/02_remote_agent_server/12_settings_and_secrets_api.py](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/02_remote_agent_server/12_settings_and_secrets_api.py) demonstrates storing secrets through the Settings and Secrets API, referencing them with `LookupSecret`, and cleaning them up after use.
+- [examples/02_remote_agent_server/13_workspace_get_llm.py](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/02_remote_agent_server/13_workspace_get_llm.py) demonstrates configuring LLM settings on an authenticated agent-server and retrieving them through `RemoteWorkspace.get_llm()`.
+
+<RunExampleCode path_to_script="examples/02_remote_agent_server/12_settings_and_secrets_api.py"/>
+<RunExampleCode path_to_script="examples/02_remote_agent_server/13_workspace_get_llm.py"/>
+
 ## Next Steps
 
 - **[API-based Sandbox](/sdk/guides/agent-server/api-sandbox)** - Connect to Runtime API service

sdk/guides/llm-profile-store.mdx

@@ -12,7 +12,7 @@
 
 ## Benefits
 - **Persistence:** Saves model parameters (API keys, temperature, max tokens, ...) to a stable disk format.
 - **Reusability:** Import a defined profile into any script or session with a single identifier.
 - **Portability:** Simplifies the synchronization of model configurations across different machines or deployment environments.
 
 ## How It Works
@@ -232,8 +232,19 @@
 
 <RunExampleCode path_to_script="examples/01_standalone_sdk/44_model_switching_in_convo.py"/>
 
+
+## Agent-Driven LLM Switching
+
+Saved profiles can also be exposed to the agent through the `switch_llm` built-in tool. The tool call switches the conversation's active profile after the current model finishes the tool call, so future model calls use the selected profile.
+
+<Note>
+This example is available on GitHub: [examples/01_standalone_sdk/49_switch_llm_tool.py](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/49_switch_llm_tool.py)
+</Note>
+
+<RunExampleCode path_to_script="examples/01_standalone_sdk/49_switch_llm_tool.py"/>
+
 ## Next Steps
 
 - **[LLM Registry](/sdk/guides/llm-registry)** - Manage multiple LLMs in memory at runtime
 - **[LLM Routing](/sdk/guides/llm-routing)** - Automatically route to different models
 - **[Exception Handling](/sdk/guides/llm-error-handling)** - Handle LLM errors gracefully