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

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

エージェントのループ:最小限のReActエージェント

モデルのノード、ツールのノード、そして条件付きエッジ1本。エージェントのループ全体をLangGraphのグラフで表します。

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

目標

  • エージェントが答えるまで、1スーパーステップずつ進めます。未完了
  • モデルが何回実行されたかを数えます。未完了
  • 実行の流れを順番に並べます。未完了

ステップ1/4: 本文

考える、動く、観察する、繰り返す

ReAct(reason and act)はエージェントのパターンです。モデルは会話を読み、ツールを求めるか、答えるかのどちらかをします。ツールを求めたら、あなたのコードがツールを実行して結果を会話に加え、モデルがもう一度読みます。モデルがツールを求めずに答えたとき、ループは終わります。

グラフとしてのループ

LangGraphでは、このループはMessagesAnnotation(メッセージのリストを持つ状態)の上の2つのノードです。agentノードは、ツールをバインドしたモデルをstate.messagesに対して呼び出し、その応答を返します。toolsノードは@langchain/langgraph/prebuiltのToolNodeです。最後のAIMessageにあるすべてのツール呼び出しを実行し、呼び出しごとにToolMessageを1つ追加します。無効な引数は、第5章と同じくエラーのToolMessageになります。

toolsConditionはagentノードのあとのルーターです。最後のメッセージにtool_callsがあれば"tools"を、なければENDを返します。toolsからagentへ戻るエッジが1本あります。エージェントはこれで全部で、約25行です。

LangGraphはグラフをスーパーステップ単位で実行します。各スーパーステップでは、出番のノードが1回ずつ実行されます。このグラフでは出番のノードが一度に1つだけなので、1スーパーステップが1回のノード実行になり、graph.stream(input, { streamMode: "updates" })はスーパーステップごとに1つの更新を出します。ループが回る様子を見られます。

既製のもの、そして上限

@langchain/langgraph/prebuiltのcreateReactAgentは同じグラフを組みます。これは非推奨になり、langchainパッケージのcreateAgentに置き換えられています。一度手で組んでおけば、そうした補助機能が何をしているかがわかります。

モデルがツールを求め続けると、ループは終わらないことがあります。実行のconfigにあるrecursionLimitがスーパーステップの数に上限を設けます(既定は25)。上限に達すると、LangGraphはGraphRecursionErrorを投げます。下で上限を4にしてみてください。この実行には5スーパーステップが必要です。

ステップ2/4: 試す:ループを1ステップずつ

ループを1ステップずつ

3つのステップに1つずつの操作と、任意の4つ目があります。チケットT-48213を送り、エージェントが答えるまでループを進め、モデルの呼び出しを数え、最後にrecursionLimitでループに上限を設けます。

モード:本物シミュレーション本物:LangGraph.jsのランタイム、ToolNode、toolsCondition、再帰の上限がこのページで動きます。シミュレーション:モデルは台本どおりで(その計画はコード欄のmodel-script.jsです)、ステップ実行では「1スーパーステップ進める」を押したときにだけ答えます。チケットのデータは架空のものです。

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

確認問題

チケットT-48213の実行を順番に並べてください。

項目をドラッグするか矢印ボタンを使って、正しい順番に並べてください。

  1. 1番目: agentノードがタスクをモデルに送る。
  2. 2番目: モデルがツール呼び出しなしで答える。
  3. 3番目: ToolNodeがget_ticketを実行し、ToolMessageを追加する。
  4. 4番目: ToolNodeがlist_chargesを実行し、ToolMessageを追加する。
  5. 5番目: モデルがそれを読み、list_chargesを求める。
  6. 6番目: モデルがget_ticketを求める。
  7. 7番目: toolsConditionがENDへ振り分ける。

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

これでできること

  • ToolNodeとtoolsConditionで、ReActエージェントをグラフとして組む。
  • streamMode "updates"で、実行をメッセージごとに追う。
  • どのエージェントのループにも再帰の上限が必要な理由を説明する。