高度なエージェント · 第1章(全10章)
大規模な状態
LangGraph.js 1.5.1が状態の1つのキーへの書き込みをどうマージするか。リデューサーのあるStateSchemaフィールドとないフィールド、並列の書き込みの順番、OverwriteとUntrackedValue。
目標
- リデューサーなしで同じキーに書き込む2つの並列ノードを実行し、エラーを読みます。未完了
- リデューサーを追加し、2つの書き込みが順番にどう組み合わさるかを見ます。未完了
- Overwriteを使って、リデューサーのある値を置き換えます。未完了
- スーパーステップの終わりを予想します。未完了
ステップ1/4: 本文
1つのスーパーステップ、多くの書き込み
エージェントシステムの第5章で見たように、LangGraphはグラフをスーパーステップ単位で実行します。実行待ちのノードはすべて同じスーパーステップで並列に動き、更新を返します。更新とは、そのノードが変える状態のキーを持つオブジェクトです。すべてが終わると、LangGraphは更新を適用し、状態のチェックポイントを保存します。同じスーパーステップのノードはお互いの更新を見ないので、大事なのは同じキーへの2つの書き込みがどう組み合わさるかです。
StateSchemaとリデューサー
LangGraph.js 1.1から、状態をStateSchemaで宣言できます。キーごとに1つのフィールドです。Zodのz.string()のような普通のスキーマで指定したフィールドは、最後に書き込まれた値を保持し、1スーパーステップにつき1回の書き込みを受け付けます。同じスーパーステップでそこに2回書き込むと、値が同じでもInvalidUpdateErrorで失敗し、そのスーパーステップのチェックポイントは保存されません。
ReducedValueフィールドにはリデューサーがあります。リデューサーは、LangGraphが書き込みのたびに呼ぶ関数(current, next) => valueで、たとえばリストに追加するのに使います。以前のAPIであるAnnotation.Rootでは、同じものをAnnotation({ reducer, default })で宣言します。
どの書き込みが先か
リデューサーはスーパーステップの書き込みを1つずつ、タスクパスの順番で受け取ります。ノードが終わった順番ではありません。タスクパスは文字列として比較され、エッジで始まったノードのパスはそのノード名で終わるので、ここではreviewsがspecsより先になります。1.5.0からは、ライブの実行もチェックポインターも、Python版のLangGraphと同じくこの順番を使います。
OverwriteとUntrackedValue
1.2で追加されたnew Overwrite(value)はリデューサーを飛ばし、キーをvalueにします。たとえば長いリストを要約で置き換えるときに使います。同じスーパーステップでそのキーへのほかの書き込みは捨てられ、1つのスーパーステップで1つのキーに2つのOverwriteを書き込むと失敗します。
UntrackedValueフィールドは、グラフが動いている間だけ値を保持します。ノードはそれを読めますが、どのチェックポイントにも保存されないので、チェックポイントから再開した実行はその値なしで始まります。大きなデータや一時的なデータで、もう一度取得できるものに使います。
ラボ
架空のアウトドア用品店Haldenが、冬に向けてあるテントを仕入れるべきかを尋ねます。2つのリサーチノードreviewsとspecsが、同じスーパーステップでそれぞれnotesにメモを1つ追加し、そのあとcondenseがメモを要約します。このグラフを3回実行します。notesにリデューサーなし、追加するリデューサーあり、そしてcondenseがOverwriteを返す場合です。
ステップ2/4: 試す:スーパーステップのタイムライン
スーパーステップのタイムライン
同じグラフを3回実行します。リデューサーなし、リデューサーあり、そしてOverwriteありです。タイムラインには、各スーパーステップが何を書き込み、そのチェックポイントが何を保存したかが表示されます。
ビジュアルを読み込んでいます…
モード:本物シミュレーション本物:このページでLangGraph.js 1.5.1が動き、エラー、マージ、チェックポイントはすべてLangGraph.js自身のものです。シミュレーション:モデルの応答とそれぞれにかかる時間は台本どおりで、Haldenのデータは架空です。
ステップ3/4: 確認問題
確認問題
const State = new StateSchema({
topic: z.string(),
notes: new ReducedValue(z.array(z.string()).default(() => []), {
reducer: (current, next) => current.concat(next),
}),
});
new StateGraph(State)
.addNode("reviews", async () => ({ notes: ["reviews"], topic: "Ridge 2" }))
.addNode("specs", async () => ({ notes: ["specs"], topic: "Ridge 2" }))
.addEdge(START, "reviews")
.addEdge(START, "specs");ステップ4/4: これでできること
これでできること
- StateSchemaで状態を宣言し、キーごとに普通のフィールド、ReducedValue、UntrackedValueのどれかを選ぶ。
- 1つのキーへの並列の書き込みがどう組み合わさり、どの順番になり、いつ失敗するかを予想する。
- Overwriteを使って、リデューサーのある値を置き換える。