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

[GH-ISSUE #3726] [deepagents]: Document deprecation of create_deep_agent(model=None) #2748

New Issue
Open
opened 2026-06-05 17:26:37 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 17:26:37 -04:00
Owner
Copy Link
Copy Source

Originally created by @AdemBoukhris457 on GitHub (Apr 25, 2026).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/3726

Type of issue

issue / bug

Language

Python

Description

Summary

The Deep Agents Python SDK deprecates calling create_deep_agent with model=None. The library emits a DeprecationWarning and states that the model parameter type will eventually change from BaseChatModel | str | None to BaseChatModel | str only.

This behavior is implemented in the library but is not clearly documented on the Deep Agents docs site, so users who omit model (or copy older examples) get a warning without an obvious in-docs explanation.

Library reference

create_deep_agent in libs/deepagents/deepagents/graph.py warns when model is None and falls back to get_default_model() (ChatAnthropic with claude-sonnet-4-6). The warning points to:
https://docs.langchain.com/oss/python/deepagents/models

Expected documentation

  • Mention on the models page (and/or quickstart / overview / customization) that model should always be passed explicitly and that omitting it is deprecated.
  • Update any examples that rely on implicit default model to use an explicit provider:model string or a BaseChatModel instance.
  • Optionally: a short callout on what the default was when None was passed (for migration context).

Why it matters

Users following docs should not learn about deprecation only from runtime warnings. Aligning docs with the library reduces confusion and prepares users for the future signature change.

Originally created by @AdemBoukhris457 on GitHub (Apr 25, 2026). Original GitHub issue: https://github.com/langchain-ai/docs/issues/3726 ### Type of issue issue / bug ### Language Python ### Description ## Summary The Deep Agents Python SDK deprecates calling `create_deep_agent` with `model=None`. The library emits a `DeprecationWarning` and states that the `model` parameter type will eventually change from `BaseChatModel | str | None` to `BaseChatModel | str` only. This behavior is implemented in the library but is not clearly documented on the Deep Agents docs site, so users who omit `model` (or copy older examples) get a warning without an obvious in-docs explanation. ## Library reference `create_deep_agent` in `libs/deepagents/deepagents/graph.py` warns when `model is None` and falls back to `get_default_model()` (`ChatAnthropic` with `claude-sonnet-4-6`). The warning points to: https://docs.langchain.com/oss/python/deepagents/models ## Expected documentation - Mention on the models page (and/or quickstart / overview / customization) that **`model` should always be passed explicitly** and that omitting it is deprecated. - Update any examples that rely on implicit default model to use an explicit `provider:model` string or a `BaseChatModel` instance. - Optionally: a short callout on what the default was when `None` was passed (for migration context). ## Why it matters Users following docs should not learn about deprecation only from runtime warnings. Aligning docs with the library reduces confusion and prepares users for the future signature change.
yindo added the externaldeepagents labels 2026-06-05 17:26:37 -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 deepagents external
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#2748
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?