Python WebAcademy

Python WebAcademy Blog

LangChain 1.5がリリース。質問に合わせてAIのモデルを選び分けるModelRouterMiddlewareと、危ない道具の実行を止めるAutoModeMiddlewareを初心者向けに解説

|

2026年11月11日、AIのアプリを作るためのPythonのライブラリLangChainの1.5.0が公開され、11月18日には1.5.2も出ました。質問の内容に合わせてAIのモデルを選び分けるModelRouterMiddlewareと、危ない道具の実行を止めるAutoModeMiddlewareが加わり、Python 3.10のサポートが終わっています。APIキーなしで動く練習用のコードで試した結果とともに整理します。

2026年11月11日、AIを使ったアプリを作るためのPythonのライブラリLangChainの1.5.0が公開されました。11月18日には、1.5.1と1.5.2も続けて出ています。

今回の目玉は、質問の内容に合わせて使うAIのモデルを選び分ける仕組みです。また、AIが呼び出そうとした道具が危なそうなら、実行を止める仕組みも加わりました。

AIのモデルは、賢いものほど料金が高くなりがちですよね。今回は、APIキーがなくても動く練習用のコードで、新しい機能を試していきます。

まずはLangChainとはどんなものか

最初に、LangChainを知らない方のために、どんなライブラリなのかを簡単に紹介します。LangChainは、ChatGPTのような大規模言語モデル、つまりLLMを使ったアプリを作るためのライブラリです。

OpenAIやAnthropicなど、さまざまな会社のモデルを、同じような書き方で呼び出せます。AIに道具を使わせながら作業を進めるエージェントも、create_agentという関数で作れます。

エージェントとミドルウェア

エージェントとは、AIが自分で考えて、必要な道具を呼び出しながら答えを出す仕組みです。たとえば、ファイルを読む道具を渡しておけば、AIが必要に応じてファイルを読みに行きます。

ミドルウェアとは、エージェントがモデルや道具を呼び出す前後に、共通の処理を挟む部品のことです。今回の新機能は、どちらもこのミドルウェアとして加わりました。

PythonからAIのAPIを使う基本は、こちらで紹介しています。【関連記事】PythonからOpenAIのAPIを使う方法

1.5で何が変わったのかを整理しよう

続いて、今回の範囲の主な変更を表にまとめます。内容は、LangChainの公式リポジトリにあるGitHubのリリースノートにもとづいています。

版 公開日 主な変更
1.5.0 11月11日 モデルを選び分けるミドルウェアと、auto modeのミドルウェアを追加。Python 3.10のサポートを終了
1.5.1 11月18日 警告の抑え方が、ほかの処理とぶつかることがあった問題を修正
1.5.2 11月18日 人の確認のために作られる道具のメッセージに、出どころの情報を付ける

リリースノートによると、ModelRouterMiddlewareはベータ版、つまり試験的な機能という扱いです。PyPIの記録では、1.5.0から、土台のlangchain-coreは1.8.0以上が必要になりました。

Python 3.10のサポートが終わった

まずは、使う環境に関わる変更から見ていきましょう。リリースノートによると、1.5.0で、サポートの終わったPython 3.10が外され、3.11以上が必要になりました。

実際に、Python 3.10の仮想環境を新しく作り、pip install langchainを実行してみました。入ったのは、3.10に対応している最後の版の1.4.10でした。

エラーにはならずに古い版が入るので、新しいミドルウェアがimportできないときは、まずPythonの版を確かめてみてください。主要なライブラリが3.10を外していく流れは、こちらでまとめました。【関連記事】Python 3.10のサポート終了から2週間、主要ライブラリの対応状況

質問に合わせてモデルを選び分けるModelRouterMiddleware

ここからは、新しいミドルウェアです。ModelRouterMiddlewareは、利用者の最新の質問を見て、どのモデルに答えさせるかを最初に1回だけ決めます。

インストールされた1.5.2の説明文によると、選んだ結果はエージェントの状態に保存され、その回の間はずっと同じモデルが使われます。簡単な質問は安いモデル、難しい質問は賢いモデル、という使い分けができるわけです。

選び分けを決めるのは判定役のモデル

どのモデルを選ぶかは、classifierに渡した判定役のモデルが決めます。判定役は、langchain_core.decisionsにあるBaseDecisionModelを元に作るものです。

ふつうは、分類が得意なAIのサービスを判定役に使います。ここでは練習のために、くわしく、という言葉が入っているかどうかで決める、ごく簡単な判定役を自分で作りました。

APIキーなしで試してみた

実際に、答えが決まっている練習用のモデルFakeListChatModelを2つ用意し、選び分けてみました。

from langchain.agents import create_agent
from langchain.agents.middleware import ModelChoice, ModelRouterMiddleware
from langchain_core.decisions import BaseDecisionModel, ClassifierResponse
from langchain_core.language_models.fake_chat_models import FakeListChatModel


class KeywordDecider(BaseDecisionModel):
    model: str = "keyword"

    @property
    def _provider(self) -> str:
        return "local"

    def _classify(self, state, questions):
        text = state.content  # 最新の利用者のメッセージが渡ってくる
        route = "careful" if "くわしく" in text else "fast"
        return ClassifierResponse.model_validate({
            "model": self.model,
            "answers": {qid: {"type": "choice", "choice": route,
                              "probabilities": {route: 1.0}, "confidence": 1.0}
                        for qid in questions},
        })


fast = FakeListChatModel(responses=["(すばやい型)短く答えます"] * 5)
careful = FakeListChatModel(responses=["(じっくり型)順を追って説明します"] * 5)

router = ModelRouterMiddleware(
    choices={
        "fast": ModelChoice(model=fast, criteria="短い質問"),
        "careful": ModelChoice(model=careful, criteria="くわしい説明が必要な質問"),
    },
    instructions="質問に合う、いちばん安いモデルを選ぶ",
    classifier=KeywordDecider(),
)
agent = create_agent(fast, middleware=[router])

2つの質問を送った結果です。手元のPython 3.11で、1.5.2を新しい仮想環境に入れています。

質問 答えたモデル 状態に残った選択
今日の曜日は? (すばやい型)短く答えます fast
for文をくわしく教えて (じっくり型)順を追って説明します careful

質問の中身によって、答えるモデルが切り替わっていますね。選んだ結果は、result["model_route"].choiceで取り出せました。

ベータ版の警告が出る

ModelRouterMiddlewareを作ると、LangChainBetaWarningという警告が表示されました。ベータ版なので、今後、書き方が予告なく変わる可能性がある、という内容です。

1.4.10で同じimportを書くと、ImportErrorになりました。本番のアプリで使う場合は、版を固定しておくと安心です。

警告の仕組みは、こちらで紹介しています。【関連記事】Pythonのwarningsとは?

危ない道具の実行を止めるAutoModeMiddleware

リリースノートにあるauto modeのミドルウェアは、AutoModeMiddlewareという名前で加わっていました。AIが道具を呼び出そうとしたとき、その呼び出しが危ないかどうかを、判定役に確かめさせる仕組みです。

説明文によると、危ない確率が0.5以上なら、道具は実行されず、エラーのメッセージが返されます。ファイルの削除や、外部へのデータの送信などを想定した仕組みです。

試してみた

実際に、ファイルを読むread_fileと、ファイルを消すdelete_fileの2つの道具を用意しました。判定役は練習のために、道具の名前にdeleteが含まれていれば危ないとみなす、簡単なものにしています。

from langchain.agents.middleware import AutoModeMiddleware

guard = AutoModeMiddleware(
    tools=["delete_file", "read_file"],
    classifier=NameDecider(),
)
agent = create_agent(model, tools=[read_file, delete_file], middleware=[guard])

AIの役をする練習用のモデルに、それぞれの道具を呼ばせた結果です。

呼ばれた道具 判定役が返した危ない確率 結果
read_file 0.1 実行され、ファイルの中身が返った
delete_file 0.9 実行されず、blocked because it was classified as risky というエラーが返った

delete_fileは、実際には実行されないまま、止められたことを伝えるメッセージがAIに返されました。説明文によると、このミドルウェアは止めるだけで、人に確認を求めることはしません。

調べる道具は自分で選ぶ

toolsに名前を書いた道具だけが調べられ、書かなかった道具はそのまま実行されます。どの道具を調べるかは、自分で決めて指定する必要があります。

なお、説明文によると、AutoModeMiddlewareもベータ版の扱いです。判定役の正しさに頼る仕組みなので、本当に大事な操作は、人が確認する仕組みと組み合わせるのがよさそうです。

そのほかの変更

1.5.1と1.5.2の変更も、表にまとめておきます。

版 中身
1.5.1 警告を一時的に抑える処理が、同時に動くほかの処理に影響しないように
1.5.1 どの会社のモデルかを推測する処理と、ModelRequestでの同じ問題を修正
1.5.2 人の確認、いわゆるHITLのために作られる道具のメッセージに、出どころの情報を付ける

HITLとは、Human in the loopの略で、AIの作業の途中に人の確認を挟む考え方のことです。

上げる前にやっておきたいこと

最後に、LangChainを1.5へ上げる前に確かめておきたいことを整理します。

順番 確認すること
1 Python 3.11以上を使っているか
2 langchain-coreが1.8.0以上になっているか
3 ベータ版のミドルウェアを使うなら、版を固定しているか
4 危ない道具を持たせているなら、AutoModeMiddlewareや人の確認を挟めないか

私は10年ほどエンジニアとして開発に関わってきましたが、社内向けのAIのチャットで、簡単な質問にまで一番高いモデルを使ってしまい、月末の請求を見て驚いたことがあります。質問ごとにモデルを選び分ける仕組みが、ライブラリに用意されるのは心強いです。

AIの時代にプログラミングを学ぶ意味については、こちらでも書きました。【関連記事】AI時代にあえてプログラミングを学ぶ

まとめ

2026年11月11日、LangChain 1.5.0が公開され、11月18日には1.5.2まで更新されました。質問に合わせてモデルを選び分けるModelRouterMiddlewareと、危ない道具の実行を止めるAutoModeMiddlewareが加わり、Python 3.10のサポートが終わっています。

どちらもまだベータ版ですが、AIのアプリの料金と安全を考えるうえで、注目したい仕組みです。

ここまでお読みいただきありがとうございました。

参考情報

次のアクション

記事で学んだ内容を実際に動かしてみよう

Python WebAcademyでは、ブラウザ上でコードを書きながら基礎から実践まで体系的に学べます。

Python WebAcademyの学習画面

あわせて読む

関連記事

ブログ一覧へ

Python学習ロードマップ

まずはこの3講座から

記事で気になったテーマを、順番に手を動かしながら学べます。

ロードマップを見る