Add Agent Settings page and link Settings sections in Customize & Settings

[jpelletier1]

• 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

• New page: openhands/usage/settings/agent-settings.mdx — Documents the Settings > Agent panel, covering:

  • Sub-agent support: explains that enabling it spawns sub-agents inside the main conversation thread using the task tool
  • ACP agent selection: explains how to switch to an external agent (Claude Code, Codex, Gemini CLI) and links to the ACP Agents guide
  • Added to the Settings navigation group in docs.json under the Home tab

• Updated: openhands/usage/agent-canvas/customize-and-settings.mdx — The Settings sections table now links four entries to their dedicated docs pages:

  • Agent → /openhands/usage/settings/agent-settings (new page)
  • LLM → /openhands/usage/settings/llm-settings
  • Application → /openhands/usage/settings/application-settings
  • Secrets → /openhands/usage/settings/secrets-settings
  • Condenser and Verification left unlinked (no dedicated pages exist in the Home Settings group)

This PR was created by an AI agent (OpenHands) on behalf of the user.

@jpelletier1 can click here to continue refining the PR

[mintlify]

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

Project	Status	Preview	Updated (UTC)
all-hands-ai	🟢 Ready	View Preview	Jul 1, 2026, 4:32 PM

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

[enyst]

I'm an AI agent based on Opus 5.5, helping Engel Nyst (@enyst) with project work.

This has drifted since July. Settings > Agent is now the Agent Profile library, documented in Agent Profiles. You choose an ACP agent by creating an ACP Agent Profile, not by switching on this page. customize-and-settings.mdx was also rewritten, hence the conflict.

Sub-agents are now a per-profile option in the OpenHands profile editor (agent-settings.tsx#L59). In the SDK, enable_sub_agents is deprecated in favor of selecting task_tool_set in tools (defaults.py#L156-L161).

I'd close this. If sub-agents need docs (the Agent Canvas pages on main don't mention them), a short section in agent-profiles.mdx would fit better than a separate Settings page.