[PR #3297] [CLOSED] docs(deepagents): add docs for backend refactor #3355

Closed
opened 2026-06-05 18:22:50 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3297
Author: @colifran
Created: 3/24/2026
Status: Closed

Base: mainHead: colifran/backend-refactor


📝 Commits (7)

  • 639e735 add docs for backend refactor
  • efa7685 clean up
  • face9a5 Merge branch 'main' into colifran/backend-refactor
  • 8d97b49 remove internal api references
  • 4602c06 document file format flag
  • 3efe7c8 make file format flag default clear
  • de72dc0 clean up

📊 Changes

7 files changed (+285 additions, -110 deletions)

View changed files

📝 src/oss/deepagents/acp.mdx (+1 -1)
📝 src/oss/deepagents/backends.mdx (+261 -95)
📝 src/oss/deepagents/cli/overview.mdx (+1 -1)
📝 src/oss/deepagents/customization.mdx (+4 -2)
📝 src/oss/deepagents/harness.mdx (+2 -2)
📝 src/oss/deepagents/long-term-memory.mdx (+15 -8)
📝 src/oss/deepagents/sandboxes.mdx (+1 -1)

📄 Description

Overview

[DO NOT MERGE]

We recently worked on a backend refactor for deepagents that adds support for multimodal file types via a BackendProtocolV2 interface. For sandbox backends we added a SandboxBackendProtocolV2. The refactor is backwards compatible allowing users to continue using legacy file data as well as backends implementing BackendProtocolV1 via a backend protocol adapter implemented internally.

Type of change

Type: [Update existing documentation]

Related issues/PRs

JS

Python

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

(Internal team members only / optional): Create a preview deployment as necessary using the Create Preview Branch workflow


🔄 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/3297 **Author:** [@colifran](https://github.com/colifran) **Created:** 3/24/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `colifran/backend-refactor` --- ### 📝 Commits (7) - [`639e735`](https://github.com/langchain-ai/docs/commit/639e7358021dbeda136e7044ab13390f03fc219e) add docs for backend refactor - [`efa7685`](https://github.com/langchain-ai/docs/commit/efa7685ff8042e8d60421be6478bbeb0500c917c) clean up - [`face9a5`](https://github.com/langchain-ai/docs/commit/face9a51acb507b35f54a3c8e335e7cfbfa60108) Merge branch 'main' into colifran/backend-refactor - [`8d97b49`](https://github.com/langchain-ai/docs/commit/8d97b49633efaf0929b9da2db7afa39ca47a9c97) remove internal api references - [`4602c06`](https://github.com/langchain-ai/docs/commit/4602c0639ec73fe01308103ded5fd400f3b82950) document file format flag - [`3efe7c8`](https://github.com/langchain-ai/docs/commit/3efe7c80f1b4b30d8922efe8144ce17ad618c369) make file format flag default clear - [`de72dc0`](https://github.com/langchain-ai/docs/commit/de72dc0bfcdd8ff9d0a526798f853e5402ffa4b5) clean up ### 📊 Changes **7 files changed** (+285 additions, -110 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/deepagents/acp.mdx` (+1 -1) 📝 `src/oss/deepagents/backends.mdx` (+261 -95) 📝 `src/oss/deepagents/cli/overview.mdx` (+1 -1) 📝 `src/oss/deepagents/customization.mdx` (+4 -2) 📝 `src/oss/deepagents/harness.mdx` (+2 -2) 📝 `src/oss/deepagents/long-term-memory.mdx` (+15 -8) 📝 `src/oss/deepagents/sandboxes.mdx` (+1 -1) </details> ### 📄 Description ## Overview <!-- Brief description of what documentation is being added/updated --> [DO NOT MERGE] We recently worked on a backend refactor for deepagents that adds support for multimodal file types via a BackendProtocolV2 interface. For sandbox backends we added a SandboxBackendProtocolV2. The refactor is backwards compatible allowing users to continue using legacy file data as well as backends implementing BackendProtocolV1 via a backend protocol adapter implemented internally. ## Type of change **Type:** [Update existing documentation] ## Related issues/PRs <!-- Link to related issues, feature PRs, or discussions (if applicable) To automatically close an issue when this PR is merged, use closing keywords: - "closes #123" or "fixes #123" or "resolves #123" For regular references without auto-closing, just use: - "#123" or "See issue #123" Examples: - closes #456 (will auto-close issue #456 when PR is merged) - See #789 for context (will reference but not auto-close issue #789) --> ### JS - https://github.com/langchain-ai/deepagentsjs/pull/356 - https://github.com/langchain-ai/deepagentsjs/pull/353 ### Python - https://github.com/langchain-ai/deepagents/pull/1869 ## Checklist <!-- Put an 'x' in all boxes that apply --> - [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 (Internal team members only / optional): Create a preview deployment as necessary using the [Create Preview Branch workflow](https://github.com/langchain-ai/docs/actions/workflows/create-preview-branch.yml) --- <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:22:50 -04:00
yindo closed this issue 2026-06-05 18:22:50 -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#3355