弃用和破坏性更改

此代码包含 langchain 和 langchain-core 包中的弃用和移除内容。

此处未列出新功能和改进。有关此版本中新增内容的概要，请参阅概览。

重大变更

从版本 0.2.0 开始，langchain 必须与集成无关。这意味着 langchain 中的代码默认不应实例化任何特定的聊天模型、LLM、嵌入模型、向量存储等；相反，用户必须明确指定这些内容。

以下函数和类需要将一个明确的大型语言模型作为参数传入：

langchain.agents.agent_toolkits.vectorstore.toolkit.VectorStoreToolkit
langchain.agents.agent_toolkits.vectorstore.toolkit.VectorStoreRouterToolkit
langchain.chains.openai_functions.get_openapi_chain
langchain.chains.router.MultiRetrievalQAChain.from_retrievers
langchain.indexes.VectorStoreIndexWrapper.query
langchain.indexes.VectorStoreIndexWrapper.query_with_sources
langchain.indexes.VectorStoreIndexWrapper.aquery_with_sources
langchain.chains.flare.FlareChain

以下类现在需要作为参数显式传递嵌入模型：

langchain.indexes.VectostoreIndexCreator

以下代码已被移除：

langchain.natbot.NatBotChain.from_default 已移除，以 from_llm 类方法取代。

以下代码的行为已更改：

@tool 装饰器

@tool 装饰器现在将函数文档字符串用作工具描述。以前，@tool 装饰器会将函数签名前置。

0.2.0 版本之前：

@tool
def my_tool(x: str) -> str:
    """Some description."""
    return "something"

print(my_tool.description)

将会得到： my_tool: (x: str) -> str - Some description.

截至 0.2.0 版本：

这将导致： Some description.

移至另一个包的代码

从 langchain 移动到另一个包的代码（例如，langchain-community）

如果您尝试从 langchain 导入，导入将继续工作，但会引发弃用警告。该警告将提供一个替代的导入语句。

python -c "from langchain.document_loaders.markdown import UnstructuredMarkdownLoader"

LangChainDeprecationWarning: Importing UnstructuredMarkdownLoader from langchain.document_loaders is deprecated. Please replace deprecated imports:

>> from langchain.document_loaders import UnstructuredMarkdownLoader

with new imports of:

>> from langchain_community.document_loaders import UnstructuredMarkdownLoader

我们将在版本 0.4 发布之前继续支持 langchain 中的导入，只要包含相关代码的包已安装即可。（例如，只要 langchain_community 已安装。）

然而，我们建议用户不要依赖这些导入语句，而是迁移到新的导入方式。为了帮助这一过程，我们通过 LangChain 命令行工具发布了迁移脚本。请参阅迁移指南以获取更多说明。

将被删除的代码

代码中已有更好的替代方案，并且最终会被移除，因此只有一种方式来完成任务。（例如，ChatModels 中的 predict_messages 方法已被弃用，以改用 invoke 方法。）

流式事件 V1

如果您正在使用 astream_events，请查阅如何迁移到 astream 事件 v2。

langchain_core

try_load_from_hub

模块： utils.loading 已弃用： 0.1.30 移除： 0.3.0

替代方案：使用 hwchase17/langchain-hub 仓库中的提示已弃用。请改用 https://smith.langchain.com/hub。

BaseLanguageModel.predict

模块： language_models.base 已弃用： 0.1.7 移除： 0.3.0

替代：调用

BaseLanguageModel.predict_messages

模块： language_models.base 已弃用： 0.1.7 移除： 0.3.0

替代：调用

BaseLanguageModel.apredict

模块： language_models.base 已弃用： 0.1.7 移除： 0.3.0

替代方案：ainvoke