Mail

AIエージェントに仕事を任せて席を外した。数時間後に戻ると、エージェントが途中で止まっていた。誰かの承認が必要だったのに、誰も気づかなかったのだ。

この問題を解決するのがClaude Managed Agents Webhookだ。エージェントが主要な状態変化を直接アプリに通知する。待つ必要はない。

Anthropicが2026年5月のManaged Agentsアップデートで、Dreaming・Outcomes・マルチエージェントオーケストレーションとともに公開したこの機能は、長時間実行AIエージェントを本番環境で運用する方法を根本的に変える。

1. Claude Managed Agents Webhookとは

Managed Agentsは、AnthropicがエージェントループとサンドボックスをREST APIとして直接運営するAIエージェントだ。自分のプロセス内でエージェントループを回すAgent SDKとは異なり、Anthropicのインフラ上で実行される。

WebhookはこのエージェントがアプリにHTTPコールバックで主要な状態変化を通知するメカニズムだ。

従来のポーリング方式：

アプリ：「エージェント、終わった？」→ 5秒待機 → 再確認 → 5秒待機 → ...

Webhook方式：

エージェント：（作業完了）→ アプリへ即時HTTP通知 → アプリがすぐ反応

ポーリングはAPIコールを無駄にし遅延が生じる。Webhookはイベント発生と同時に通知する。作業時間が長いほど差が際立つ。

2. Webhookイベントの種類6つ

Anthropicがサポートするwebhookイベント：

イベント	発生タイミング
セッション開始	エージェントセッションが始まったとき
エージェント待機（Idle）	ユーザー/運用者の入力が必要で停止したとき
Outcome評価完了	採点モデルが結果を評価したとき
マルチエージェントスレッド終了	マルチエージェント作業が完了したとき
Vault認証情報更新失敗	保存された認証情報の更新が失敗したとき
セッション終了	エージェントセッションが終了したとき

最も重要なのは**「エージェント待機（Idle）」**だ。エージェントが人の確認や追加入力が必要な際に発生する。これを見逃すとエージェントが無期限に停止したままになる。

3. セキュリティ：HMAC署名とリプレイ保護

Webhookは外部からのHTTPリクエストなのでセキュリティが重要だ。Anthropicはデフォルトで複数のセキュリティ機能を提供する。

HMAC署名：すべてのwebhookペイロードにHMAC-SHA256署名が含まれる。アプリはこの署名を検証してAnthropicからの正規リクエストかどうかを確認する。

リプレイ保護：処理済みのwebhookの再処理を防ぐ。ネットワークエラーで同じイベントが2回来ても安全だ。

At-least-once配信：最低1回の配信を保証する。アプリが一時的にダウンして復旧した場合、見逃したイベントを再受信できる。

7言語SDKヘルパー：Python、TypeScript、Go、Java、Ruby、Rust、PHP SDKにwebhook検証ヘルパーが内蔵されている。

from anthropic import Anthropic

client = Anthropic()

def handle_webhook(payload: bytes, signature: str):
    event = client.managed_agents.webhooks.verify(
        payload=payload,
        signature=signature
    )
    if event.type == "agent.idle":
        # エージェントが入力待ち → Slack通知を送信
        notify_slack(event.session_id)

4. 実際の活用シナリオ3つ

シナリオ1：エージェントが止まったらSlack通知

コードレビューエージェントがPRを分析中にセキュリティ上センシティブなファイルの変更を発見し、人の承認を要求した。agent.idleイベントを受け取ってチームのSlackチャンネルに通知を送り、担当者がすばやく対応する。

シナリオ2：Outcome評価失敗時の自動再試行

作業結果がOutcomeルーブリック基準を満たさなかった。outcome.evaluatedイベントでpassed: falseを確認したら、エージェントに自動的に再作業の指示を送る。

シナリオ3：マルチエージェントパイプラインの自動連鎖

データ収集エージェント → 分析エージェント → レポート作成エージェントが順次実行される。各エージェントが終了したときのsession.endedイベントで次のエージェントをトリガーする。人が介入しなくてもパイプライン全体が自動的に流れる。

5. エドテック視点：AIエージェント運用の成熟度

Webhookは技術的な機能だが、私にはAIエージェント運用の「成熟度」の指標に見える。

初期のAIエージェント利用は単純だった：質問して答えをもらう。次のステップはエージェントに作業を任せること。今はエージェントをプロセスに統合する段階だ。

Webhookがなければ、エージェントは孤立したツールだ。Webhookがあれば、エージェントは既存のワークフローに自然に組み込まれる。Slack通知、データベース更新、次のプロセストリガー... これらすべての接続がAIエージェントを本当のチームメンバーにする。

教育プラットフォームで考えると：学生のエッセイ評価エージェント、講義コンテンツ自動更新エージェント、学習パターン分析エージェントがWebhookで既存のLMSと連携すれば、AIは単なる付加機能ではなくシステムの中核となる。

活用ヒント

agent.idleイベントを最初に処理する：エージェントが止まる状況にアラームを設定することが第一歩だ。人の介入が必要な瞬間を見逃してはならない。
HMAC署名検証を必ず実装する：Webhookエンドポイントはインターネットに公開されている。SDKヘルパーを使って署名検証を省かないようにしよう。
At-least-once配信の特性を考慮する：同じイベントが2回来る可能性がある。重複処理防止ロジック（冪等性）を事前に実装しておこう。
小さなパイプラインから始める：まずエージェントA → Webhook → エージェントBの2ステップ構成を作ろう。成功体験を積んでから複雑度を上げるのが安全だ。

まとめ

Webhookは派手な機能ではない。しかし、本番環境でAIエージェントを真剣に運用しようとするなら不可欠な基盤だ。

「エージェントが作業する」→「エージェントが既存システムに統合される」。この転換こそがAIエージェントを実際に有用にする違いだ。

あなたのサービスでAIエージェントWebhookを活用したいシナリオがあれば、コメントでシェアしてください！

出典

Anthropic, "New in Claude Managed Agents: dreaming, outcomes, and multiagent orchestration": https://claude.com/blog/new-in-claude-managed-agents
Anthropic, "Claude Managed Agents overview": https://platform.claude.com/docs/en/managed-agents/overview
Hookdeck, "Anthropic shipped webhooks for Claude Managed Agents": https://hookdeck.com/blog/anthropic-managed-agent-webhooks
Hookdeck, "Guide to Claude Webhooks: Features and Best Practices": https://hookdeck.com/webhooks/platforms/guide-to-claude-webhooks-features-and-best-practices
Anthropic Claude Cookbook, "Managed Agents tutorial: production setup": https://platform.claude.com/cookbook/managed-agents-cma-operate-in-production

Claude Managed Agents Webhook完全ガイド — 長時間実行AIがアプリを呼び起こす方法

目次