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のアプリの料金と安全を考えるうえで、注目したい仕組みです。
ここまでお読みいただきありがとうございました。