本文へスキップ
はじめてのエージェントを作るに戻る

はじめてのエージェントを作る · 第1章(全8章)

ライブラリと、ここで動くもの

エージェントに必要なLangChain.jsとLangGraph.jsのパッケージ、それぞれの役割、そしてブラウザでの動き方。

15分3個中0個の目標を達成

目標

  • マップで6つのパッケージを開き、それぞれが何を提供するかを読みます。未完了
  • このページでhello-worldを実行し、応答を読みます。未完了
  • 確認問題に合格します。未完了

ステップ1/4: 本文

パッケージ

LangChain.jsとLangGraph.jsは、言語モデルを使って開発するためのオープンソースのJavaScriptライブラリです。別々のパッケージに分かれているので、使うものだけをインストールします。

@langchain/coreには共通の部品が入っています。メッセージ、チャットモデルのインターフェース、ツール、コールバックです。@langchain/langgraphは、エージェントをグラフとして動かすランタイムです。状態、ノード、エッジ、チェックポイント、承認のための一時停止を扱います。@langchain/anthropicや@langchain/openaiのようなプロバイダーのパッケージは、1つのプロバイダーのAPI用のチャットモデルクラスを提供します。同じChatOpenAIクラスは、OpenRouter、Hugging Face、NVIDIAのようなOpenAI互換のサービスとも通信できます。zodはツールの入力を記述して検証します。LangChainはzodスキーマを、モデルが読むJSON Schemaに変換します。langsmithは任意で、実行ごとのトレースを記録します。

なぜグラフのライブラリなのか

エージェントのループは手で書くこともできます。モデルを呼び出し、モデルが求めるツールを実行し、それを繰り返します。第6章では、このループを2つのノードからなるグラフとして組みます。LangGraphは、手書きのループにないものを加えます。ステップごとに保存される状態(これにより実行を人のために一時停止し、あとで再開できます)、並列に動く分岐、そして調べたり図にしたりできる構造です。

langchainパッケージはLangGraphの上に作られていて、ミドルウェア付きの既製のエージェントであるcreateAgentを提供します。この学習パスではまずグラフを手で組みます。そうすれば、あとでそうした補助機能が何をしてくれるのかがわかります。

インストール

自分のプロジェクトでは:npm install @langchain/core @langchain/langgraph @langchain/anthropic zod。この学習パスでは@langchain/core 1.2.18、@langchain/langgraph 1.5.1、zod 4.6.7を使います。実際のプロジェクトではバージョンを正確に固定してください。これらのライブラリは変化が速いからです。

ブラウザで違うこと

この学習パスのすべてはブラウザで動くので、LangGraphを@langchain/langgraph/webからインポートします。メインのエントリーポイントはAsyncLocalStorageで設定を入れ子の呼び出しへ渡しますが、ブラウザにはこれがありません。/webでは、入れ子の呼び出しにconfigを明示的に渡し、interrupt()の代わりにブレークポイント(interruptBefore)で実行を一時停止します。それ以外のAPIは同じです。

モデルは既定で台本どおりに動くので、キーは不要で、どの実行も同じ結果になります。この章ではLangChain自身のFakeListChatModelを使います。これは渡した応答をそのまま返します。第2章からは、自分のキーで本物のモデルを接続できます。

ステップ2/4: 試す:パッケージ

パッケージ

マップで各パッケージを開いて、提供するもの、ここで使うバージョン、インポートの書き方を確認します。それからhello-worldを実行します。

ビジュアルを読み込んでいます…

モード:本物シミュレーション本物:マップのバージョンはここにインストールされているもので、@langchain/coreがこのページでhello-worldを動かします。シミュレーション:モデルはLangChainのFakeListChatModelで、決まった応答を返します。そのためAIは呼び出されず、何もブラウザの外に出ません。

ステップ3/4: 確認問題

確認問題

質問1/4HumanMessage、AIMessage、tool()を定義しているパッケージはどれですか?

次:質問2/4

質問2/4LangGraphのグラフをブラウザで動かします。StateGraphはどこからインポートしますか?
質問3/4LangChainのエージェントで、zodは何をしますか?
質問4/4hello-worldでFakeListChatModelを使うのはなぜですか?

ステップ4/4: これでできること

これでできること

  • LangGraph.jsのエージェントに使うパッケージを選び、それぞれの役割を説明する。
  • バージョンを固定してインストールする。
  • LangGraphをブラウザで動かすと何が変わるかを説明する。
  • 偽のモデルでLangChainのコードを、キーなしで動かす。