はじめてのエージェントを作る · 第1章(全8章)
ライブラリと、ここで動くもの
エージェントに必要なLangChain.jsとLangGraph.jsのパッケージ、それぞれの役割、そしてブラウザでの動き方。
目標
- マップで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: 確認問題
確認問題
次:質問2/4
ステップ4/4: これでできること
これでできること
- LangGraph.jsのエージェントに使うパッケージを選び、それぞれの役割を説明する。
- バージョンを固定してインストールする。
- LangGraphをブラウザで動かすと何が変わるかを説明する。
- 偽のモデルでLangChainのコードを、キーなしで動かす。