[PR #4130] [MERGED] Repurpose hybrid docs around self-hosted Agent Servers #4126

Closed
opened 2026-06-05 19:12:51 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/4130
Author: @hari-dhanushkodi
Created: 5/21/2026
Status: Merged
Merged: 5/26/2026
Merged by: @hari-dhanushkodi

Base: mainHead: repurpose-hybrid-docs


📝 Commits (7)

  • ede4b57 Repurpose hybrid docs around self-hosted Agent Servers
  • a0a99ae Drop stale hybrid references across LangSmith docs
  • 68c9fbd Consolidate self-hosted overview into deployment guides
  • 6fbdd0c Fix prose lint: pre-built → prebuilt
  • 91cb794 Restore Deploy with control plane page; scope to self-hosted
  • 74f4776 Fix broken anchor and deprecate additional data planes
  • d8c332b List SaaS region endpoints in hybrid; drop legacy cross-link

📊 Changes

19 files changed (+221 additions, -321 deletions)

View changed files

📝 src/docs.json (+7 -3)
📝 src/langsmith/aws-self-hosted.mdx (+1 -1)
📝 src/langsmith/azure-self-hosted.mdx (+1 -1)
📝 src/langsmith/control-plane.mdx (+3 -3)
📝 src/langsmith/data-plane.mdx (+2 -2)
📝 src/langsmith/deploy-self-hosted-full-platform.mdx (+11 -7)
📝 src/langsmith/deploy-standalone-server.mdx (+39 -4)
📝 src/langsmith/deploy-with-control-plane.mdx (+8 -19)
📝 src/langsmith/env-var.mdx (+4 -4)
📝 src/langsmith/gcp-self-hosted.mdx (+1 -1)
📝 src/langsmith/hybrid-legacy.mdx (+101 -11)
📝 src/langsmith/hybrid.mdx (+19 -86)
📝 src/langsmith/langsmith-cli.mdx (+1 -1)
📝 src/langsmith/local-dev-testing.mdx (+0 -1)
📝 src/langsmith/manage-trace.mdx (+1 -1)
📝 src/langsmith/platform-setup.mdx (+14 -35)
📝 src/langsmith/sandbox-cli.mdx (+1 -1)
📝 src/langsmith/self-hosted.mdx (+6 -139)
📝 src/oss/langgraph/deploy.mdx (+1 -1)

📄 Description

Summary

"Setup guide (legacy)".

Self-hosted page scoped to LangSmith infra: /langsmith/self-hosted now 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-setup now compares only Cloud vs Self-hosted (LangSmith infra), with "Can deploy
agents?" called out as a feature row.

Other cleanups:

  • Drops stale hybrid references across 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.
  • Adds a deprecation warning to "Configure additional data planes" in deploy-self-hosted-full-platform.mdx, recommending standalone Agent Servers + self-hosted
    LangSmith tracing instead.
  • Lists the SaaS region endpoints (GCP US/EU/APAC, AWS US) inline on /langsmith/hybrid using the saas-region-urls snippet.
  • Merges the legacy hybrid overview and Kubernetes setup guide into a single /langsmith/hybrid-legacy page; 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-links and make broken-links-with-anchors (only pre-existing failures in self-hosted-changelog.mdx and the API ref pages remain)
  • make dev and verify:
    • Platform setup tab → Hybrid (legacy) group contains only hybrid-legacy
    • Deployment guides group renders: Managed Deep Agents, Cloud, Hybrid, Standalone, With control plane, Diagnostics
    • /langsmith/hybrid shows the components table and the SaaS region URL list under "Choose where traces are sent"
    • /langsmith/self-hosted no longer shows the 3-card overview / "Enable LangSmith Deployment" / "Standalone Server" sections
    • /langsmith/deploy-with-control-plane shows the "self-hosted only" Info callout at the top
    • /langsmith/platform-setup compares only Cloud vs Self-hosted with "Can deploy agents?" row
    • /langsmith/deploy-self-hosted-full-platform shows the deprecation Warning on "Configure additional data planes"
  • Confirm /langsmith/deploy-hybrid redirects to /langsmith/hybrid-legacy

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/4130 **Author:** [@hari-dhanushkodi](https://github.com/hari-dhanushkodi) **Created:** 5/21/2026 **Status:** ✅ Merged **Merged:** 5/26/2026 **Merged by:** [@hari-dhanushkodi](https://github.com/hari-dhanushkodi) **Base:** `main` ← **Head:** `repurpose-hybrid-docs` --- ### 📝 Commits (7) - [`ede4b57`](https://github.com/langchain-ai/docs/commit/ede4b576d344af547ab920815a8dc7403a21c29b) Repurpose hybrid docs around self-hosted Agent Servers - [`a0a99ae`](https://github.com/langchain-ai/docs/commit/a0a99aef3edff2b3301d5780ccec5e298847c250) Drop stale hybrid references across LangSmith docs - [`68c9fbd`](https://github.com/langchain-ai/docs/commit/68c9fbd76f2a8857a212b4c1a9534ea86e8653c8) Consolidate self-hosted overview into deployment guides - [`6fbdd0c`](https://github.com/langchain-ai/docs/commit/6fbdd0c6266a863fb5126e3dcf43ff0105ba5b9f) Fix prose lint: pre-built → prebuilt - [`91cb794`](https://github.com/langchain-ai/docs/commit/91cb79417f4f27fb097ae9c2453bc3157c640bc5) Restore Deploy with control plane page; scope to self-hosted - [`74f4776`](https://github.com/langchain-ai/docs/commit/74f4776185daba8b6a7665aa2ca8cfff214d4f07) Fix broken anchor and deprecate additional data planes - [`d8c332b`](https://github.com/langchain-ai/docs/commit/d8c332b2e2a297ba9ad22b7b4fc8b9366d721df0) List SaaS region endpoints in hybrid; drop legacy cross-link ### 📊 Changes **19 files changed** (+221 additions, -321 deletions) <details> <summary>View changed files</summary> 📝 `src/docs.json` (+7 -3) 📝 `src/langsmith/aws-self-hosted.mdx` (+1 -1) 📝 `src/langsmith/azure-self-hosted.mdx` (+1 -1) 📝 `src/langsmith/control-plane.mdx` (+3 -3) 📝 `src/langsmith/data-plane.mdx` (+2 -2) 📝 `src/langsmith/deploy-self-hosted-full-platform.mdx` (+11 -7) 📝 `src/langsmith/deploy-standalone-server.mdx` (+39 -4) 📝 `src/langsmith/deploy-with-control-plane.mdx` (+8 -19) 📝 `src/langsmith/env-var.mdx` (+4 -4) 📝 `src/langsmith/gcp-self-hosted.mdx` (+1 -1) 📝 `src/langsmith/hybrid-legacy.mdx` (+101 -11) 📝 `src/langsmith/hybrid.mdx` (+19 -86) 📝 `src/langsmith/langsmith-cli.mdx` (+1 -1) 📝 `src/langsmith/local-dev-testing.mdx` (+0 -1) 📝 `src/langsmith/manage-trace.mdx` (+1 -1) 📝 `src/langsmith/platform-setup.mdx` (+14 -35) 📝 `src/langsmith/sandbox-cli.mdx` (+1 -1) 📝 `src/langsmith/self-hosted.mdx` (+6 -139) 📝 `src/oss/langgraph/deploy.mdx` (+1 -1) </details> ### 📄 Description ## Summary "Setup guide (legacy)". **Self-hosted page scoped to LangSmith infra:** `/langsmith/self-hosted` now 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-setup` now compares only Cloud vs Self-hosted (LangSmith infra), with "Can deploy agents?" called out as a feature row. **Other cleanups:** - Drops stale hybrid references across `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`. - Adds a deprecation warning to "Configure additional data planes" in `deploy-self-hosted-full-platform.mdx`, recommending standalone Agent Servers + self-hosted LangSmith tracing instead. - Lists the SaaS region endpoints (GCP US/EU/APAC, AWS US) inline on `/langsmith/hybrid` using the `saas-region-urls` snippet. - Merges the legacy hybrid overview and Kubernetes setup guide into a single `/langsmith/hybrid-legacy` page; redirect added from `/langsmith/deploy-hybrid`. ## Test plan - [x] `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"` - [x] `make broken-links` and `make broken-links-with-anchors` (only pre-existing failures in `self-hosted-changelog.mdx` and the API ref pages remain) - [x] `make dev` and verify: - [x] **Platform setup tab** → Hybrid (legacy) group contains only `hybrid-legacy` - [x] **Deployment guides** group renders: Managed Deep Agents, Cloud, Hybrid, Standalone, With control plane, Diagnostics - [x] `/langsmith/hybrid` shows the components table and the SaaS region URL list under "Choose where traces are sent" - [x] `/langsmith/self-hosted` no longer shows the 3-card overview / "Enable LangSmith Deployment" / "Standalone Server" sections - [x] `/langsmith/deploy-with-control-plane` shows the "self-hosted only" Info callout at the top - [x] `/langsmith/platform-setup` compares only Cloud vs Self-hosted with "Can deploy agents?" row - [x] `/langsmith/deploy-self-hosted-full-platform` shows the deprecation Warning on "Configure additional data planes" - [x] Confirm `/langsmith/deploy-hybrid` redirects to `/langsmith/hybrid-legacy` --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 19:12:51 -04:00
yindo closed this issue 2026-06-05 19:12:51 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#4126