AIエージェントにおけるヒューマン・イン・ザ・ループとは、エージェントが決められた地点で停止し、人の対応を待つ仕組みを指します。停止には2種類あります。人がやるしかないステップ(ログイン、2FAコード、支払い)と、人が判断すべきステップ(マージ、公開、送信)です。優れたハンドオフは、どのステップなのかを明示し、エージェントが推測で進まずに待機し、実際の人の操作があったときだけ再開します。
ヒューマン・イン・ザ・ループのAIエージェントは、説明するのは簡単ですが、うまく作り込むのは困難です。多くのチームはまず1つのルール(「マージ前に人がレビューする」)から始め、後になって穴に気づきます。午前2時に2FAのプロンプトで止まってしまうエージェントや、停止するよう誰も指示していないために支払いページをそのままクリックしてしまうエージェントです。
コーディングエージェント向けのブラウザツールであるOpenCodeのBrowseには、1つ目の種類の停止を正しく実装した小さなハンドオフ設計が組み込まれています。本記事では、それが何をするのか、どこで限界を迎えるのか、そして同じパターンを2つ目の種類の停止が存在する共有タスクボード(Sharkly)へどう持ち込むのかを解説します。
AIエージェントにおけるヒューマン・イン・ザ・ループの意味
AIエージェントにおけるヒューマン・イン・ザ・ループ(HITL)とは、エージェントが名前を付けたチェックポイントで一時停止し、制御や判断を人に委ね、その人が行動して初めて処理を続ける設計です。チェックポイントは例外ではなく、ワークフローの一部です。エージェントはその存在を認識し、人は自分が担当することを理解し、システムは誰が行動したかを記録します。
セキュリティの専門家コミュニティはこれを礼儀ではなく制御として扱っています。OWASPの過剰な権限に関する項目では、「影響の大きいアクションを実行する前に人の承認を必須とする」ヒューマン・イン・ザ・ループ制御を推奨しています。
2種類の人的チェックポイント
すべての一時停止がレビューというわけではありません。この2種類を混同すると、HITLの仕組みは遅く感じられるのに、肝心なところは見逃してしまいます。
| 人がやるしかないステップ | 判断ステップ | |
|---|---|---|
| 例 | ログイン、2FAプロンプト、キャプチャ、支払い、同意画面 | PRのマージ、記事の公開、メールの送信、チケットのクローズ |
| 人が必要な理由 | エージェントが認証情報を持っていない、または持つべきではない | エージェントは実行できるが、結果について人の判断が必要 |
| 発生タイミング | 実行の途中、しばしば予測できない形で | 実行の最後、または不可逆なアクションの直前 |
| 所要時間 | 数秒 | 数分から1日 |
| 処理を再開させるもの | 人がステップを完了し、続行を指示する | 人が承認、却下、または修正を依頼する |

1つ目の種類にはスピードと正確なシグナルが求められます。2つ目の種類には文脈と記録が必要です。
Browseのハンドオフが優れている点
Browseは「MCPサーバーとChromium拡張機能」で、コーディングエージェントがあなたの実際のブラウザを、あなたのタブやログイン情報とともに利用できるようにします。そのソースリポジトリはMITライセンスで提供されています。エージェントがログイン、2FAプロンプト、支払いに遭遇すると、タブをあなたに返し、あなたが「Continue」をクリックすると処理を再開します。
このハンドオフには、取り入れる価値のある6つの設計上の選択があります。
- ステップは1つのタブと1つのサイトに限定される。 ページ上のハンドオフカードにそのサイトのオリジンが表示されるため、どこで操作しているのかが正確に分かります。
- エージェントは推測せずに尋ねる。 ナビゲーション後、Browseはキャプチャの壁や「アクセス拒否」ページを報告し、インタラクティブなものはあなたに委ねるようエージェントに指示します。READMEによれば、「それらを解くことは決してありません」。
- 実際の人の操作だけが実行を再開させる。 「カードまたはツールバーのボタンへの実際のクリックだけがハンドオフを完了するため、ページが偽装することはできません」。悪意あるページがあなたの代わりに「Continue」をクリックすることはできません。
- 状態が一目で分かる。 ツールバーのバッジは、エージェントが作業中はRUN、あなたの対応が必要なときはWAITと表示されます。
- 人はいつでも制御を取り戻せる。 エージェントの実行中にツールバーのボタンをクリックすると、タブを取り戻せます。
- 限界を正直に明示している。 READMEは
allowedOriginsとreadOnlyを「ガードレールであり、データ境界ではない」と述べ、何をフィルタリングしないのかを率直に説明しています。
最も重要なのは3番目です。ページが完了できてしまうハンドオフは、人的チェックポイントではなく、プロンプトインジェクションの標的にすぎません。独自のHITLステップを構築するなら、再開のシグナルは、エージェントやエージェントが読むコンテンツが到達できないチャネルから発信される必要があります。プロンプトインジェクションとエージェントのガードレールの記事では、その境界がモデル側のどんな修正よりもなぜ有効なのかを解説しています。
ブラウザ内ハンドオフの限界
Browseのハンドオフは、1人の人が1つのデスクで行う「人がやるしかないステップ」を解決します。しかし、完了した作業をリリースすべきかどうかは判断しませんし、あなたが不在の間にエージェントがブロックされていることをチームメンバーに伝えることもありません。これは欠陥ではなく境界です。判断ステップにはブラウザの外にある共有の記録が必要です。
ハンドオフをタスクボードにマッピングする
タスクボードは、人が画面の前にいないときでもハンドオフのパターンが機能し続ける場所を提供します。Sharklyでは、タスクが人とエージェントの共有記録であり、すべてのタスクの会話には状態が付きます。Working、Queued、Needs your reply、Needs your review、Exception、Completed、Abortedのいずれかです。エージェントとのチャットのドキュメントによれば、ハンドオフは待機相手である本人にだけ「Needs your…」と表示され、それ以外の人には中立的な「Needs reply」または「Needs review」と表示されます。
Sharklyの2つの状態は、2種類のチェックポイントに対応しています。
- Needs your replyは実行途中のハンドオフです。エージェントは人にしかない入力(判断、認証情報、不足しているファイル)でブロックされています。
- Needs your reviewは判断ステップです。作業は完了しており、承認を待っています。
どちらもサイドバーのTask Chatsモジュールに表示され、会話のオーナーにはデスクトップのバナーとSlack通知も届きます。これがBrowseのWAITバッジのチーム規模版です。
タスクのワークフロー上のステータスは別のレイヤーです。エージェントのタスク実行のドキュメントによれば、タスクタイプのワークフローがエージェントの選択できるステータスを制限し、queuedやrunningといった実行状態がタスクのステータスを意味するわけではありません。

これにより、3つ目のチェックポイントが無料で手に入ります。エージェントは移動できるが外には移動できない「Ready for Release」のようなステータスを追加すれば、最後のステップは設計上、人が担うことになります。
接続されたComputer上で動作するエージェントは、sharkly CLIからハンドオフ状態を自分で設定できます。
# Blocked on something only a person can do: ask, and wait
sharkly task edit COIN-142 --session-status waiting_human_reply
# Work finished: hand it back for acceptance, never mark it done
sharkly task edit COIN-142 --session-status waiting_human_review
エージェントが人のいない状態では続行できないときは、実行途中のreply状態を使います。エージェントは続行できるが、結果に人の判断が必要なときはreview状態を使います。
独自の人的チェックポイントを設計する方法
複数のコーディングエージェントを運用するほとんどのチームは、次の5つのステップで対応できます。
- 「人がやるしかないステップ」をすべて洗い出す。 ログイン、2FA、支払い、本番環境の認証情報、法的同意などです。エージェントはこれらを人に委ねるべきで、決して保持してはなりません。
- 不可逆なアクションをすべて洗い出す。 マージ、デプロイ、公開、送信、削除などです。それぞれの前に、名前の明示された担当者が所有する判断チェックポイントを設けます。
- チェックポイントごとに再開シグナルを1つ選ぶ。 ボタンのクリック、ステータスの変更、タスク会話への返信などです。それはエージェントが読むコンテンツではなく、人から発信される必要があります。
- 待機状態を可視化する。 個人にはWAITバッジ、チームには「Needs your reply」の行を表示します。誰にも見えないブロック中のエージェントは、静かな障害です。
- 境界をエージェントの指示に書き込む。 「ログインページでは停止して尋ねる」は誰かの記憶ではなく、エージェントの指示に含めるべきです。
コーディングエージェントの承認ゲートのガイドではステップ2をより深く掘り下げ、Human review is the bottleneckではレビューが溜まったときに何が起こるかを解説しています。
ヒューマン・イン・ザ・ループのエージェントでよくある失敗
- すべてをレビューする。 すべてのアクションに承認が必要だと、人は読まずに承認するようになります。チェックポイントは不可逆なステップや認証情報が必要なステップに限定しましょう。
- エージェントにゲートを突破させる。 キャプチャを入力したり2FAプロンプトを再試行したりするエージェントは、チェックポイントを障害物競走に変えてしまいます。
- コンテンツ内に再開シグナルを置く。 Webページ、メール、ファイルが「承認済み」と言えるなら、プロンプトインジェクションも同じことができます。
- 担当者がいない。 「誰かがレビューするでしょう」は、誰もしないという意味です。各チェックポイントには名前の明示された担当者が必要です。
まとめ
ヒューマン・イン・ザ・ループが機能するのは、ループに明確に異なる2つの扉があるときです。1つは人がやるしかないステップのための扉、もう1つは人が下すべき判断のための扉です。Browseのハンドオフは1つ目の扉をうまく実装しています。スコープが限定され、可視化され、実際のクリックによってのみ再開できます。共有ボードは2つ目の扉を担い、両方をチームに見える形にします。
エージェントがすでにブラウザやリポジトリをまたいで作業しているなら、ハンドオフをチームが見える場所に置きましょう。Sharklyを始めて、1つのタスクをエージェントに割り当て、さらにゲートを追加する前に、どれくらいの頻度でNeeds your replyに到達するかを観察してください。同じ問題のエージェント間の側面については、AIエージェントのハンドオフをお読みください。
よくある質問
AIエージェントにおけるヒューマン・イン・ザ・ループとは何ですか?
エージェントが決められた地点で一時停止し、続行する前に人の行動や判断を待つワークフローです。その地点はあらかじめ設計され、名前の明示された担当者が所有し、人のシグナルによってのみ再開されます。
AIエージェントはいつ人に制御を返すべきですか?
エージェントが保持すべきでない認証情報が必要なステップ(ログイン、2FA、支払い)と、不可逆なアクション(マージ、デプロイ、公開、送信)の前です。それ以外は通常、停止なしで実行できます。
AIエージェントはキャプチャや2FAプロンプトを自力で解決できますか?
解決すべきではありません。たとえばBrowseはキャプチャの壁を報告し、インタラクティブなものはユーザーに委ねるようエージェントに指示し、READMEでは決して解かないと明言しています。これらは「人がやるしかないステップ」として扱いましょう。
ハンドオフと承認ゲートの違いは何ですか?
ハンドオフは実行途中のもので、人が何かをするまでエージェントは続行できません。承認ゲートは結果の手前に位置し、エージェントは続行できるものの、続行すべきかどうかを人が判断します。
Webページが人の承認を偽装するのを防ぐにはどうすればよいですか?
再開シグナルをコンテンツの届かない範囲に置きます。Browseはカードまたはツールバーのボタンへの実際のクリックのみを受け付けます。ボード上では、人のアカウントからのステータス変更や返信を使います。



