[PR #4270] Add motivation section to custom state schema docs #4257

Open
opened 2026-06-05 19:13:17 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/4270
Author: @langsmith-fleet[bot]
Created: 6/2/2026
Status: 🔄 Open

Base: mainHead: docs/improve-custom-state-schema-motivation


📝 Commits (1)

  • 81731b4 Add motivation section to custom state schema docs

📊 Changes

1 file changed (+7 additions, -0 deletions)

View changed files

📝 src/oss/deepagents/context-engineering.mdx (+7 -0)

📄 Description

Fixes DOC-1195

Summary

  • Adds a motivating introduction to the "Custom state schema" section in the Deep Agents context-engineering page
  • The new intro explains why you'd use a custom state schema (use cases and benefits) before diving into the technical decision between state_schema and runtime context
  • Follows the pattern used in the LangChain middleware custom state schema docs, as suggested by the requester

Links

Verification

Not run; docs-only copy change.

Reviewers

Requested review from: @mdrxy, @npentrel


🔄 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/4270 **Author:** [@langsmith-fleet[bot]](https://github.com/apps/langsmith-fleet) **Created:** 6/2/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/improve-custom-state-schema-motivation` --- ### 📝 Commits (1) - [`81731b4`](https://github.com/langchain-ai/docs/commit/81731b4126cf91c5ea8829eee6442d2ba10cc9a7) Add motivation section to custom state schema docs ### 📊 Changes **1 file changed** (+7 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/deepagents/context-engineering.mdx` (+7 -0) </details> ### 📄 Description Fixes DOC-1195 ## Summary - Adds a motivating introduction to the "Custom state schema" section in the Deep Agents context-engineering page - The new intro explains *why* you'd use a custom state schema (use cases and benefits) before diving into the technical decision between `state_schema` and runtime context - Follows the pattern used in the LangChain middleware custom state schema docs, as suggested by the requester ## Links - Linear: https://linear.app/langchain/issue/DOC-1195/improve-custom-state-schema-docs-to-explain-why-youd-use-it - Slack: https://langchain.slack.com/archives/C09G1T60QV9/p1780428672991109 ## Verification Not run; docs-only copy change. ## Reviewers Requested review from: @mdrxy, @npentrel --- <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:13:17 -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#4257