弃用和重大变更

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

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

重大变更

自0.2.0版本发布以来，langchain 需要与集成无关。这意味着 langchain 中的代码默认情况下不应实例化任何特定的聊天模型、llms、嵌入模型、向量存储等；相反，用户需要明确指定这些内容。

以下函数和类需要显式传递一个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

以下类现在需要传递一个显式的Embedding模型作为参数：

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 - 一些描述。

截至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

我们将继续支持在langchain中的导入，直到0.4版本发布，只要代码所在的相应包已安装。（例如，只要安装了langchain_community。）

然而，我们建议用户不要依赖这些导入，而是迁移到新的导入。为了帮助完成这个过程，我们通过LangChain CLI发布了一个迁移脚本。请参阅迁移指南中的进一步说明。

标记为删除的代码

有更好的替代方案可用并且最终将被移除的代码，因此只有一种方式来做事情。（例如，ChatModels中的predict_messages方法已被弃用，推荐使用invoke）。

astream 事件 V1

如果您正在使用astream_events，请查看如何迁移到astream events v2。

langchain_core

尝试从中心加载

在模块中: 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