Skip to content

docs: revert SystemPromptConfig docs [langchain-ai/deepagents#4969] - #5056

Merged
Nishitha M (imnishitha) merged 12 commits into
mainfrom
open-swe/revert-system-prompt-config-docs
Jul 28, 2026
Merged

docs: revert SystemPromptConfig docs [langchain-ai/deepagents#4969]#5056
Nishitha M (imnishitha) merged 12 commits into
mainfrom
open-swe/revert-system-prompt-config-docs

Conversation

@imnishitha

@imnishitha Nishitha M (imnishitha) commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Description

langchain-ai/deepagents#4969 reverted the alpha SystemPromptConfig (prefix/base/suffix dict) feature, so system_prompt= is a plain str | SystemMessage again. This drops the SystemPromptConfig guidance from the Python-side "System prompt" section entirely and fixes the section intro, which incorrectly claimed a built-in base prompt ships by default. Also resyncs the Python function-signature snippet (stale SystemPromptConfig reference) and drops the now-stale SystemPromptConfig link-map entry. No changelog changes.

langchain-ai/deepagentsjs mirrored the revert (#700, #703), but kept SystemPromptConfig in its type union as a @deprecated compatibility shim slated for removal in the next major release. Dropped it from the JS signature snippet to match. Note for reviewers: that snippet is normally auto-generated by scripts/sync_deepagents_signatures.py from the live API reference site, which still lists the deprecated type — don't blindly re-run that script against this one file until deepagentsjs's next major release actually removes the shim, or it'll reintroduce SystemPromptConfig.

Test Plan

  • make check-cross-refs
  • make lint_prose FILES=... on changed .mdx files

Opened collaboratively by Nishitha Madhu and open-swe

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
@github-actions github-actions Bot added internal deepagents For docs changes to Deep Agents docs-infra langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects labels Jul 23, 2026
@imnishitha
Nishitha M (imnishitha) marked this pull request as ready for review July 24, 2026 14:11
@github-actions

Copy link
Copy Markdown
Contributor

Thanks for opening a docs PR, Nishitha M (@imnishitha)! When it's ready for review, please add the relevant reviewers:

  • @npentrel or @lnhsingh (Deep Agents)
  • @npentrel or @lnhsingh (open source)

Comment thread src/oss/deepagents/customization.mdx Outdated
Comment thread src/oss/deepagents/customization.mdx Outdated
Comment thread src/oss/deepagents/customization.mdx Outdated
Nishitha M (imnishitha) and others added 3 commits July 27, 2026 14:40
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
@github-actions github-actions Bot removed the langchain For docs changes to LangChain label Jul 27, 2026
Nishitha M (imnishitha) and others added 3 commits July 27, 2026 17:37
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
…fig)

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Comment thread src/oss/deepagents/customization.mdx Outdated
Besides a string, the main agent also accepts a @[`SystemMessage`] with structured [content blocks](/oss/langchain/messages#standard-content-blocks); Deep Agents preserve those blocks ([subagent](/oss/deepagents/subagents) dictionary specs remain strings).
</Note>

When middleware adds special tools, like the filesystem tools, it appends its own guidance to the system prompt at runtime.

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.

Is this true?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

yup

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.

are you sure? it looks like for StateBackend for example FilesystemMiddleware appends nothing to the system prompt https://github.com/langchain-ai/deepagents/blob/f1727c785c44809e7b1b7ed8c5d0b31c560ae3ad/libs/deepagents/deepagents/graph.py#L629-L636

@imnishitha Nishitha M (imnishitha) Jul 28, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

verified - by default mw appends nothing (no custom system_prompt and no execution support)

@github-actions

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-opensw-1785262793-1b12552

Site preview: https://langchain-5e9cc07a-preview-opensw-1785262793-1b12552.mintlify.site

Important

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

@imnishitha
Nishitha M (imnishitha) merged commit 6a21daf into main Jul 28, 2026
23 of 24 checks passed
@imnishitha
Nishitha M (imnishitha) deleted the open-swe/revert-system-prompt-config-docs branch July 28, 2026 19:15
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 docs-infra internal 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.

4 participants