欢迎!感谢您对贡献的兴趣。
LangChain 帮助形成了生成式 AI 领域最大的开发者社区,我们始终欢迎新的贡献者。无论您是在修复错误、添加功能、改进文档还是分享反馈,您的参与都有助于让 LangChain 和 LangGraph 变得更好 🦜❤️
贡献方式
Report bugs
发现 bug?请按照以下步骤帮助我们修复:
Search
检查相关仓库的 GitHub Issues 中是否已存在该问题:
LangChain
问题
LangGraph
问题
Deep Agents
问题
Create issue
如果不存在问题,请创建一个新的。编写时,请务必遵循提供的模板并包含 一个最小化、可复现的示例。创建问题后,请附上任何相关标签。如果项目维护者无法复现该问题,则不太可能及时处理。
Wait
项目维护者将对问题进行分类并可能要求提供更多信息。请耐心等待,因为我们管理着大量问题。除非您有新的信息要提供,否则不要回复问题。
如果您要添加问题,请尝试将其集中在单个主题上。如果两个问题相关或相互阻塞,请 将它们关联起来 而不是合并它们。例如:
This issue is blocked by #123 and related to #456.
Suggest features
有关于新功能或改进的想法吗?
Search
搜索相关仓库的问题,查找现有的功能请求:
LangChain
问题
LangGraph
问题
Deep Agents
问题
Discuss
如果不存在请求,请在 相关分类下 开始一个新的讨论,以便项目维护者和社区提供反馈。
Describe
请务必描述用例以及为什么它对其他人有价值。如果可能,请提供示例或原型。概述应该通过的测试用例。
Improve documentation
欢迎改进文档!我们努力保持文档清晰和全面,您的观点可以带来很大的不同。
How to propose changes to the documentation
指南
Contribute code
由于用户基数很大,我们的小团队可能难以跟上所有的功能请求和错误修复。如果您有技能和时间,我们非常希望得到您的帮助!
How to make your first Pull Request
指南
如果您开始处理一个问题,请将其分配给自己或请维护者这样做。这有助于避免重复工作。
如果您在寻找可以处理的任务,请查看我们仓库中标记为"需要帮助"的问题:
LangChain
标签
LangGraph
标签
Deep Agents
标签
Build a new integration
任何人都可以构建和发布自己的 LangChain 集成包。新的集成包不会作为 PR 接受到 langchain-ai 仓库——它们必须独立发布到 PyPI 或 npm。
LangChain
LangChain 集成构建指南
Deep Agents sandboxes
沙箱集成构建指南
拉取请求要求
所有拉取请求应展示有意义的努力和对上下文的理解。 **如果创建拉取请求所需的努力少于维护者审查所需的努力,则不应提交该贡献。** 无论以何种方式产生,低努力的临时贡献往往在上下文相关性、准确性和质量方面偏离目标。大量自动化贡献对我们的审查工作构成了拒绝服务攻击。
所有外部拉取请求必须满足以下要求:
- * 拉取请求必须链接到一个维护者已批准解决方案的问题或讨论,且贡献者在打开 PR 之前必须被分配到该问题。
- * 拉取请求必须填写仓库的拉取请求模板。
如果未满足这些要求,维护者有权不经评论直接关闭拉取请求。 **我们将关闭看起来是低努力垃圾内容的拉取请求和问题。**
语言政策
所有贡献——问题、拉取请求、代码审查和讨论——必须使用英语。这使我们的通信在全球贡献者群体中保持可访问性和可搜索性。
如果英语不是您的第一语言,请不要担心。我们重视清晰的沟通胜过完美的语法,欢迎使用翻译工具。
LLM 的可接受用途
当您满足以下条件时,可以使用 AI 助手帮助起草或修改贡献: **验证每一处更改**:运行和测试代码,根据代码库和官方提供商文档核查事实,并确保结果符合仓库风格。不要提交未经审查的大量生成内容。我们会关闭看起来是低努力或垃圾邮件的拉取请求,无论它们是如何产生的。