Repurpose hybrid docs around self-hosted Agent Servers#4130
Merged
Conversation
Redefines /langsmith/hybrid as the model where you self-host Agent Servers and trace to either self-hosted LangSmith or LangSmith SaaS, pointing to the standalone server guide for setup. Moves the previous LangChain-managed control plane + self-managed data plane content to a new /langsmith/hybrid-legacy page that merges the old overview and Kubernetes setup guide, with a redirect from /langsmith/deploy-hybrid.
Contributor
|
Thanks for opening a docs PR, hari-dhanushkodi! When it's ready for review, please add the relevant reviewers:
|
Removes mentions of "hybrid" from pages where it no longer applies under the repurposed definition (self-hosted Agent Servers). Scopes platform-setup.mdx to LangSmith infrastructure deployment only (Cloud, Self-hosted), and drops hybrid bullets/cells from cloud provider self-hosted pages, env-var.mdx, control-plane.mdx, data-plane.mdx, local-dev-testing.mdx, manage-trace.mdx, sandbox-cli.mdx, and langsmith-cli.mdx. Updates deploy-with-control-plane.mdx to clarify that the hybrid setup link refers to the legacy model.
Scopes /langsmith/self-hosted to LangSmith infra setup only (observability, evaluation, prompt engineering), removing the "Enable LangSmith Deployment" and "Standalone Server" sections. Folds the application deployment workflow from /langsmith/deploy-with-control-plane (now deleted) into both /langsmith/deploy-to-cloud (as "Deploy with a pre-built Docker image") and /langsmith/deploy-self-hosted-full-platform (as "Deploy applications with the control plane"). Folds the Standalone Server overview into /langsmith/deploy-standalone-server. Reorders the Deployment guides nav (Managed Deep Agents, Cloud, Hybrid, Standalone, Diagnostics) and adds a redirect from /langsmith/deploy-with-control-plane to the new home on the self-hosted full platform guide.
Brings back /langsmith/deploy-with-control-plane as a standalone deployment guide alongside Cloud, Hybrid, and Standalone. Scopes the page to self-hosted customers via a top callout and prerequisites that link to the LangSmith Deployment enablement section. Reverts the duplicated control-plane workflow sections from deploy-to-cloud.mdx and deploy-self-hosted-full-platform.mdx (the latter now links out to the with-control-plane page from Next steps). Removes the redirect added in the previous commit and restores the inbound link in oss/langgraph/deploy.mdx. Also renames "Can deploy applications?" to "Can deploy agents?" in the platform-setup comparison table.
Updates /langsmith/hybrid#listeners reference to point to the legacy page. Adds a warning to the "Configure additional data planes" section indicating the approach is not recommended and slated for deprecation, pointing users to standalone Agent Servers with self-hosted LangSmith tracing instead.
Embeds the saas-region-urls snippet under the LangSmith SaaS option so users see the GCP US/EU/APAC and AWS US endpoints inline. Removes the note pointing to the legacy hybrid setup guide.
Contributor
|
Thanks for opening a docs PR, hari-dhanushkodi! When it's ready for review, please add the relevant reviewers:
|
Andrew Nguonly (andrewnguonly)
approved these changes
May 26, 2026
Mukil Loganathan (langchain-infra)
approved these changes
May 26, 2026
hari-dhanushkodi
force-pushed
the
repurpose-hybrid-docs
branch
from
7994df5 to
d8c332b
Compare
Contributor
|
Mintlify preview branch generated: Site preview: https://langchain-5e9cc07a-preview-repurp-1779849905-bd7c92f.mintlify.app Preview links may take a few minutes to start working while the deployment finishes. Changed documentation pages (preview deep links):
Only the top 5 changed markdown files by diff size are listed. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
"Setup guide (legacy)".
Self-hosted page scoped to LangSmith infra:
/langsmith/self-hostednow describes only the LangSmith observability/evaluation/prompt-engineering platform.The "Enable LangSmith Deployment" and "Standalone Server" overview content moved into their respective deployment guides.
Deployment guides reorganized: the Deployment guides nav is now Managed Deep Agents → Cloud → Hybrid → Standalone → With control plane → Diagnostics. The
"With control plane" page is scoped to self-hosted customers via a top callout and links to the LangSmith Deployment enablement section as a prerequisite.
Platform setup focused on LangSmith deployment:
/langsmith/platform-setupnow compares only Cloud vs Self-hosted (LangSmith infra), with "Can deployagents?" called out as a feature row.
Other cleanups:
aws/azure/gcp-self-hosted.mdx,env-var.mdx,control-plane.mdx,data-plane.mdx,local-dev-testing.mdx,manage-trace.mdx,sandbox-cli.mdx,langsmith-cli.mdx.deploy-self-hosted-full-platform.mdx, recommending standalone Agent Servers + self-hostedLangSmith tracing instead.
/langsmith/hybridusing thesaas-region-urlssnippet./langsmith/hybrid-legacypage; redirect added from/langsmith/deploy-hybrid.Test plan
make lint_prose FILES="src/langsmith/hybrid.mdx src/langsmith/hybrid-legacy.mdx src/langsmith/self-hosted.mdx src/langsmith/deploy-standalone-server.mdx src/langsmith/deploy-with-control-plane.mdx src/langsmith/deploy-to-cloud.mdx src/langsmith/deploy-self-hosted-full-platform.mdx src/langsmith/platform-setup.mdx"make broken-linksandmake broken-links-with-anchors(only pre-existing failures inself-hosted-changelog.mdxand the API ref pages remain)make devand verify:hybrid-legacy/langsmith/hybridshows the components table and the SaaS region URL list under "Choose where traces are sent"/langsmith/self-hostedno longer shows the 3-card overview / "Enable LangSmith Deployment" / "Standalone Server" sections/langsmith/deploy-with-control-planeshows the "self-hosted only" Info callout at the top/langsmith/platform-setupcompares only Cloud vs Self-hosted with "Can deploy agents?" row/langsmith/deploy-self-hosted-full-platformshows the deprecation Warning on "Configure additional data planes"/langsmith/deploy-hybridredirects to/langsmith/hybrid-legacy