高度なエージェント · 第2章(全10章)
CommandとSend
ノードはCommandを使えば、状態の更新と次のノードの選択を1ステップで行えます。またSendを使えば、モデルが求める数だけの並列のワーカーに仕事を振り分けられます。
目標
- 状態を更新し、Commandでジャンプするルーターノードを実行します。未完了
- 2つのチケットについて、台本どおりのモデルが選んだ数のチェックにSendで振り分けます。未完了
- 実行を再開します。リデューサーが結果を集め終えていて、1つのノードがそれをまとめます。未完了
- 集めるノードが何を受け取って動くかを予想します。未完了
ステップ1/4: 本文
Command:1回のreturnで更新とルーティング
ノードはふつう状態の更新を返し、次に何を動かすかはグラフのエッジが決めます。代わりに、ノードはnew Command({ update, goto })を返すこともできます。updateは通常のreturnと同じように状態に書き込まれ、gotoは次のノードを指定します。その選択はノードの実行中に行われます。ルーターはチケットを分類し、その分類を保存し、正しいノードへジャンプするところまでを1ステップで行えます。
Commandの行き先はendsで宣言します。addNode("triage", triage, { ends: ["plan", "reply"] })のように書きます。compile()はendsを使って、すべてのノードに到達できるかを確かめます。ここではplanとreplyにはほかの入り口がないので、endsがなければUnreachableNodeErrorを投げます。getGraphAsync()はendsをエッジとして描きます。gotoはノードの静的なエッジに追加されるもので、置き換えはしません。そのため、Commandを返すノードはふつう静的なエッジを持ちません。
Send:モデルが求める数だけのワーカー
new Send("check", { ticket, check })は、グラフの状態ではなく独自の入力で、ノードの実行を1つ始めます。これをタスクと呼びます。Sendのリストを返す条件付きエッジは、仕事を振り分けます。それらのタスクはすべて次のスーパーステップで同時に動きます。リストはモデルから来ることもあるので、幅は実行時に決まります。あるチケットではチェックが3つ、別のチケットでは5つです。CommandのgotoもSendを受け付けます。
結果を集める
タスクはすべて同じキーに書き込むので、前の章と同じく、そのキーにはリデューサーが必要です。スーパーステップの終わりに、リデューサーはそれらの書き込みをタスクの順、つまりSendの順にマージします。タスクが終わった順は関係ありません。ワーカーからのエッジを持つノードは、その次のスーパーステップで1回だけ動き、すべてを読みます。これがグラフの中のmap-reduceです。
引き継ぎと、このラボ
サブグラフの中では、new Command({ graph: Command.PARENT, goto })が親グラフのノードへジャンプします。こうして1つのエージェントが別のエージェントに仕事を渡します。次の章ではこれを使ってチームを作ります。
ラボでは、前の章に出てきた架空のショップHaldenのチケット窓口が、1つのグラフを実行します。triageが各チケットをルーティングし、planが台本どおりのモデルにチェックを選ばせ、summariseが回答を書きます。このページはstream()に渡すinterruptAfterとinterruptBeforeで実行を一時停止します。interrupt()にはAsyncLocalStorageが必要ですが、ブラウザー版のLangGraph.jsにはそれがないためです。
ステップ2/4: 試す:ルーティング、振り分け、集約
ルーティング、振り分け、集約
1つのLangGraph.jsグラフで3つのステップを行います。Commandでチケットをルーティングし、モデルが選んだチェックに振り分け、実行を再開して結果を集めてまとめます。
モード:本物シミュレーション本物:LangGraph.js 1.5.1がこのページで動きます。シミュレーション:モデルの判断と各照会にかかる時間は台本どおりで、チケットとショップの記録は架空のものです。
ステップ3/4: 確認問題
確認問題
// findings: a ReducedValue whose
// reducer concatenates lists.
// plan returns { checks:
// ["order", "shipping", "stock"] }
new StateGraph(State)
.addNode("plan", plan)
.addNode("check", async ({ check }) =>
({ findings: [check] }))
.addNode("summarise", (s) => ({
answer: s.findings.join(" + "),
}))
.addEdge(START, "plan")
.addConditionalEdges("plan", (s) =>
s.checks.map((c) =>
new Send("check", { check: c })),
["check"])
.addEdge("check", "summarise")
.addEdge("summarise", END)
.compile();ステップ4/4: これでできること
これでできること
- ノードからCommandを返し、行き先をendsで宣言して、ルーティングと状態の更新を1ステップで行う。
- モデルが実行時に選ぶ幅で、Sendを使って振り分ける。
- 並列の結果をリデューサーで集め、その順番と次のノードが動くタイミングを予想する。