LangChain v0.2 今天向所有用户开放(在此处了解更多关于动机和细节的信息)。本次发布的一个主要亮点是我们的文档更新。我们想花一些时间谈谈文档更新包含哪些内容,并感谢社区成员的推动。
社区驱动的文档反馈
您提出了意见,我们听取了。我们听取了 LangChain 社区和开发人员持续不断的反馈,认为我们的文档需要改进,我们想解决一些提出的关键问题,以及我们如何尝试改进。我们还要特别感谢几位社区成员的反馈和帮助。
我们听到的并试图解决的问题包括
- 文档不断变化。跟上变化可能很痛苦 — 因此我们引入了版本化文档。现在有针对每个次要版本的文档。
- 难以找到相关信息。我们的新文档结构不再是页面迷宫,而是非常扁平化。它分为四个部分(教程、操作指南、概念指南和 API 参考),使信息搜索更容易、更一致。
- 过时和重复的内容。我们已经彻底清理。我们的文档结构现在整合了相关信息,并消除了重复内容的混乱。这个更小的文档集将更容易避免过时的信息。
- 缺乏关于如何更新的明确说明。为了提供一套常青的说明,我们创建了一个 “LangChain 随时间推移”文档,概述了最新版本的 LangChain 发生了哪些变化,以及如何迁移到它。
我们将在博客中介绍其中一些新功能,但如果您想要更实际的操作演示,请查看我们制作的 YouTube 视频,其中演示了新文档!
版本化文档
自 2022 年 10 月首次发布 Python 包以来,LangChain 已经发生了显著的演变。文档也随之发展。这些文档更新反映了如何最好地使用 LangChain 的新的和不断发展的思维模式,但也可能让用户感到困惑。
从 v0.2 版本开始,我们为所有次要版本引入了版本化文档。这意味着 v0.1 文档将保持可访问和可发现性,供那些喜欢它的人使用。可在顶部导航栏中找到可用文档版本的列表。

我们希望这能在更新我们的文档与不让每个人的思维模式感到困惑之间取得平衡。
文档结构
在此迭代中,我们采用了 Diataxis 分类法,使我们的文档更清晰、更用户友好。 以前,我们只是部分地实现了这一点,这还不够。我们现在已经完全采用了这种方法,并且我们的主要文档也已相应地完全分离出来。

教程是关于如何使用 LangChain 从头到尾构建特定应用程序(如聊天机器人、RAG 应用程序或代理)的分步指南。请参阅下图中的教程示例。

操作指南是关于如何执行特定任务的详细说明指南。这比教程更深入,涵盖稍微高级的主题。

我们全新的概念指南是一个方便的术语表和不同技术列表。这非常适合参考新概念或了解 LangChain 如何工作的全局。

最后,我们的 API 文档包含详细的技术参考文档。

总之,这些更改使文档结构更加扁平化(更容易找到内容)和更整合(不太可能出现重复内容)。
LangChain 随时间推移
我们文档中新的“LangChain 随时间推移”部分可帮助您掌握最新变化。其中包含关于 LangChain 如何变化、如何升级以及如何将旧版本中的先前概念映射到新版本的指南。这是一项社区强烈要求的功能 - 我们也认为这非常必要!

衷心感谢
改进文档是 LangChain 团队和社区共同努力的结果。特别感谢我们的文档的顶级贡献者 Leo Gan。并感谢社区中的每一个人提供的反馈和帮助。我们将继续迭代和开发我们的文档,以帮助所有开发人员更好地驾驭这个 LLM 应用程序的新世界。
LangChain v0.2 完全是为了提高稳定性和可发现性。查看新文档(Python 和 JS) – 并在 GitHub 中给我们留言。您还可以在此处阅读更多关于 LangChain v0.2 的信息。