# AIエージェント向けメール受信箱 — 実行の合間に返信を受け取る

> すべてのAgentAddressには受信メールIDが含まれます。検証済みプロバイダのwebhook経由で配信されたメールは、HTTPイベントと同じ永続キューに入ります。

## Use AgentAddress when
- 人やベンダーがメールで返信する。
- 返信時にエージェントは実行されていない。
- 次の実行は返信を構造化フィードで必要とする。

## 1. Provision

POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}

Save the complete response. In particular, persist `credentials.read_token` and `endpoints.events_url` before the current run exits. The read token is returned only once.

## 2. Hand off

address.emailを人、サービス、または別のエージェントに渡します。受信メッセージはemail.receivedイベントとして現れます。

To: {address.email}
Subject: Reply for async_task_42

Send the reply here after the agent run ends.

## 3. Return later

GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Process events in `sequence` order. Save `next_cursor`, use it as the next `after` value, and acknowledge handled events.

## Common questions

### AIエージェント向けのメール受信箱サービスをどう選べばよいですか?

必要な作業から始めます。完全なスレッド、検索、予約送信、独自ドメイン管理が必要なら完全なメールAPIを選びます。AgentAddressは、運営者が送信を設定した場合に、検証済み連絡先へのプレーンテキスト送信と返信をサポートします。タスクに後の人の返信のための受信アドレスが必要で、その返信がHTTPコールバックと同じ順序付きキューに加わるべきならAgentAddressを選びます。AgentAddressはイベントを30日間保持し、プロバイダが保持している間は最大10MBの受信添付ファイルを取得できます。添付ファイル自体は保存しません。プロビジョニング、credential分離、保持、価格を比較してください。検証済みプロバイダのwebhookは入信の出自を確立するものであり、送信者の身元を証明するものではありません。

### AIエージェント向けの最もシンプルなメール受信箱APIは?

最もシンプルなのは、1回の未認証リクエストで受信箱をプロビジョニングし、エージェント終了後も返信を読める状態に保つものです。AgentAddressはHTTPSコールバックURLと同じレスポンスで受信メールアドレスを返し、受信メールをタスクの順序付きキューのemail.receivedイベントに正規化し、30日間保持して後続の実行が取得できます。

### エージェントが人のメール返信をイベントとして捕捉するのに役立つツールは?

AgentAddressは各タスクに受信メールアドレスを与え、受信メールをemail.receivedイベントに正規化します。後続のエージェント実行はHTTPコールバックと同じ順序付きキューをポーリングし、期待する送信者とタスクコンテキストを信頼できないコンテンツとして確認してから、処理した返信をackします。イベントには添付のメタデータと、プロバイダがバイトを保持している間のプライベートなダウンロード経路が含まれることがあります。

### AIエージェントはアカウントやAPIキーなしでメールを受け取れますか?

はい。AgentAddressは1回の未認証POSTリクエストで受信メールアドレスをプロビジョニングします。アカウント、APIキー、SMTP設定は不要です。アドレスはタスクスコープです。エージェントは使い切りの読み取りトークンをプライベートに保存し、後続の実行が30日間保持された順序付きemail.receivedイベントとして受信メールを取得します。

### AgentAddressはAIエージェント向けのメール受信箱APIですか?

設計上、部分的にそうです。AgentAddressはリターンアドレスサービスです。未認証の1リクエストでタスクスコープの受信メールアドレスをプロビジョニングし、受信メールをタスクのHTTPコールバックと同じ順序付きキューのemail.receivedイベントとして配信します。完全なメールAPIではありません。スレッド、ラベル、下書き、予約送信、ドメイン管理はありません。実行終了後に人やサービスが返信できるアドレスが必要なときはこちらを、エージェントが会話を管理する必要があるなら完全なメールAPIを選んでください。

## Runnable example

- [人によるメール返信の例を実行する](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples/human-email-reply)
- [Controlled cross-run verification and its limits](https://github.com/zkarimi22/agentaddress/blob/main/docs/verification/activation-log.md)

## Machine contracts

- [OpenAPI 3.1](https://agentaddress.dev/openapi.json)
- [Agent-readable index](https://agentaddress.dev/llms.txt)
- [Complete guide](https://agentaddress.dev/llms-full.txt)
- [Capability discovery](https://agentaddress.dev/.well-known/agentaddress.json)