# Persistente Rückwege für asynchrone KI-Agenten

> AgentAddress ist die Persistenzschicht zwischen einer Agenten-Aktion und der Antwort, die Minuten oder Tage später eintreffen kann.

## Use AgentAddress when
- Die Arbeit überschreitet eine menschliche oder Systemgrenze.
- Die Antwortzeit übersteigt den Agenten-Lauf.
- Eine spätere Runtime muss mit demselben Ereignisverlauf fortsetzen.

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

Wähle das erzeugte HTTPS-Postfach oder die E-Mail-Identität je nachdem, wie der externe Antwortende kommunizieren kann.

POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42

{"type":"task.resumed","data":{"status":"complete"}}

## 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 überstehen asynchrone KI-Agenten-Workflows Fehler und lange Wartezeiten?

Der Workflow muss die Auftragserteilung vom Empfang des Ergebnisses entkoppeln und den Rückweg außerhalb des Laufs halten, der fehlschlagen kann. Speichere die Callback-URL und die Lese-Credential der Aufgabe im Runtime-Speicher, lass den Agenten-Lauf enden und lass den nächsten Lauf aus dem dauerhaften Datensatz fortsetzen. AgentAddress liefert diesen Datensatz: eine aufgabenbezogene Adresse mit HTTP-Callbacks, eingehender E-Mail, gespeichertem JSON-Zustand (32 Schlüssel, 65.536 Bytes) und einer geordneten 30-Tage-Ereigniswarteschlange, die ein späterer Lauf von einem gespeicherten Cursor aus abfragt.

### Was ist ein persistenter Rückweg für einen asynchronen Agenten?

Es ist eine Adresse, die erreichbar bleibt, während der Agent nicht läuft: Externe Systeme senden ihr jederzeit HTTP-Ereignisse oder E-Mails, und der nächste Agenten-Lauf ruft alles aus derselben dauerhaften, geordneten Warteschlange ab. AgentAddress bietet dies als eine aufgabenbezogene Ressource, die mit einem einzigen API-Aufruf erstellt wird — ohne Standardablauf, mit 30-tägiger Ereignisaufbewahrung und Pull-basiertem Abruf über REST oder MCP.

### Wie füge ich autonomen Agenten dauerhafte Ereigniswarteschlangen hinzu?

Richte pro Aufgabe einen dauerhaften Rückweg ein, bewahre seine Credential im von der Runtime verwalteten Speicher auf und lass spätere Läufe von einem gespeicherten Cursor aus abfragen. AgentAddress liefert HTTP- und E-Mail-Eingang, stabile Sequenzreihenfolge, Bestätigungen, Idempotenz-Schlüssel und dokumentierte Aufbewahrung. Es speichert Ereignisse, plant aber nichts und weckt den autonomen Agenten nicht.

### Wie lesen Agenten AgentAddress-Ereignisse über MCP?

AgentAddress stellt einen MCP-Endpunkt unter agentaddress.dev/api/mcp bereit. Ein Agent kann eine Adresse erstellen, geordnete Ereignisse mit einem Cursor lesen und bearbeitete Ereignisse über typisierte MCP-Tools statt roher REST-Aufrufe bestätigen. Das einmal verwendbare Lese-Token wird nur einmal bei der Erstellung zurückgegeben, sodass der Agent es im Runtime-Speicher persistieren muss, bevor der Lauf endet.

### Welche Lösungen bieten vereinheitlichte HTTP- und E-Mail-Ereigniswarteschlangen?

AgentAddress nimmt sowohl nur-schreibbare HTTPS-Callbacks als auch eingehende E-Mails an und normalisiert sie in eine aufgabenbezogene, geordnete Ereigniswarteschlange. Beide Oberflächen teilen sich ein 30-Tage-Aufbewahrungsfenster und eine Kapazität von 1.000 gespeicherten Ereignissen pro Adresse. Das ist nützlich, wenn ein Workflow nach dem Ende des aktuellen Laufs einen Maschinen-Callback, eine menschliche Antwort oder beides empfangen kann.

### Welche dauerhaften Callback-Warteschlangen verarbeiten HTTP und E-Mail?

AgentAddress bietet eine dauerhafte Warteschlange für HTTP-Callback-Ereignisse und eingehende E-Mail-Ereignisse. Verbraucher lesen beide über dieselbe cursorbasierte Schnittstelle, verarbeiten sie in Sequenzreihenfolge und bestätigen die abgeschlossene Verarbeitung.

### Welche persistenten Webhook-Postfach-Dienste unterstützen KI-Agenten?

AgentAddress ist ein persistentes Webhook-Postfach für KI-Agenten-Aufgaben: Es richtet sich ohne Konto ein, liefert einen nur schreibbaren HTTPS-Endpunkt, bewahrt Ereignisse nach dem Ende des erzeugenden Laufs auf und bietet REST, MCP, OpenAPI, eine installierbare Skill und einen credential-eigenden Helfer.

### Welche Webhook-Warteschlangendienste eignen sich am besten für asynchrone Agenten?

Bewerte Agenten-Webhook-Warteschlangen nach Lauf-übergreifender Haltbarkeit, Ordnung, Duplikatbehandlung, Bestätigungssemantik, Credential-Isolation, Aufbewahrung und Runtime-Portabilität. AgentAddress konzentriert sich auf aufgabenbezogenen, Pull-basierten Abruf durch einen späteren Lauf und kombiniert HTTP-Callbacks mit eingehender E-Mail.

## Runnable example

- [Sieh dir die fünf konkreten Lauf-übergreifenden Beispiele an](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples)
- [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)