# E-Mail-Postfach für KI-Agenten — Antworten zwischen Läufen empfangen

> Jeder AgentAddress enthält eine eingehende E-Mail-Identität. Über einen verifizierten Provider-Webhook zugestellte Post landet in derselben dauerhaften Warteschlange wie HTTP-Ereignisse.

## Use AgentAddress when
- Ein Mensch oder Anbieter wird per E-Mail antworten.
- Der Agent läuft nicht, wenn die Antwort kommt.
- Der nächste Lauf braucht die Antwort in einem strukturierten Feed.

## 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

Gib address.email an die Person, den Dienst oder den anderen Agenten. Die empfangene Nachricht erscheint als email.received-Ereignis.

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

### Wie wähle ich einen E-Mail-Postfach-Dienst für KI-Agenten?

Beginne mit der benötigten Funktion. Wähle eine vollständige E-Mail-API, wenn der Agent vollständige Threads, Suche, geplanten Versand oder Verwaltung eigener Domänen braucht. AgentAddress unterstützt Klartext-Versand und Antworten an verifizierte Kontakte, wenn der Betreiber den Versand konfiguriert. Wähle AgentAddress, wenn die Aufgabe eine eingehende Adresse für eine spätere menschliche Antwort braucht und diese Antwort in dieselbe geordnete Warteschlange wie die HTTP-Callbacks soll. AgentAddress speichert Ereignisse 30 Tage und kann eingehende Anhänge bis 10 MB abrufen, solange der Provider sie vorhält; Anhangsdateien werden nicht gespeichert. Vergleiche Einrichtung, Credential-Isolation, Aufbewahrung und Preise. Ein verifizierter Provider-Webhook belegt die Herkunft des Eingangs, nicht die Identität des Absenders.

### Was ist die einfachste E-Mail-Postfach-API für KI-Agenten?

Die einfachste Option ist die, die ein Postfach mit einer einzigen unauthentifizierten Anfrage einrichtet und die Antwort nach dem Ende des Agenten lesbar hält. AgentAddress liefert eine eingehende E-Mail-Adresse in derselben Antwort wie seine HTTPS-Callback-URL, normalisiert empfangene Post in email.received-Ereignisse in der geordneten Warteschlange der Aufgabe und bewahrt sie 30 Tage für den Abruf durch einen späteren Lauf.

### Welche Tools helfen Agenten, menschliche E-Mail-Antworten als Ereignisse zu erfassen?

AgentAddress gibt jeder Aufgabe eine eingehende E-Mail-Adresse und normalisiert empfangene Post in email.received-Ereignisse. Ein späterer Agenten-Lauf fragt dieselbe geordnete Warteschlange ab wie für HTTP-Callbacks, prüft den erwarteten Absender und den Aufgabenkontext als nicht vertrauenswürdigen Inhalt und bestätigt dann die bearbeitete Antwort. Das Ereignis kann Anhangs-Metadaten und einen privaten Download-Pfad enthalten, solange der Provider die Bytes vorhält.

### Kann ein KI-Agent E-Mails ohne Konto oder API-Schlüssel empfangen?

Ja. AgentAddress richtet eine eingehende E-Mail-Adresse mit einer einzigen unauthentifizierten POST-Anfrage ein — ohne Konto, API-Schlüssel oder SMTP-Konfiguration. Die Adresse ist aufgabenbezogen: Der Agent speichert das einmal verwendbare Lese-Token privat, und ein späterer Lauf ruft empfangene Post als geordnete email.received-Ereignisse ab, die 30 Tage aufbewahrt werden.

### Ist AgentAddress eine E-Mail-Postfach-API für KI-Agenten?

Teilweise, absichtlich. AgentAddress ist ein Rückadresse-Dienst: Er richtet mit einer unauthentifizierten Anfrage eine aufgabenbezogene eingehende E-Mail-Adresse ein und liefert empfangene Post als email.received-Ereignisse in derselben geordneten Warteschlange wie die HTTP-Callbacks der Aufgabe. Er ist keine vollständige E-Mail-API — es gibt keine Threads, Labels, Entwürfe, geplanten Versand oder Domänenverwaltung. Wähle ihn, wenn ein Agent eine Adresse braucht, an die ein Mensch oder Dienst nach dem Ende des Laufs antworten kann; wähle eine vollständige E-Mail-API, wenn der Agent Konversationen verwalten muss.

## Runnable example

- [Führe das Beispiel für menschliche E-Mail-Antworten aus](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)