はじめてのエージェントを作る · 第7章(全8章)
コールバックと人の承認
コールバックで実行を見守り、危険なツールの前で一時停止して、人が承認または拒否できるようにします。
目標
- コールバックハンドラーを取り付け、そのイベントを見ます。未完了
- 返金ツールの前で一時停止し、承認します。未完了
- 返金を拒否し、エージェントがそれをどう扱うかを見ます。未完了
- 確認問題に合格します。未完了
ステップ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: 確認問題
確認問題
次:質問2/3
ステップ4/4: これでできること
これでできること
- コールバックハンドラーで、実行のモデルとツールのイベントを記録する。
- チェックポインターとinterruptBeforeで、ノードの前でグラフを一時停止する。
- getState、updateState、invoke(null)で、保留中のステップを再開または拒否する。