Skip to content

Docs: Model providers page + cross-links (preview, local-only) (#15492) - #717

Draft
juanmichelini wants to merge 6 commits into
mainfrom
docs/provider-connections
Draft

Docs: Model providers page + cross-links (preview, local-only) (#15492)#717
juanmichelini wants to merge 6 commits into
mainfrom
docs/provider-connections

Conversation

@juanmichelini

@juanmichelini juanmichelini commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Docs: Model providers (provider-first)

Adds a Model providers page documenting the provider-centric "connect a provider once, then manage its models under it" flow, plus cross-links and a nav entry. Tracks OpenHands/OpenHands#15492.

Contents

  • New page openhands/usage/agent-canvas/model-providers.mdx (renamed from provider-connections.mdx to match the route):
    • Add a provider once via the preset picker → form (display name, base URL, wire API, keychain-stored key, custom headers JSON).
    • Manage models under the provider — add / edit / remove individual model rows, all sharing the provider's key with no key re-entry; optional per-model wire-API override.
    • Edit provider / rotate key / delete provider (one named secret; rotation is picked up by every model).
    • The optional Test probe suggests catalog models for the add-model step and never mutates the curated list.
    • Managed GitHub Copilot is read-only.
    • Model providers vs. LLM Profiles comparison and a "not in the preview" list (cloud, background catalog refresh, multiple keys per provider).
  • Preview note: local agent-server backends only; cloud support is planned.
  • Cross-links updated from the LLM profiles, LLM settings, first-time setup, and customize-and-settings pages, plus a sidebar entry in docs.json — all pointing at the new route.

Related PRs


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

@mintlify

mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Aug 10, 2026, 9:27 PM

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

Documents the Connect-a-Provider flow from issue #15492. Scoped to stable
concepts; UI specifics marked provisional pending #16499 review.

- New page: agent-canvas/provider-connections.mdx
- Cross-links from llm-profiles, first-time-setup, customize-and-settings
- Added to docs.json nav after llm-profiles

Co-authored-by: openhands <openhands@all-hands.dev>
@juanmichelini
juanmichelini force-pushed the docs/provider-connections branch from b4bbb1a to 101174b Compare August 10, 2026 22:51
@juanmichelini juanmichelini changed the title [draft] Docs: Provider connections Docs: Connect a Provider (preview, local-only) Aug 10, 2026
…e warning)

The connections section uses a Delete button with a confirm step, not a
Disconnect action, and now warns when a removed connection still has profiles
referencing its key. Update the page to match.

Co-authored-by: openhands <openhands@all-hands.dev>
@juanmichelini juanmichelini changed the title Docs: Connect a Provider (preview, local-only) Docs: Connect a Provider page + cross-links (preview, local-only) (#15492) Aug 11, 2026
- How-it-works now describes test-on-blur, the model picker (Recommended pre-selected, Select all, More from vendor), and that each selected model becomes a profile sharing the connection key.
- Section actions documented as Refresh, Rotate key, Disconnect (renamed from Delete/re-validate to match the issue wireframe labels).
- Removed bulk model selection from the not-in-preview list (now shipped); kept cloud, background refresh, and multiple-keys-per-provider.

Co-authored-by: openhands <openhands@all-hands.dev>
@juanmichelini
juanmichelini force-pushed the docs/provider-connections branch from e66bacf to 7227058 Compare August 12, 2026 21:28
@juanmichelini juanmichelini changed the title Docs: Connect a Provider page + cross-links (preview, local-only) (#15492) Docs: Model providers page + cross-links (preview, local-only) (#15492) Aug 12, 2026
Match the reworked provider-centric design (OpenHands/OpenHands#15492):

- Rename provider-connections.mdx -> model-providers.mdx (matches the route).
- Rewrite the page: add a provider once via the preset picker + form (display
  name, base URL, wire API, keychain-stored key, custom headers), then add /
  edit / remove the models nested under the provider — all sharing the
  provider's key, no per-model key re-entry. Document edit/rotate-key/delete and
  the optional Test probe (suggests catalog models, never mutates the curated
  list).
- Update the nav entry and cross-links to the new route.

Co-authored-by: openhands <openhands@all-hands.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants