From 2596fbc523ef9f20ca009276e92c9680aeab55d5 Mon Sep 17 00:00:00 2001 From: openhands Date: Wed, 1 Jul 2026 15:55:56 +0000 Subject: [PATCH] Add Agent Settings page and link Settings sections in customize-and-settings - Create openhands/usage/settings/agent-settings.mdx explaining sub-agent support and ACP agent selection under Settings > Agent - Link Agent, LLM, Application, and Secrets sections in the customize-and-settings Settings table to their respective documentation pages - Add agent-settings to the Home tab Settings navigation group in docs.json Co-authored-by: openhands --- docs.json | 1 + .../agent-canvas/customize-and-settings.mdx | 8 ++--- openhands/usage/settings/agent-settings.mdx | 34 +++++++++++++++++++ 3 files changed, 39 insertions(+), 4 deletions(-) create mode 100644 openhands/usage/settings/agent-settings.mdx diff --git a/docs.json b/docs.json index 5e5a778a..29ca1a8e 100644 --- a/docs.json +++ b/docs.json @@ -85,6 +85,7 @@ { "group": "Settings", "pages": [ + "openhands/usage/settings/agent-settings", "openhands/usage/settings/application-settings", "openhands/usage/settings/llm-settings", "openhands/usage/settings/secrets-settings", diff --git a/openhands/usage/agent-canvas/customize-and-settings.mdx b/openhands/usage/agent-canvas/customize-and-settings.mdx index 26808f42..01580e30 100644 --- a/openhands/usage/agent-canvas/customize-and-settings.mdx +++ b/openhands/usage/agent-canvas/customize-and-settings.mdx @@ -27,12 +27,12 @@ The `Settings` area currently includes the following sections: | Section | Purpose | |---------|---------| -| `Agent` | Agent behavior and agent-specific capabilities | -| `LLM` | Provider, model, API key, and profile configuration | +| [`Agent`](/openhands/usage/settings/agent-settings) | Agent behavior and agent-specific capabilities | +| [`LLM`](/openhands/usage/settings/llm-settings) | Provider, model, API key, and profile configuration | | `Condenser` | Context compression and summarization behavior | | `Verification` | Approval, critic evaluation, and verification-related behavior | -| `Application` | UI-level preferences and app behavior | -| `Secrets` | Stored secrets used by the active backend | +| [`Application`](/openhands/usage/settings/application-settings) | UI-level preferences and app behavior | +| [`Secrets`](/openhands/usage/settings/secrets-settings) | Stored secrets used by the active backend | On local backends, the `LLM` page also includes an `Available Profiles` area for saved profiles. diff --git a/openhands/usage/settings/agent-settings.mdx b/openhands/usage/settings/agent-settings.mdx new file mode 100644 index 00000000..66f8bd9b --- /dev/null +++ b/openhands/usage/settings/agent-settings.mdx @@ -0,0 +1,34 @@ +--- +title: Agent Settings +description: Configure agent behavior, including sub-agent support and agent selection. +--- + +## Overview + +The Agent settings page controls how the OpenHands agent behaves during conversations — from enabling sub-agents to choosing a different agent entirely. + +Navigate to `Settings > Agent` to configure these options. + +## Sub-Agent Support + +The OpenHands agent supports spawning **sub-agents** to handle parallel or delegated work within a single conversation. When sub-agent support is enabled, the agent can create child agents directly inside the main conversation thread, delegating subtasks to them without leaving the current context. + +Enabling this setting adds the `task` tool to the agent's tool set, which it uses to spawn and coordinate sub-agents. Sub-agents share the same conversation thread, so their results surface inline alongside the main agent's output. + + + Sub-agent support is available on the built-in OpenHands agent. ACP agents manage their own execution model and are not affected by this setting. + + +## Choosing a Different Agent + +The Agent settings page is also where you switch from the built-in OpenHands agent to an external **ACP agent** — such as Claude Code, Codex, or Gemini CLI. ACP agents run as subprocesses managed by the Agent Server and use the [Agent Client Protocol](https://agentclientprotocol.com/protocol/overview) to communicate with Agent Canvas. + +This lets you bring your own preferred coding agent while keeping the full Agent Canvas experience — conversation history, backend management, secrets, and more. + +For step-by-step instructions on onboarding and configuring an ACP agent, see the [ACP Agents guide](/openhands/usage/agent-canvas/acp-agents). + +## Related Guides + +- [ACP Agents](/openhands/usage/agent-canvas/acp-agents) — Bring your own agent with Claude Code, Codex, or Gemini CLI +- [Customize and Settings](/openhands/usage/agent-canvas/customize-and-settings) — Overview of all settings sections +- [Secrets Management](/openhands/usage/settings/secrets-settings) — Store credentials used by the agent