docs(sdk): add Task-Based Model Routing guide for route_task_to_model

[hieptl]

• I have read and reviewed the documentation changes to the best of my ability.
• If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

Adds sdk/guides/llm-task-routing.mdx, a guide for the built-in route_task_to_model tool (ClassifyAndSwitchLLMTool) introduced in OpenHands/software-agent-sdk#4287, and registers it under LLM Features in docs.json.

The page covers:

• how the tool classifies the current task and switches to a saved LLM profile;
• the two MetaProfile shapes (structured classes and direct prompt) and the resolution order between active_meta_profile, the inline meta_profile, and the meta-profile store;
• enabling the tool through OpenHandsAgentSettings, including the need to register default tool implementations before create_agent();
• the ready-to-run example examples/01_standalone_sdk/59_route_task_to_model.py, embedded in the auto-synced code block format.

This example was previously undocumented, which fails the SDK's "Docs example" check on OpenHands/software-agent-sdk#5320. The embedded block matches the example as fixed in that PR.

I did not run the site locally. The code block was verified with .github/scripts/sync_code_blocks.py against the SDK checkout (no changes to this page), and docs.json was validated as JSON.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
all-hands-ai	🟢 Ready	View Preview	Sep 25, 2026, 12:03 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[tofarr]

🍰