棄用和重大變更

此程式碼包含 langchain 和 langchain-core 套件中已棄用和移除的列表。

此處未列出新功能和改進。請參閱概觀以取得此版本新功能的摘要。

重大變更

從 0.2.0 版本開始，langchain 必須與整合無關。這表示 langchain 中的程式碼預設不應實例化任何特定的聊天模型、llm、嵌入模型、向量儲存等；相反地，使用者將需要明確指定這些項目。

以下函數和類別需要將明確的 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

只要安裝了程式碼所在的相關套件，我們將繼續支援 langchain 中的匯入，直到 0.4 版本。（例如，只要安裝了 langchain_community。）

但是，我們建議使用者不要依賴這些匯入，而是遷移到新的匯入。為了協助此過程，我們將透過 LangChain CLI 發布遷移腳本。請參閱遷移指南中的進一步說明。

目標移除的程式碼

已提供更好的替代方案且最終將被移除的程式碼，因此只有一種方法可以執行操作。（例如，ChatModels 中的 predict_messages 方法已被棄用，改用 invoke）。

astream 事件 V1

如果您正在使用 astream_events，請檢閱如何遷移到 astream 事件 v2。

langchain_core

try_load_from_hub

在模組：utils.loading 已棄用：0.1.30 移除：0.3.0

替代方案：使用 hwchase17/langchain-hub repo 取得提示已棄用。請改用 https://smith.langchain.com/hub。

BaseLanguageModel.predict

在模組：language_models.base 已棄用：0.1.7 移除：0.3.0

替代方案：invoke

BaseLanguageModel.predict_messages

在模組：language_models.base 已棄用：0.1.7 移除：0.3.0

替代方案：invoke

BaseLanguageModel.apredict

在模組：language_models.base 已棄用：0.1.7 移除：0.3.0

替代方案：ainvoke