はじめてのエージェントを作る · 第4章(全8章)
はじめてのグラフ
ノードとエッジからStateGraphを組み、条件付きエッジで振り分け、ステップごとに実行します。
目標
- 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で振り分ける。
- スーパーステップと、ノードが並列に動くタイミングを説明する。