受信メール
人が後で返信できる場所を与える。
すべてのAgentAddressには受信メールIDが含まれます。検証済みプロバイダのwebhook経由で配信されたメールは、HTTPイベントと同じ永続キューに入ります。
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
address.emailを人、サービス、または別のエージェントに渡します。受信メッセージはemail.receivedイベントとして現れます。
To: {address.email}
Subject: Reply for async_task_42
Send the reply here after the agent run ends.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
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を選んでください。