LangChain アップグレード マイグレーション

概要

LangChain バージョンを安全にアップグレードし、破壊的変更に対応するマイグレーション戦略のガイドです。

前提条件

• 既存の LangChain アプリケーション
• 現在のコードがコミットされたバージョン管理
• コア機能をカバーするテストスイート
• 検証用のステージング環境

手順

ステップ 1: 現在のバージョンを確認

pip show langchain langchain-core langchain-openai langchain-community

# 現在の要件を出力
pip freeze | grep -i langchain > langchain_current.txt

ステップ 2: 破壊的変更をレビュー

# バージョン別の主な破壊的変更:

# 0.1.x -> 0.2.x (大規模な再構築)
# - langchain-core が独立したパッケージとして抽出
# - インポートが langchain.* から langchain_core.* に変更
# - ChatModels がプロバイダーパッケージに移動

# 0.2.x -> 0.3.x (LCEL 標準化)
# - レガシーチェーンが非推奨
# - AgentExecutor の変更
# - メモリ API の更新

# マイグレーションガイドの確認:
# https://python.langchain.com/docs/versions/migrating_chains/

ステップ 3: インポートパスを更新

# 旧（0.2 以前）:
from langchain.chat_models import ChatOpenAI
from langchain.prompts import ChatPromptTemplate
from langchain.chains import LLMChain

# 新（0.3 以降）:
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser

# マイグレーション スクリプト
import re

def migrate_imports(content: str) -> str:
    """旧来のインポートを新しいパターンにマイグレートします。"""
    migrations = [
        (r"from langchain\.chat_models import ChatOpenAI",
         "from langchain_openai import ChatOpenAI"),
        (r"from langchain\.llms import OpenAI",
         "from langchain_openai import OpenAI"),
        (r"from langchain\.prompts import",
         "from langchain_core.prompts import"),
        (r"from langchain\.schema import",
         "from langchain_core.messages import"),
        (r"from langchain\.callbacks import",
         "from langchain_core.callbacks import"),
    ]
    for old, new in migrations:
        content = re.sub(old, new, content)
    return content

ステップ 4: レガシーチェーンを LCEL にマイグレート

# 旧: LLMChain（非推奨）
from langchain.chains import LLMChain

chain = LLMChain(llm=llm, prompt=prompt)
result = chain.run(input="hello")

# 新: LCEL（LangChain Expression Language）
from langchain_core.output_parsers import StrOutputParser

chain = prompt | llm | StrOutputParser()
result = chain.invoke({"input": "hello"})

ステップ 5: エージェントをマイグレート

# 旧: initialize_agent（非推奨）
from langchain.agents import initialize_agent, AgentType

agent = initialize_agent(
    tools=tools,
    llm=llm,
    agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION
)

# 新: create_tool_calling_agent
from langchain.agents import create_tool_calling_agent, AgentExecutor
from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder

prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a helpful assistant."),
    ("human", "{input}"),
    MessagesPlaceholder(variable_name="agent_scratchpad"),
])

agent = create_tool_calling_agent(llm, tools, prompt)
agent_executor = AgentExecutor(agent=agent, tools=tools)

ステップ 6: メモリをマイグレート

# 旧: ConversationBufferMemory
from langchain.memory import ConversationBufferMemory

memory = ConversationBufferMemory()
chain = LLMChain(llm=llm, prompt=prompt, memory=memory)

# 新: RunnableWithMessageHistory
from langchain_core.chat_history import BaseChatMessageHistory
from langchain_core.runnables.history import RunnableWithMessageHistory
from langchain_community.chat_message_histories import ChatMessageHistory

store = {}

def get_session_history(session_id: str) -> BaseChatMessageHistory:
    if session_id not in store:
        store[session_id] = ChatMessageHistory()
    return store[session_id]

chain_with_history = RunnableWithMessageHistory(
    chain,
    get_session_history,
    input_messages_key="input",
    history_messages_key="history"
)

ステップ 7: パッケージをアップグレード

# 現在の環境をバックアップ
pip freeze > requirements_backup.txt

# 最新の安定版にアップグレード
pip install --upgrade langchain langchain-core langchain-openai langchain-community

# または特定のバージョンを指定
pip install langchain==0.3.0 langchain-core==0.3.0

# バージョンを確認
pip show langchain langchain-core

ステップ 8: テストを実行

# テストスイートを実行
pytest tests/ -v

# 非推奨警告をチェック
pytest tests/ -W error::DeprecationWarning

# 型チェックを実行
mypy src/

マイグレーション チェックリスト

• 現在のバージョンを文書化
• 破壊的変更をレビュー
• インポートを更新
• LLMChain -> LCEL へマイグレート
• エージェント初期化を更新
• メモリパターンを更新
• テストがパスする
• ステージング検証が完了

エラーハンドリング

エラー	原因	解決方法
ImportError	旧来のインポートパス	新しいパッケージインポートに更新
AttributeError	削除されたメソッド	マイグレーションガイドで代替手段を確認
DeprecationWarning	旧来の API を使用	新しいパターンにマイグレート
TypeError	変更されたシグネチャ	関数の引数を更新

リソース

• LangChain マイグレーションガイド
• LCEL ドキュメント
• リリースノート
• 非推奨タイムライン

次のステップ

アップグレード後、langchain-common-errors を使用して問題のトラブルシューティングを行います。