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

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

はじめてのグラフ

ノードとエッジからStateGraphを組み、条件付きエッジで振り分け、ステップごとに実行します。

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

目標

  • START、classify、2つの窓口、ENDをつないで、コンパイルできるグラフにします。未完了
  • グラフを実行して、それぞれの分岐を1回ずつ通します。未完了
  • グラフがどう実行されるかを予想します。未完了

ステップ1/4: 本文

ノードとエッジ

StateGraphは、Annotation.Root({ … })や第3章のMessagesAnnotationのような状態の定義から始まります。addNode(name, fn)はノードを追加します。ノードは状態を読んで更新を返す関数で、その更新は状態のリデューサーがマージします。addEdge(a, b)は、aのあとにbが実行されることを表します。STARTとENDはグラフの入口と出口です。STARTからのエッジが最初のノードを決め、ENDへのエッジが実行を終えます。

分岐

addConditionalEdges(from, router, targets)は、ノードのあとに判断を置きます。ルーターは状態を受け取って次のノードの名前を返す関数で、targetsはルーターが返しうるノードの一覧です。グラフはこうして、返金の依頼をある窓口へ、質問を別の窓口へ振り分けます。ルーターがなければ、1つのノードから出る2本の普通のエッジは両方とも実行されます。

コンパイルしてから実行する

compile()は構造をチェックし、invoke()やstream()で使えるグラフを返します。どのエッジからも届かないノード(UnreachableNodeError)のように何かがおかしければ、例外を投げます。すべてのノードがENDに届く必要はありません。出ていくエッジのないノードでは、実行がそこで終わるだけです。

実行はスーパーステップ単位で進みます。各スーパーステップでは、準備のできたノードがすべて一緒に動きます。次にそれらの更新が状態にマージされ、エッジが次に準備のできるノードを決めます。stream()は各ノードの更新を起きた順に報告します。1つのスーパーステップで2つのノードが同じキーに書き込む場合、そのキーには結果をまとめるリデューサーが必要です。なければLangGraphはエラーを出します。

ステップ2/4: 試す:グラフをつなぐ

グラフをつなぐ

STARTからENDまで5本のエッジを引きます。LangGraphはエッジを1本引くたびにグラフをコンパイルします。次にサンプルのチケットを2つとも実行し、各スーパーステップを見ます。

モード:本物シミュレーション本物:LangGraph.jsがこのページであなたのグラフを組み、チェックし、実行します。コードをPythonに切り替えると、LangGraph for PythonがPyodide(WebAssemblyにコンパイルしたPython)上で同じことをします。シミュレーション:サポート窓口。モデルは使いません。classifyはパターンで返金に関する言葉を探し、各窓口は決まった返事を返します。

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

確認問題

コード
new StateGraph(State)
  .addNode("a", a).addNode("b", b).addNode("c", c)
  .addEdge(START, "a")
  .addEdge("a", "b").addEdge("a", "c")
  .addEdge("b", END).addEdge("c", END)
  .compile();
このグラフはどう実行されますか?

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

これでできること

  • ノード、エッジ、START、ENDでStateGraphを組んでコンパイルする。
  • addConditionalEdgesで振り分ける。
  • スーパーステップと、ノードが並列に動くタイミングを説明する。