Skip to content

Docs: Connect a Provider page + cross-links (preview, local-only) (#15492) - #717

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

Docs: Connect a Provider page + cross-links (preview, local-only) (#15492)#717
juanmichelini wants to merge 3 commits into
mainfrom
docs/provider-connections

Conversation

@juanmichelini

@juanmichelini juanmichelini commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Docs: Connect a Provider page + cross-links (preview, local-only)

Adds a Provider Connections page describing the "connect a vendor once, pick
from every model it offers" flow, plus cross-links from the LLM profiles, LLM
settings, first-time setup, and customize-and-settings pages, and a nav entry in
docs.json.

Depends on the frontend PR (OpenHands/OpenHands#16499). Tracks
OpenHands/OpenHands#15492.

Contents

  • New page: openhands/usage/agent-canvas/provider-connections.mdx — how it
    works (vendor + key, test-on-blur, model picker with Recommended pre-selection,
    save creates profiles sharing the key), Provider Connections vs. LLM Profiles,
    refresh/rotate, disconnect, and a "not in the preview" list (cloud, background
    refresh, multiple keys per provider).
  • Preview note: local agent-server backends only; cloud support is planned.
  • Cross-links added from related pages and a sidebar entry in docs.json.

Wireframe alignment

  • Section actions documented as Refresh, Rotate key, Disconnect
    (matching the issue wireframe labels; the previous draft said "Delete" /
    "Re-validate").
  • How-it-works describes the test-on-blur step, the model picker (Recommended
    pre-selected, Select all, More from {vendor}), and that each selected model
    becomes a profile sharing the connection's key.
  • Removed "bulk model selection" from the not-in-preview list (now shipped).

This PR description was updated by an AI agent (OpenHands) on behalf of the
author.

@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>
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