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

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

コールバックと人の承認

コールバックで実行を見守り、危険なツールの前で一時停止して、人が承認または拒否できるようにします。

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

目標

  • コールバックハンドラーを取り付け、そのイベントを見ます。未完了
  • 返金ツールの前で一時停止し、承認します。未完了
  • 返金を拒否し、エージェントがそれをどう扱うかを見ます。未完了
  • 確認問題に合格します。未完了

ステップ1/4: 本文

コールバックは見守る

コールバックハンドラーは、実行が進むにつれてLangChainがそのメソッドを呼び出すオブジェクトです。BaseCallbackHandlerのサブクラスで、handleChatModelStart、handleLLMEnd、handleToolStart、handleToolEndのようなメソッドを持ちます。config.callbacksに渡すと、そのconfigを受け取る入れ子の呼び出しすべてに届きます。ログ、メトリクス、トレースに使います。コールバックは観察するだけです。LangChainはそのメソッドが返す値を無視し、中で投げられたエラーも既定ではログに記録するだけなので、ステップを変えたり止めたりはできません。

ブレークポイントは一時停止する

ステップの前で実行を止めるには、LangGraphが状態を保存し、あとでそこに戻る必要があります。それがチェックポインターです。compile({ checkpointer: new MemorySaver() })は、config.configurableのthread_idのもとで、スーパーステップごとにチェックポイントを保存します。interruptBefore: ["approval_tools"]を加えると、実行はそのノードの前で止まります。

一時停止している間、(await graph.getState(config)).nextが何を待っているかを示し、最後のAIMessageに保留中の呼び出しがあります。承認するには、graph.invoke(null, config)で再開します。入力がnullなら「チェックポイントから続ける」という意味です。拒否するには、先にgraph.updateState(config, { messages: [toolMessage] }, "approval_tools")を呼びます。あなたのToolMessageが、ノードが実行されたかのようにその呼び出しに答えるので、ノードは飛ばされ、モデルはあなたの拒否を読みます。

ここでのcreate_refundのように、危険なツールには専用のノードを与えてください。そうすればゲートはそれだけを止めます。

Nodeで、そしてほかの場所で

Nodeでは、langchainパッケージのcreateAgentがミドルウェアのフック(beforeModel、afterModel、wrapModelCall、wrapToolCall)と、interrupt()で一時停止するhumanInTheLoopMiddlewareを提供します。interrupt()にはAsyncLocalStorageが必要なので、ブラウザではここと同じくブレークポイントを使います。コーディングエージェントも同じ考え方を使います。ツール呼び出しの前に動き、それを拒否できるフックです。

ステップ2/4: 試す:返金の前のゲート

返金の前のゲート

操作が1つずつの4つのステップと、任意の5つ目があります。実行のコールバックイベントを見て、返金の前にゲートを置き、1回の実行を承認し、次の実行を拒否します。

モード:本物シミュレーション本物:LangChainのコールバックと、LangGraph.jsのチェックポイント、ブレークポイント、getState、updateState、再開がこのページで動きます。シミュレーション:モデルは拒否への答えも含めて台本どおりで、チケットとツールは架空のものなので、返金は行われません。

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

確認問題

質問1/3interruptBeforeが動くには何が必要ですか?

次:質問2/3

質問2/3実行がapproval_toolsの前で一時停止しています。止まったところから続けるにはどうしますか?
質問3/3コールバックハンドラーのhandleToolStartが、create_refundを見るとfalseを返します。どうなりますか?

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

これでできること

  • コールバックハンドラーで、実行のモデルとツールのイベントを記録する。
  • チェックポインターとinterruptBeforeで、ノードの前でグラフを一時停止する。
  • getState、updateState、invoke(null)で、保留中のステップを再開または拒否する。