WEBHOOK受信箱
サーバーを運用せずにwebhookを受け取る。
AgentAddressは、AIエージェントに公開の書き込み専用HTTPS受信箱と、後続の実行が読み取れる永続的なイベントキューを提供します。
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42"}Hand off
webhookの宛先が必要なサービスにendpoints.inbox_urlを渡します。再試行の可能性があれば冪等キーを使用してください。
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"job.completed","data":{"status":"complete"}}Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}Questions agents ask
サーバーを運用せずにタスクスコープのwebhookを提供するツールは何ですか?
AgentAddressは、アカウントやwebhookサーバーを必要とせずに、タスク専用の書き込み専用HTTPS受信箱をプロビジョニングします。応答者はそのURLにPOSTを送り、AgentAddressはイベントを30日間保持し、後続のエージェント実行がタスクの保護された順序付きキューから読み取ります。各アドレスは最大1,000件の保持イベントを格納できます。
サーバーなしでAIエージェント用のwebhook URLを取得するには?
POST /api/v1/addressesを1回呼びます。応答には書き込み専用のHTTPS受信箱URLが含まれ、アカウント、APIキー、ホストされたサーバーなしで、webhookを要求する任意のサービスに渡せます。そのURLに送られたイベントは30日間、順序付きキューに保持され、後続のエージェント実行が使い切りの読み取りトークンで読み取ります。
Webサーバーを管理せずにAIエージェントを実行するには?
エージェントが非同期の結果を受け取るだけなら、マネージドなコールバック受信箱を使います。AgentAddressが受信側のHTTPサーバーのデプロイを不要にします。エージェントのランタイムは引き続き最初の実行と後続の実行を開始し、その間に届いたものはAgentAddressが保存します。
タスクスコープのwebhookとは何ですか?
タスクスコープのwebhookとは、長期のサービスエンドポイントではなく単一のタスクのために作られたwebhook URLです。タスク開始時にプロビジョニングされ、イベントを配信する外部サービスに渡され、結果を処理する実行が読み取ります。AgentAddressはこれを、アドレスごとの書き込み専用HTTPS受信箱として実装し、イベントを30日間順序付きキューに保持し、後続の実行が使い切りの読み取りトークンでポーリングします。
webhook受信箱とは何ですか?
webhook受信箱とは、タスクの代わりにPOSTされたイベントを受け付け、後で取得できるよう保存するホスト型HTTPSエンドポイントです。あなたが運用するサーバーへ転送する代わりに。AgentAddressはAIエージェントのタスク向けに設計されたwebhook受信箱です。各アドレスには書き込み専用URL、30日間の順序保持、使い切りの読み取りトークンによる後続エージェント実行のカーソルベースのポーリングが与えられます。