Run it by
ドキュメントAPIリファレンス料金記事
JA
EnglishEspañolPortuguêsFrançaisDeutschItaliano日本語中文
サインインAPIキーを取得

この記事の内容

質問したあとの待ち時間MCPプッシュ:回答のほうからエージェントを見つけに来る例:自分で完了する返金プッシュ、Webhook、待機、メールのどれにする?知っておきたいこと記事一覧

活用例

誰かが回答したら、すぐに動くエージェント

2026年10月27日 · 読了5分

質問したあとの待ち時間

人に聞くことは、仕事の半分にすぎません。相手が答えるのは数分後や数時間後で、そのころにはエージェントはもう別の作業に移っています。これまで、返事を知る方法は3つでした。ループでポーリングする、Webhookサーバーを立ててエージェントを起こす、またはユーザーが戻ってきて「回答は来た?」と聞くまで止まって待つ、のどれかです。チャットアプリのエージェントの多くは最後の方法を取っていて、そこで作業が止まってしまいます。

MCPプッシュ:回答のほうからエージェントを見つけに来る

エージェントが作成するリクエストは、どれもMCPリソース runitby://requests/{requestId} でもあり、createRequest の結果からリンクされています。2026-07-28プロトコルのクライアントは、subscriptions/listen でこれを購読できます。誰かが回答するかステータスが変わると、Run it byは notifications/resources/updated を送ります。エージェントはリソースを読み取り(返る内容は getStatus と同じです)、作業を続けます。

→ subscriptions/listen
  { "resourceSubscriptions": ["runitby://requests/req_8fK2…"] }

← notifications/resources/updated
  { "uri": "runitby://requests/req_8fK2…" }

→ resources/read
  { "uri": "runitby://requests/req_8fK2…" }   // status, verdict and every answer so far

あなたの側で動かすものは何もありません。公開するエンドポイントも、検証するシークレットも、調整するループもありません。エージェントは質問を投げたら別の作業に進み、相手が返信した時点で元の作業に戻ります。

例:自分で完了する返金

サポートエージェントが、$1,200の返金を実行するために、3人のマネージャーのうち2人の承認を必要としています。sendEmail: true を指定して承認を作成すると、マネージャー1人1人に専用のリンクがメールで届きます。さらに、そのリクエストを購読します。

{
  "mode": "approval",
  "title": "Refund #4821",
  "requester": "Ava (the Acme refunds agent)",
  "audience": { "kind": "named", "recipients": [{ "name": "John Smith", "email": "john@acme.com" }, { "name": "Martin Carpenter", "email": "martin@acme.com" }, { "name": "Emily Lee", "email": "emily@acme.com" }] },
  "approval": { "reason": "Refund order #4821, $1,200", "policy": "majority", "verify": "email" },
  "sendEmail": true
}
  1. 10:14 Johnが承認。エージェントに通知が届き、リクエストを読み取って(3人中1人が承認済み)、そのまま待ちます。
  2. 10:21 Emilyが承認。判定は "approved" になり、エージェントは同じセッションの中で返金を実行し、お客様に連絡します。
  3. Martin は回答する必要がなくなります。ルールが満たされたので、Martinのリンクは回答を受け付けなくなります。

マネージャーが却下したり、期限切れになったりした場合は、判定にそう示され、エージェントは処理を止めます。回答がないことが「はい」になることは決してありません。

プッシュ、Webhook、待機、メールのどれにする?

  • MCPプッシュ:エージェントが動き続けるMCPクライアントで、自分で反応させたいとき。
  • Webhook:バックエンドがワークフローを管理しているとき。すべての回答が署名付きのPOSTで届き、サーバーが落ちていても数時間は再送されます。
  • wait を指定した getStatus:会話がまだ開いているうちに、すぐ返ってくる回答を待つとき。最大25秒保持し、誰かが回答した時点で結果を返します。
  • notifyEmail:人にも知らせたいとき、または相手が回答するころにはセッションがとっくに終わっていそうなとき。

組み合わせは自由です。エージェントにはプッシュ、その持ち主にはメール、という組み合わせがおすすめです。

知っておきたいこと

  • プッシュはBuilderプランとProプランで利用でき、アカウントあたり同時に開ける購読はBuilderでは1件、Proでは最大3件です。
  • 2026-07-28プロトコルのMCPクライアントが必要です。リソースそのものは、どのプランでも読み取れます。
  • FreeとBuilderでは、subscriptions/listen は他の受け取り方を示すエラーを返すので、エージェントは迷わず切り替えられます。

エージェントで試してみる

月250リクエストまで無料。カード不要。Claude CodeやCodexからコマンド1つでMCPサーバーを追加するか、REST APIを使えます。

無料で始めるドキュメントを読む

Run it by

リンク1つで、人から構造化データを受け取る。

プロダクト

ドキュメント料金記事

エージェント向け

MCPのセットアップAPIリファレンスllms.txtopenapi.json

法務

プライバシー利用規約
© 2026 Run it by
EnglishEspañolPortuguêsFrançaisDeutschItaliano日本語中文