导语
之前的文章我们提到,LangChain 将在 5 月 20 日正式发布 v0.2 版本,时间已到,我们看到它在最新的官方博客中发布了帮助文档的 v0.2 版本,同时 LangChain v0.2 现已向所有用户开放,详情可查看我之前的博客(https://www.mdnice.com/writing/8f31b5edf80a4236a7fc0c6fcdaedcee)。
此次发布的一大亮点是文档更新。这里多花一些时间来讨论文档更新涉及的内容。
现在的文档支持版本化控制,拥有更清晰的结构 - 包括教程、操作指南、概念指南和 API 文档。
下面让我们看一下文档有哪些更新和变化。
社区驱动的文档反馈
Community-driven docs feedback,官方非常乐意听取来自用户和社区的意见。在听到 LangChain 社区以及开发者对于文档需要改进的一致反馈后,官方团队开始致力于解决其中一些关键性问题以及思考如何才能去改进这些问题。
这些问题包括:
- 不断变化的文档。
跟上变化这个过程是让人痛苦的,因此团队引入了版本化管理文档。现在有针对每个次要版本量身定制的文档,用户就可以分版本的去查看相应的开发文档了。 - 很难找到相关信息。
新文档结构已经不再是迷宫般的页面,而是非常扁平。它分为四个部分(教程、操作指南、概念指南和 API 参考),使信息搜索更轻松、更一致。 - 过时和重复的内容。
官方团队重新整理了文档。文档结构现在整合了相关信息,并消除了重复内容的混乱。文档集变得更小也将更容易避免过时的信息。 - 缺乏关于如何更新的明确说明。
为了提供一套长久可用的说明,团队创建了一个“LangChain over time”文档,概述了最新版本的 LangChain 发生了哪些变化以及如何去迁移。详情可以查看https://python.langchain.com/v0.2/docs/versions/overview/?ref...
拥有版本控制的文档
LangChain 自 2022 年 10 月首次发布 Python 包以来已经有了很大的发展。文档也随之发展。这些文档的更新反映了如何最好地使用 LangChain 的新的和不断发展的心智模型,但它的更新变化也可能让用户感到困惑。
从 v0.2 版本开始,所有次要版本都会引入版本控制文档。这意味着 v0.1 文档对于喜欢它的人来说仍然可以被找到和被访问。文档地址:https://python.langchain.com/v0.2/docs/versions/v0_2/,可用文档版本的列表可以在顶部导航栏中查找,如下图:
文档结构
在这次迭代中,文档采用了 Diataxis 分类法,使文档更加清晰和用户友好。在此之前只是部分地实现了这一点,现在完全采用了这种方法,并将主要文档完全分离出来。查看完整文档可以访问:https://python.langchain.com/v0.2/docs/versions/v0_2/
Tutorials
Tutorials 是关于如何使用 LangChain 从头到尾构建特定应用程序的分步指南,例如聊天机器人,RAG 应用程序或代理。有关教程示例,请参阅下图,详情可访问https://python.langchain.com/v0.2/docs/tutorials/:
How-to guides
How-to guides 操作指南是有关如何执行特定任务的详细说明指南。这比教程更深入,涵盖了稍微高级的主题。详情访问:https://python.langchain.com/v0.2/docs/how_to/.
Conceptual guide
概念指南,全新的概念指南是一个方便的术语表和不同技术的列表。这对于引用新概念或全面了解 LangChain 的工作原理非常理想。详情访问:https://python.langchain.com/v0.2/docs/concepts/
API docs
最后,API 文档包含详细的技术参考文档。详情访问:https://api.python.langchain.com/en/latest/langchain_api_refe...
LangChain over time
在文档中新增的“随时间变化的语言链”一节可以帮助用户随时了解变更,有关于 LangChain 如何变化、如何升级以及如何将以前的概念从旧版本映射到新版本的指南。这是一个非常需要的社区功能。详情访问:https://python.langchain.com/v0.2/docs/versions/overview/
总结
LangChain v0.2 旨在提高稳定性和可发现性。您还可以在此处阅读有关 LangChain v0.2 的更多信息:https://www.mdnice.com/writing/8f31b5edf80a4236a7fc0c6fcdaedcee。
快乐学习,简单学习!
关注了解更多 AI 编程、Java 编程知识!
本文由mdnice多平台发布
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。