LangChain 导入兼容矩阵：0.3.27 与 1.4.7 下 36 个常用符号的可用性

"""Report which symbols can still be imported from the installed LangChain version."""
import importlib
import importlib.metadata as md
import warnings
 
warnings.simplefilter("ignore")
 
SYMBOLS = [
    ("langchain.agents", "initialize_agent"),
    ("langchain.agents", "AgentExecutor"),
    ("langchain.agents", "create_tool_calling_agent"),
    ("langchain.agents", "create_react_agent"),
    ("langchain.agents", "create_agent"),
    ("langchain.chains", "LLMChain"),
    ("langchain.chains", "RetrievalQA"),
    ("langchain.chains", "create_retrieval_chain"),
    ("langchain.memory", "ConversationBufferMemory"),
    ("langchain.prompts", "PromptTemplate"),
    ("langchain.schema", "Document"),
    ("langchain.text_splitter", "RecursiveCharacterTextSplitter"),
    ("langchain.chat_models", "init_chat_model"),
    ("langchain.chat_models", "ChatOpenAI"),
    ("langchain.llms", "OpenAI"),
    ("langchain.vectorstores", "FAISS"),
    ("langchain.document_loaders", "TextLoader"),
    ("langchain.tools", "tool"),
    ("langchain_core.prompts", "ChatPromptTemplate"),
    ("langchain_core.documents", "Document"),
    ("langchain_text_splitters", "RecursiveCharacterTextSplitter"),
    ("langchain_classic.agents", "AgentExecutor"),
    ("langchain_classic.chains", "LLMChain"),
    ("langchain_classic.memory", "ConversationBufferMemory"),
    ("langgraph.prebuilt", "create_react_agent"),
]
 
# Where the old names go after the split; each target is imported for real in every environment.
TARGETS = [
    ("langchain_classic.agents", "initialize_agent"),
    ("langchain_classic.agents", "create_react_agent"),
    ("langchain_classic.agents", "create_tool_calling_agent"),
    ("langchain_classic.chains", "RetrievalQA"),
    ("langchain_classic.chains", "create_retrieval_chain"),
    ("langchain_core.prompts", "PromptTemplate"),
    ("langchain_core.messages", "HumanMessage"),
    ("langchain_openai", "ChatOpenAI"),
    ("langchain_openai", "OpenAI"),
    ("langchain_community.vectorstores", "FAISS"),
    ("langchain_community.document_loaders", "TextLoader"),
]
 
 
def status(module: str, name: str) -> str:
    try:
        getattr(importlib.import_module(module), name)
        return "OK"
    except ModuleNotFoundError:
        return "NO_MODULE"
    except AttributeError:
        return "NO_ATTR"
    except Exception as exc:  # unexpected import-time failure
        return f"ERR:{type(exc).__name__}"
 
 
def version(dist: str) -> str:
    try:
        return md.version(dist)
    except md.PackageNotFoundError:
        return "-"
 
 
print(
    "installed:",
    ", ".join(f"{d}={version(d)}" for d in ("langchain", "langchain-core", "langchain-classic", "langchain-community", "langchain-text-splitters")),
)
for module, name in SYMBOLS:
    print(f"{status(module, name):10s} {module}.{name}")
print("-- migration targets --")
for module, name in TARGETS:
    print(f"{status(module, name):10s} {module}.{name}")

installed: langchain=0.3.27, langchain-core=0.3.86, langchain-classic=-, langchain-community=0.3.31, langchain-text-splitters=0.3.11
OK         langchain.agents.initialize_agent
OK         langchain.agents.AgentExecutor
OK         langchain.agents.create_tool_calling_agent
OK         langchain.agents.create_react_agent
NO_ATTR    langchain.agents.create_agent
OK         langchain.chains.LLMChain
OK         langchain.chains.RetrievalQA
OK         langchain.chains.create_retrieval_chain
OK         langchain.memory.ConversationBufferMemory
OK         langchain.prompts.PromptTemplate
OK         langchain.schema.Document
OK         langchain.text_splitter.RecursiveCharacterTextSplitter
OK         langchain.chat_models.init_chat_model
OK         langchain.chat_models.ChatOpenAI
OK         langchain.llms.OpenAI
OK         langchain.vectorstores.FAISS
OK         langchain.document_loaders.TextLoader
OK         langchain.tools.tool
OK         langchain_core.prompts.ChatPromptTemplate
OK         langchain_core.documents.Document
OK         langchain_text_splitters.RecursiveCharacterTextSplitter
NO_MODULE  langchain_classic.agents.AgentExecutor
NO_MODULE  langchain_classic.chains.LLMChain
NO_MODULE  langchain_classic.memory.ConversationBufferMemory
OK         langgraph.prebuilt.create_react_agent
-- migration targets --
NO_MODULE  langchain_classic.agents.initialize_agent
NO_MODULE  langchain_classic.agents.create_react_agent
NO_MODULE  langchain_classic.agents.create_tool_calling_agent
NO_MODULE  langchain_classic.chains.RetrievalQA
NO_MODULE  langchain_classic.chains.create_retrieval_chain
OK         langchain_core.prompts.PromptTemplate
OK         langchain_core.messages.HumanMessage
NO_MODULE  langchain_openai.ChatOpenAI
NO_MODULE  langchain_openai.OpenAI
OK         langchain_community.vectorstores.FAISS
OK         langchain_community.document_loaders.TextLoader

installed: langchain=1.4.7, langchain-core=1.7.0, langchain-classic=-, langchain-community=-, langchain-text-splitters=-
NO_ATTR    langchain.agents.initialize_agent
NO_ATTR    langchain.agents.AgentExecutor
NO_ATTR    langchain.agents.create_tool_calling_agent
NO_ATTR    langchain.agents.create_react_agent
OK         langchain.agents.create_agent
NO_MODULE  langchain.chains.LLMChain
NO_MODULE  langchain.chains.RetrievalQA
NO_MODULE  langchain.chains.create_retrieval_chain
NO_MODULE  langchain.memory.ConversationBufferMemory
NO_MODULE  langchain.prompts.PromptTemplate
NO_MODULE  langchain.schema.Document
NO_MODULE  langchain.text_splitter.RecursiveCharacterTextSplitter
OK         langchain.chat_models.init_chat_model
NO_ATTR    langchain.chat_models.ChatOpenAI
NO_MODULE  langchain.llms.OpenAI
NO_MODULE  langchain.vectorstores.FAISS
NO_MODULE  langchain.document_loaders.TextLoader
OK         langchain.tools.tool
OK         langchain_core.prompts.ChatPromptTemplate
OK         langchain_core.documents.Document
NO_MODULE  langchain_text_splitters.RecursiveCharacterTextSplitter
NO_MODULE  langchain_classic.agents.AgentExecutor
NO_MODULE  langchain_classic.chains.LLMChain
NO_MODULE  langchain_classic.memory.ConversationBufferMemory
OK         langgraph.prebuilt.create_react_agent
-- migration targets --
NO_MODULE  langchain_classic.agents.initialize_agent
NO_MODULE  langchain_classic.agents.create_react_agent
NO_MODULE  langchain_classic.agents.create_tool_calling_agent
NO_MODULE  langchain_classic.chains.RetrievalQA
NO_MODULE  langchain_classic.chains.create_retrieval_chain
OK         langchain_core.prompts.PromptTemplate
OK         langchain_core.messages.HumanMessage
OK         langchain_openai.ChatOpenAI
OK         langchain_openai.OpenAI
NO_MODULE  langchain_community.vectorstores.FAISS
NO_MODULE  langchain_community.document_loaders.TextLoader

installed: langchain=1.4.7, langchain-core=1.7.0, langchain-classic=1.0.8, langchain-community=0.4.2, langchain-text-splitters=1.1.3
NO_ATTR    langchain.agents.initialize_agent
NO_ATTR    langchain.agents.AgentExecutor
NO_ATTR    langchain.agents.create_tool_calling_agent
NO_ATTR    langchain.agents.create_react_agent
OK         langchain.agents.create_agent
NO_MODULE  langchain.chains.LLMChain
NO_MODULE  langchain.chains.RetrievalQA
NO_MODULE  langchain.chains.create_retrieval_chain
NO_MODULE  langchain.memory.ConversationBufferMemory
NO_MODULE  langchain.prompts.PromptTemplate
NO_MODULE  langchain.schema.Document
NO_MODULE  langchain.text_splitter.RecursiveCharacterTextSplitter
OK         langchain.chat_models.init_chat_model
NO_ATTR    langchain.chat_models.ChatOpenAI
NO_MODULE  langchain.llms.OpenAI
NO_MODULE  langchain.vectorstores.FAISS
NO_MODULE  langchain.document_loaders.TextLoader
OK         langchain.tools.tool
OK         langchain_core.prompts.ChatPromptTemplate
OK         langchain_core.documents.Document
OK         langchain_text_splitters.RecursiveCharacterTextSplitter
OK         langchain_classic.agents.AgentExecutor
OK         langchain_classic.chains.LLMChain
OK         langchain_classic.memory.ConversationBufferMemory
OK         langgraph.prebuilt.create_react_agent
-- migration targets --
OK         langchain_classic.agents.initialize_agent
OK         langchain_classic.agents.create_react_agent
OK         langchain_classic.agents.create_tool_calling_agent
OK         langchain_classic.chains.RetrievalQA
OK         langchain_classic.chains.create_retrieval_chain
OK         langchain_core.prompts.PromptTemplate
OK         langchain_core.messages.HumanMessage
OK         langchain_openai.ChatOpenAI
OK         langchain_openai.OpenAI
OK         langchain_community.vectorstores.FAISS
OK         langchain_community.document_loaders.TextLoader