langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-22 20:35:34 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[PR #3958] [MERGED] docs: add Managed Deep Agents private preview docs #3965

New Issue
Closed
opened 2026-06-05 18:53:44 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 18:53:44 -04:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3958
Author: @victorm-lc
Created: 5/12/2026
Status: ✅ Merged
Merged: 5/13/2026
Merged by: @fjmorris

Base: main ← Head: vic/managed-deepagents-docs

📝 Commits (10+)

  • b8ef51d docs: add managed deep agents docs
  • b862c44 docs: clarify deep agents deployment options
  • cadc445 docs: mark deepagents deploy deprecated
  • 91a5529 docs: make managed deep agents guide api first
  • 1166bdc docs: restore oss deepagents deploy page
  • 8c1fbb2 docs: expand managed deep agents api docs
  • 129bea3 docs: update deep agents deploy navigation
  • d2ea7de docs: add managed deep agents api reference
  • 70afe68 docs: address review feedback on managed deep agents pages
  • cc45636 Incorporated feedback from Rafid.

📊 Changes

12 files changed (+1980 additions, -28 deletions)

View changed files

📝 src/docs.json (+12 -1)
➕ src/langsmith/deploy-managed-deep-agent.mdx (+266 -0)
📝 src/langsmith/deployment-quickstart-da.mdx (+2 -2)
📝 src/langsmith/deployment.mdx (+2 -2)
➕ src/langsmith/managed-deep-agents-api.mdx (+47 -0)
➕ src/langsmith/managed-deep-agents-openapi.json (+1637 -0)
📝 src/oss/deepagents/cli/overview.mdx (+1 -1)
📝 src/oss/deepagents/comparison.mdx (+2 -2)
📝 src/oss/deepagents/deploy.mdx (+8 -8)
📝 src/oss/deepagents/going-to-production.mdx (+2 -4)
📝 src/oss/deepagents/quickstart.mdx (+1 -1)
📝 src/oss/deepagents/subagents.mdx (+0 -7)

📄 Description

Overview

Adds private preview docs for Managed Deep Agents:

  • Adds a LangSmith deployment guide for deploying with deepagents deploy and invoking through /v1/deepagents/threads.
  • Adds a manually authored Managed Deep Agents API overview under the LangSmith Deployment reference section.
  • Replaces the OSS Deep Agents deploy page with a shorter Managed Deep Agents page and updates related launch wording.
  • Clarifies that customers can still deploy Deep Agents with a standard LangSmith Deployment when they need custom code, custom routes, advanced auth, full Agent Server APIs, stronger isolation controls, or maximum scalability.

The goal is to document the private preview path without implying generated OpenAPI coverage or the old bundled frontend/custom auth behavior for Managed Deep Agents.

Type of change

Type: New documentation page / Update existing documentation

Related issues/PRs

  • GitHub issue:
  • Feature PR: #24821
  • Linear issue:
  • Slack thread:

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Tests

  • make lint_prose FILES="src/langsmith/deploy-managed-deep-agent.mdx src/langsmith/managed-deep-agents-api.mdx src/oss/deepagents/deploy.mdx src/oss/deepagents/going-to-production.mdx src/oss/deepagents/comparison.mdx src/oss/deepagents/cli/overview.mdx src/langsmith/deployment.mdx src/langsmith/deployment-quickstart-da.mdx"
  • git diff --check HEAD~2..HEAD
  • make broken-links fails on existing broken links outside the changed files. The reported failures are in existing pages such as langsmith/assistants.mdx, langsmith/fleet/code.mdx, oss/*/concepts/products.mdx, oss/*/deepagents/streaming.mdx, oss/*/langchain/streaming.mdx, and snippets/oss/requires-langgraph-server.mdx; the new Managed Deep Agents pages were not listed.

Review notes

Please review the private preview positioning, especially:

  • The route shape: /v1/deepagents/agents/* and /v1/deepagents/threads/*.
  • The X-Api-Key auth header wording.
  • The statement that non-LangGraph Platform endpoint groups such as integrations, auth, triggers, skills, and sandboxes are not mirrored yet.
  • The distinction between Managed Deep Agents and standard LangSmith Deployment for customization-heavy use cases.

Additional notes

AI-assisted documentation update. The docs intentionally avoid request/response schemas until the private preview routes are available from a public OpenAPI source.

🔄 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/3958 **Author:** [@victorm-lc](https://github.com/victorm-lc) **Created:** 5/12/2026 **Status:** ✅ Merged **Merged:** 5/13/2026 **Merged by:** [@fjmorris](https://github.com/fjmorris) **Base:** `main` ← **Head:** `vic/managed-deepagents-docs` --- ### 📝 Commits (10+) - [`b8ef51d`](https://github.com/langchain-ai/docs/commit/b8ef51dc7d1ad4d9a347eeecfafd5d9138b8e1b3) docs: add managed deep agents docs - [`b862c44`](https://github.com/langchain-ai/docs/commit/b862c44ac1220ab6d686b468ece907c6638924ac) docs: clarify deep agents deployment options - [`cadc445`](https://github.com/langchain-ai/docs/commit/cadc445320c7b1ace8aee9367592be23f63a51e8) docs: mark deepagents deploy deprecated - [`91a5529`](https://github.com/langchain-ai/docs/commit/91a5529f5a74cb64112a417cb7203ec2362224e2) docs: make managed deep agents guide api first - [`1166bdc`](https://github.com/langchain-ai/docs/commit/1166bdcb713bbf42628dee4eb0f1ea8bcb82d0d9) docs: restore oss deepagents deploy page - [`8c1fbb2`](https://github.com/langchain-ai/docs/commit/8c1fbb2d9e81446499c4404d599c225dbf089655) docs: expand managed deep agents api docs - [`129bea3`](https://github.com/langchain-ai/docs/commit/129bea31170bc6b44887ee68e895b1692f46dbeb) docs: update deep agents deploy navigation - [`d2ea7de`](https://github.com/langchain-ai/docs/commit/d2ea7de6064c4902fcdd3d4d0195a5a3c05f9e29) docs: add managed deep agents api reference - [`70afe68`](https://github.com/langchain-ai/docs/commit/70afe685ad24c77c7a6a9afa84eec26504f8ed4b) docs: address review feedback on managed deep agents pages - [`cc45636`](https://github.com/langchain-ai/docs/commit/cc45636e65a7caea77ab2673ff39209cb6c56abf) Incorporated feedback from Rafid. ### 📊 Changes **12 files changed** (+1980 additions, -28 deletions) <details> <summary>View changed files</summary> 📝 `src/docs.json` (+12 -1) ➕ `src/langsmith/deploy-managed-deep-agent.mdx` (+266 -0) 📝 `src/langsmith/deployment-quickstart-da.mdx` (+2 -2) 📝 `src/langsmith/deployment.mdx` (+2 -2) ➕ `src/langsmith/managed-deep-agents-api.mdx` (+47 -0) ➕ `src/langsmith/managed-deep-agents-openapi.json` (+1637 -0) 📝 `src/oss/deepagents/cli/overview.mdx` (+1 -1) 📝 `src/oss/deepagents/comparison.mdx` (+2 -2) 📝 `src/oss/deepagents/deploy.mdx` (+8 -8) 📝 `src/oss/deepagents/going-to-production.mdx` (+2 -4) 📝 `src/oss/deepagents/quickstart.mdx` (+1 -1) 📝 `src/oss/deepagents/subagents.mdx` (+0 -7) </details> ### 📄 Description ## Overview Adds private preview docs for Managed Deep Agents: - Adds a LangSmith deployment guide for deploying with `deepagents deploy` and invoking through `/v1/deepagents/threads`. - Adds a manually authored Managed Deep Agents API overview under the LangSmith Deployment reference section. - Replaces the OSS Deep Agents deploy page with a shorter Managed Deep Agents page and updates related launch wording. - Clarifies that customers can still deploy Deep Agents with a standard LangSmith Deployment when they need custom code, custom routes, advanced auth, full Agent Server APIs, stronger isolation controls, or maximum scalability. The goal is to document the private preview path without implying generated OpenAPI coverage or the old bundled frontend/custom auth behavior for Managed Deep Agents. ## Type of change **Type:** New documentation page / Update existing documentation ## Related issues/PRs - GitHub issue: - Feature PR: #24821 - Linear issue: - Slack thread: ## Checklist - [x] I have read the [contributing guidelines](README.md), including the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy) - [x] I have tested my changes locally using `docs dev` - [x] All code examples have been tested and work correctly - [x] I have used **root relative** paths for internal links - [x] I have updated navigation in `src/docs.json` if needed ## Tests - [x] `make lint_prose FILES="src/langsmith/deploy-managed-deep-agent.mdx src/langsmith/managed-deep-agents-api.mdx src/oss/deepagents/deploy.mdx src/oss/deepagents/going-to-production.mdx src/oss/deepagents/comparison.mdx src/oss/deepagents/cli/overview.mdx src/langsmith/deployment.mdx src/langsmith/deployment-quickstart-da.mdx"` - [x] `git diff --check HEAD~2..HEAD` - [ ] `make broken-links` fails on existing broken links outside the changed files. The reported failures are in existing pages such as `langsmith/assistants.mdx`, `langsmith/fleet/code.mdx`, `oss/*/concepts/products.mdx`, `oss/*/deepagents/streaming.mdx`, `oss/*/langchain/streaming.mdx`, and `snippets/oss/requires-langgraph-server.mdx`; the new Managed Deep Agents pages were not listed. ## Review notes Please review the private preview positioning, especially: - The route shape: `/v1/deepagents/agents/*` and `/v1/deepagents/threads/*`. - The `X-Api-Key` auth header wording. - The statement that non-LangGraph Platform endpoint groups such as integrations, auth, triggers, skills, and sandboxes are not mirrored yet. - The distinction between Managed Deep Agents and standard LangSmith Deployment for customization-heavy use cases. ## Additional notes AI-assisted documentation update. The docs intentionally avoid request/response schemas until the private preview routes are available from a public OpenAPI source. --- <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 18:53:44 -04:00
yindo closed this issue 2026-06-05 18:53:44 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#3965
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?