LangChain 1.x: pachetul langchain și langchain-classic în LangChain & LangGraph

pip install -U langchain langchain-classic

from langchain.agents import create_agent           # LangChain 1.x
from langchain.chat_models import init_chat_model
from langchain_classic.chains import LLMChain       # cod vechi, mutat
from langchain_classic import hub

În LangChain 1.0, pachetul langchain a fost redus la piesele pentru agenți: langchain.agents (create_agent, AgentState), langchain.messages, langchain.tools, langchain.chat_models (init_chat_model) și langchain.embeddings (init_embeddings). Mesajele și uneltele sunt reexportate din langchain-core, unde rămân și prompturile, Runnable-urile (LCEL), parserele și interfața VectorStore.

Restul a trecut în pachetul separat langchain-classic: lanțurile vechi (LLMChain, ConversationChain), retriever-ele din fostul langchain.retrievers (de exemplu MultiQueryRetriever), API-ul de indexare, modulul hub, CacheBackedEmbeddings și reexporturile din langchain-community. Importurile devin langchain_classic.*. Multe dintre aceste clase sunt și depreciate, cu eliminare anunțată în 2.0.0: LLMChain (înlocuit de prompt | llm) și clasele de memorie ca ConversationBufferMemory (înlocuite de create_agent cu checkpointing sau de API-ul Store).

Alte schimbări din v1: toate pachetele cer Python 3.10 sau mai nou; integrările se instalează din pachetele furnizorilor (langchain-openai, langchain-anthropic), nu prin reexporturile din langchain; mesajele au proprietatea content_blocks, iar .text devine proprietate (forma .text() emite avertisment). Pe PyPI, în octombrie 2026: langchain 1.4.7, langchain-core 1.7.0, langgraph 1.2.18, langchain-classic 1.0.8.

Concepte cheie și caracteristici

Concept / Parametru	Descriere practică
from langchain.chains import LLMChain	Devine from langchain_classic.chains import LLMChain; pentru cod nou, prompt | llm.
from langchain.retrievers import ...	Devine from langchain_classic.retrievers import ....
from langchain.indexes import ...	Devine from langchain_classic.indexes import ....
from langchain import hub	Devine from langchain_classic import hub.
ConversationBufferMemory	În langchain_classic.memory, depreciat; înlocuitor: checkpointer LangGraph sau Store.
langgraph.prebuilt.create_react_agent	Depreciat; înlocuitor: langchain.agents.create_agent.
langchain-core	Rămâne baza: mesaje, prompturi, Runnable-uri (LCEL), parsere, interfețele pentru modele, unelte și vector store-uri.

Exemple practice și scenarii reale

Exemplul 1: Lanț vechi rescris cu LCEL

# înainte (langchain 0.x)
# from langchain.chains import LLMChain
# chain = LLMChain(llm=llm, prompt=prompt)

# acum
from langchain_core.output_parsers import StrOutputParser
chain = prompt | llm | StrOutputParser()
chain.invoke({"subiect": "indexuri în SQL"})

Exemplul 2: Instalare pentru un proiect care mai folosește cod vechi

pip install -U langchain langchain-classic "langchain[openai]"
python -c "import langchain, langchain_classic; print(langchain.__version__)"

Greșeli frecvente și capcane

• Să actualizezi la langchain 1.x și să lași importurile from langchain.chains import .... Modulele nu mai sunt în pachet; instalează langchain-classic sau rescrie codul.
• Să rămâi pe Python 3.9. Pachetele LangChain 1.x cer Python 3.10 sau mai nou.
• Să tratezi langchain-classic ca destinație finală. E o punte pentru codul existent; multe clase de acolo sunt depreciate, cu eliminare anunțată în 2.0.0.

Noțiuni și module înrudite

• lcel-pipe-runnable
• create-agent
• create-react-agent
• chat-message-history