本文へスキップ
エージェントシステムと標準に戻る

エージェントシステムと標準 · 第5章(全8章)

オーケストレーション:スーパーバイザー、ファンアウト、サブグラフ

1つのLangGraphのグラフで複数のエージェントを動かすパターン:振り分けるスーパーバイザー、並列作業のためのSend、サブグラフ、各スーパーステップが保存するチェックポイント。

25分4個中0個の目標を達成

目標

  • 2つの専門エージェントが同じスーパーステップで動くのを見ます。未完了
  • 入れ子のサブグラフの実行を開きます。未完了
  • 同じジョブを、1つのエージェントとスーパーバイザーで実行します。未完了
  • ファンアウトの結果を予想します。未完了

ステップ1/4: 本文

スーパーステップ

LangGraphはグラフをスーパーステップ単位で実行します。各スーパーステップでは、実行すべきすべてのノードが並列に動きます。その更新は各キーのreducerで状態にマージされ、エッジが次に動くノードを決めます。メッセージは追加するreducerを使うので、2つのノードが1つのスーパーステップで両方ともメッセージを追加できます。

スレッドとチェックポイント

MemorySaverのようなチェックポインターを付けてグラフをコンパイルし、実行するときにthread_idを渡します。LangGraphはそのスレッドに、状態全体のチェックポイントを、入力のときに1つ、その後は各スーパーステップの終わりに1つ保存します。getState({ configurable: { thread_id } })は最新のものを読みます。値、ステップ番号、そしてnext(次に実行されるノード)です。同じスレッドでの次の実行は、その状態から始まります。

スーパーバイザー、ファンアウト、サブグラフ

スーパーバイザーは、次にどの専門エージェントが作業するかを決めるエージェントです。ここでは引き継ぎはtransfer_to_customer_supportのようなツール呼び出しなので、モデルはほかのツールと同じようにそれを選びます。

ファンアウトは作業を並列に実行します。条件付きエッジは、ノード名の代わりにSendオブジェクトのリストを返せます。各Sendは、それぞれの入力でノードの実行を1つ始め、すべて次のスーパーステップで動きます。返されたものはreducerがマージします。

サブグラフは、ノードの中で使うコンパイル済みのグラフです。独自の状態と独自のチェックポイント名前空間を持ち、その実行は呼び出したノードの下に入れ子になります。このラボでは、Financial Analystが自分のData Engineerサブグラフを呼び出します。Commandによる引き継ぎと、状態を共有するサブグラフは、後の「高度なエージェント」のパスで扱います。

1つのエージェントで足りるとき

エージェントを1つ増やすたびに、モデル呼び出し、チェックポイント、引き継ぎが増え、失敗しうる箇所も1つ増えます。部分が互いに独立しているとき、1つのコンテキストが大きくなりすぎるとき、ある部分に別のツールや指示が必要なときに、作業を分けます。それ以外は1つのエージェントから始めます。

このラボでは、HaldenのサポートチームがチケットT-48213を扱います。注文48213で二重に請求された顧客です。両方の方法で実行し、トレースが測る値を比べてください。

ステップ2/4: 試す:エージェントの星空

エージェントの星空

3つのステップ:ジョブをスーパーバイザーで実行し、各スーパーステップがチェックポイントを保存するのを見ます。実行ツリーでサブグラフを開き、次に同じジョブを1つのエージェントで実行して比べます。

モード:本物シミュレーション本物:このページでLangGraph.jsがグラフ、Sendによるファンアウト、サブグラフ、チェックポイントを実行し、getStateがスレッドを読み戻し、LangChainのトレーサーがすべての実行を記録します。シミュレーション:モデルは台本どおりで、データは架空です。

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

確認問題

コード
new StateGraph(State)
  .addNode("lookup", s => ({ results: [s.id * 10] }))
  .addConditionalEdges(START, () => [new Send("lookup", { id: 1 }), new Send("lookup", { id: 2 })], ["lookup"])
  .addEdge("lookup", END)
  .compile()
  .invoke({});
resultsには、リストを連結するreducerがあります。グラフは何を返しますか。

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

これでできること

  • 引き継ぎのツール呼び出しで専門エージェントへ振り分けるスーパーバイザーを作れます。
  • Sendでファンアウトし、reducerで結果をマージできます。
  • コンパイル済みのグラフをサブグラフとして使い、1つのエージェントで足りるときを説明できます。
  • スレッド上でグラフを実行し、その最後のチェックポイントをgetStateで読めます。