Skip to content

docs: rename deployment-named LangSmith pages and split Deploy agents from Agent Server - #7687

Merged
Sean Angiolillo (seanangio) merged 13 commits into
mainfrom
seanangio/doc-1922
Nov 16, 2026
Merged

Sean Angiolillo (seanangio) merged 13 commits into
mainfrom
seanangio/doc-1922

Conversation

@seanangio

@seanangio Sean Angiolillo (seanangio) commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Why

Follow-up to #7616, which renamed LangSmith Deployment to LangSmith Agent Server across the docs but deliberately kept every file name and URL slug. That left links that read [Agent Server](/langsmith/deployment), and the product team asked for /deployment to change (DOC-1922).

Renaming the files turned up a bigger problem than stale slugs. The obvious new home for deployment.mdx, agent-server.mdx, already existed. With agent-server-overview.mdx, the docs had three pages titled some form of "Agent Server", all with the sidebar title "Overview":

Page Title Nav location
deployment.mdx LangSmith Agent Server Deploy > Get started
agent-server-overview.mdx Agent Server Agent Server tab landing page
agent-server.mdx Agent Server Agent Server > Capabilities

After the rename, a reader could no longer tell from titles alone where to go to deploy an agent and where to go to learn the Agent Server runtime. Moving files would have hidden this problem without fixing it.

The main change: separate the task from the product

This PR gives each question its own landing page:

  • /langsmith/deploy-overview, "Deploy agents" (formerly /langsmith/deployment). This page answers the task question: I have an agent, so where and how do I run it in production? It covers choosing a framework, choosing a hosting environment (Cloud, hybrid, self-hosted, standalone), pricing, and what to do after deploying. It stays the first page of the Deploy > Get started tab.
  • /langsmith/agent-server, "LangSmith Agent Server". This page answers the product question: what is the runtime, and how does it work? agent-server-overview.mdx is merged into it, and it becomes the landing page of the Agent Server tab. It covers assistants, threads, runs, persistence, the task queue, runtime architecture, auth, customization, and tutorials.

Each page links to the other near the top, so a reader who lands on the wrong one gets redirected in one click.

Why deploy-overview and not an agent-server-* slug

This is the change most likely to draw debate, so here is the reasoning:

  • The page is about an action, not a product. Its content is a decision guide: which framework and which environment. That is true whichever product name it carries. A task-based title ("Deploy agents") also matches the menu item it sits under (Deploy) and the way readers search ("deploy langgraph agent", not "agent server").
  • It frees agent-server to mean one thing. If the deploy page took an agent-server-* slug, the docs would still have two overlapping Agent Server landing pages, which is the problem this PR is trying to fix. Now the product name points at the product page.
  • It stays a single page. Deploy pages for specific environments (deploy-to-cloud, deploy-with-control-plane, deploy-standalone-server) already use verb-led slugs. deploy-overview fits with them.

The tradeoff is that "LangSmith Agent Server" no longer appears in the deploy page's title. The page still opens by naming and linking Agent Server as the runtime that agents deploy to, and the description keeps the product name for search.

Other changes

  • Product-named slugs renamed with docs mv, which rewrote every inbound link and nav entry, and a redirect added for each old URL:
    • deployment → deploy-overview
    • deployment-revisions → agent-server-revisions (title now "Agent Server revisions")
    • manage-deployment → manage-agent-server
    • monitor-deployment → monitor-agent-server
    • enable-self-hosted-deployment → enable-self-hosted-agent-server
  • agent-server-overview merged into agent-server, with a redirect. The merged page adds what the old overview had and the runtime page lacked: streaming, human-in-the-loop, double-texting, webhooks, MCP/A2A, dependency setup, auth and customization cards, and tutorials. It also adds new, explicit coverage of who provisions PostgreSQL and Redis on Cloud, self-hosted, and standalone setups.
  • deployment-quickstart-da deleted. It was a noindex url: stub that was not in the nav and had no inbound links. A redirect to the Managed Deep Agents quickstart replaces it.
  • Existing redirects retargeted so nothing chains: /langgraph-platform/index, /langsmith/deployments, /langsmith/develop-agents-overview, and /langsmith/deploy-self-hosted-full-platform now point to the new slugs. Two redirects that pointed at /langsmith/deployment#agent-server now go to /langsmith/agent-server.
  • Inbound link text fixed across LangSmith, OSS, and snippet pages, where links to the deploy page read "Agent Server" but now point at a page titled "Deploy agents" (and vice versa).

Intentionally left alone

  • deployment-quickstart: its title is "Deploy your app to cloud", so "deployment" describes the task, not the product.
  • smith-deployments-sdk: a url: stub pointing at reference.langchain.com/.../deployment/sdk/. That URL lives outside this repo, so changing it is out of scope.
  • The 12 remaining {#langsmith-deployment-…} heading IDs (billing, usage, Terraform, and similar pages): they protect external #fragment links and cost nothing to keep. The one on the old deploy page's environments heading was dropped, because the heading changed and nothing in the repo links to it.

Review notes

  • Information architecture: please weigh in on the deploy-overview / "Deploy agents" naming above in particular.
  • Product links (follow-up, product team): two links in the LangSmith product still point at /langsmith/deployment and /langsmith/deployment-revisions. The new redirects cover both, but the product team should update them to the new slugs. [I could probably also point Robin at this...]

Linear: DOC-1922

@robin-agent robin-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Robin Review found 2 potential issues.

Open in Web • View Robin trace

Comment thread src/langsmith/agent-server.mdx Resolved
Comment thread src/langsmith/deploy-overview.mdx Resolved
Co-authored-by: robin-agent[bot] <215916821+robin-agent[bot]@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-seanangio-doc-1922-06ba9047

Site preview: https://langchain-5e9cc07a-preview-seanangio-doc-1922-06ba9047.mintlify.site

Important

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.

@seanangio
Sean Angiolillo (seanangio) merged commit fc9f22b into main Nov 16, 2026
31 checks passed
@seanangio
Sean Angiolillo (seanangio) deleted the seanangio/doc-1922 branch November 16, 2026 17:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents internal javascript langchain For docs changes to LangChain langgraph For docs changes to LangGraph mda For docs changes to Managed Deep Agents oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants