langchain-ai/langchain

core: docstrings shouldn't inherit from parents

Open

#32,066 创建于 2025年7月16日

在 GitHub 查看
 (3 评论) (0 反应) (1 负责人)Python (136,758 star) (22,617 fork)batch import
corehelp wantedinternalv1

描述

from langchain_core.tools import tool
from pydantic import BaseModel


class MyTool(BaseModel):
    """Parent Tool"""
    foo: str

@tool
class ChildTool(MyTool):
    bar: str

For 0.4 release we could consider updating the behavior so that doc-strings are not inherited from their parents. It's fairly odd that doc-strings are inherited for BaseModels as in general the descriptions need to be different

Originally posted by @eyurtsev in #31606

贡献者指南

技术栈
python
领域
documentation
议题类型
feature
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-2 days
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
active
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
PythonPydanticlangchain core basics
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
50
研究方向
The issue requests that the @tool decorator should not inherit docstrings from parent Pydantic models. Examine the current implementation in langchain core/tools/base.py, specifically how the decorator handles doc attributes. Refer to the original discussion in issue #31606 for context. Discuss with the assignee any design decisions and then implement a change that prevents docstring inheritance, ensuring compatibility with the upcoming 0.4 release.