docs: stop DeepAgents rendering three empty provider-switch sections (#7815)

[jason-ma-nv]

Summary

On the DeepAgents "Switch Inference Providers" page, three headings — "Find a
Registered Provider", "Switch the Provider at Runtime", and "Handle Compatible
Endpoints" — rendered with no body content, because the headings sat outside any
AgentOnly block (so they rendered for every variant) while their bodies lived
only in openclaw,hermes blocks. This is a regression of the #7309 empty-section
fix. DeepAgents changes providers by recreating the sandbox (its own "Recreate a
Deep Agents Sandbox" block), so those runtime workflows do not apply to it. This
moves each heading inside its openclaw,hermes block so DeepAgents no longer
emits empty sections.

Related Issue

Fixes #7815

Changes

• docs/inference/switch-providers.mdx: move the "Find a Registered Provider",
  "Switch the Provider at Runtime", and "Handle Compatible Endpoints" headings
  inside their existing <AgentOnly variant="openclaw,hermes"> blocks. No prose
  changes; openclaw/hermes rendering is unchanged, and DeepAgents keeps its
  own "Recreate a Deep Agents Sandbox" guidance plus the shared sections.

Type of Change

• Code change (feature, bug fix, or refactor)
• Doc only (prose changes, no code sample modifications)

Quality Gates

• Tests added or updated for changed behavior
• Tests not applicable — justification: documentation variant-scoping fix; validated by the docs build and agent-variant generation.
• Docs updated for user-facing behavior changes
• Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
• Non-success, skipped, or missing CI check accepted by maintainer:

Verification

• PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
• Normal pre-commit, commit-msg, and pre-push hooks passed
• Targeted behavior tests pass, or tests are marked not applicable above — result: regenerated the agent-variant docs and confirmed the DeepAgents page (switch-providers.deepagents.generated.mdx) no longer emits the three empty headings (only "Recreate a Deep Agents Sandbox", "Account for Shared Gateways", "Related Topics"), while the openclaw variant keeps all three headings with bodies. npm run docs → 0 errors, exit 0, check-docs-published-routes: OK, locally and on a fresh clone + npm ci on an Ubuntu host.
• npm run docs builds without warnings (doc changes only) — the 2 fern warnings are pre-existing/repo-wide (FERN_TOKEN-gated redirect check and a global light-mode accent contrast ratio); neither references this page.
• Doc pages follow the style guide
• No secrets, API keys, or credentials committed

---

Signed-off-by: Jason Ma jama@nvidia.com

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated provider-switching documentation so relevant sections display correctly for OpenClaw and Hermes users.
  • Improved heading placement and spacing within the applicable platform-specific content.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 0a72c1cd-034a-4474-b709-5231c8abb598

📥 Commits

Reviewing files that changed from the base of the PR and between eeab81c and b3d2b30.

📒 Files selected for processing (1)

• docs/inference/switch-providers.mdx

---

📝 Walkthrough

Walkthrough

The inference provider documentation moves three section headings inside the OpenClaw and Hermes AgentOnly wrapper so they are gated with their corresponding content.

Changes

Provider section gating

Layer / File(s)	Summary
Align provider headings with AgentOnly content docs/inference/switch-providers.mdx	Moves “Find a Registered Provider,” “Switch the Provider at Runtime,” and “Handle Compatible Endpoints” inside the <AgentOnly variant="openclaw,hermes"> blocks.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Suggested reviewers: aasthajh, afourniernv, ahunnargikar-nvidia

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the doc fix for the three empty provider-switch sections in DeepAgents.
Linked Issues check	✅ Passed	The change addresses #7815 by removing the empty DeepAgents-only sections while keeping the shared and sandbox guidance intact.
Out of Scope Changes check	✅ Passed	No unrelated code or documentation changes are indicated beyond the targeted provider-switch section reorganization.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/7815-deepagents-switch-providers-empty-sections

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-7819.docs.buildwithfern.com/nemoclaw

[github-actions]

PR Review Advisor — No blocking findings reported

Advisor assessment: No blocking advisor findings reported
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions

Model lanes

• GPT-5.6 Terra (primary): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Model comparison: normalized findings match; normalized E2E selections match; severity counts match.

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: None

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.